Skip to content

Commit

Permalink
Update COC to follow rOpenSci policy
Browse files Browse the repository at this point in the history
  • Loading branch information
adamhsparks committed Feb 12, 2024
1 parent f1271c1 commit ddb9b2b
Show file tree
Hide file tree
Showing 3 changed files with 56 additions and 201 deletions.
129 changes: 0 additions & 129 deletions CODE_OF_CONDUCT.md

This file was deleted.

9 changes: 5 additions & 4 deletions README.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -77,11 +77,12 @@ More documentation is available in the vignette in your R session, `vignette("na

## Meta

- Please [report any issues or bugs](https://github.com/ropensci/nasapower/issues).
Please note that the {nasapower} project is released with a [Contributor Code of Conduct](https://github.com/ropensci/nasapower/blob/main/CODE_OF_CONDUCT.md).
By participating in the {nasapower} project you agree to abide by its terms.
- Please note that this package is released with a [Contributor Code of Conduct](https://ropensci.org/code-of-conduct/).
By contributing to this project, you agree to abide by its terms.

- License: MIT
- Please [report any issues or bugs](https://github.com/ropensci/nasapower/issues).

- License: MIT

## References

Expand Down
119 changes: 51 additions & 68 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,56 +1,40 @@
---
output: github_document
---

# {nasapower}: NASA POWER API Client <img src="man/figures/logo.png" style="float:right;" alt="logo" width="120" />

<!-- badges: start -->

[![tic](https://github.com/ropensci/nasapower/workflows/tic/badge.svg?branch=main)](https://github.com/ropensci/nasapower/actions)
[![codecov](https://codecov.io/gh/ropensci/nasapower/branch/main/graph/badge.svg?token=Kq9aea0TQN)](https://app.codecov.io/gh/ropensci/nasapower)
[![DOI](https://zenodo.org/badge/109224461.svg)](https://zenodo.org/badge/latestdoi/109224461)
[![Project Status: Active – The project has reached a stable, usable
state and is being actively
developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
[![peer-review](https://badges.ropensci.org/155_status.svg)](https://github.com/ropensci/software-review/issues/155)
[![tic](https://github.com/ropensci/nasapower/workflows/tic/badge.svg?branch=main)](https://github.com/ropensci/nasapower/actions)
[![codecov](https://codecov.io/gh/ropensci/nasapower/branch/main/graph/badge.svg?token=Kq9aea0TQN)](https://app.codecov.io/gh/ropensci/nasapower)
[![DOI](https://zenodo.org/badge/109224461.svg)](https://zenodo.org/badge/latestdoi/109224461)
[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
[![peer-review](https://badges.ropensci.org/155_status.svg)](https://github.com/ropensci/software-review/issues/155)
[![DOI](http://joss.theoj.org/papers/10.21105/joss.01035/status.svg)](https://doi.org/10.21105/joss.01035)
[![CRAN
status](https://www.r-pkg.org/badges/version/nasapower)](https://CRAN.R-project.org/package=nasapower)
[![CRAN status](https://www.r-pkg.org/badges/version/nasapower)](https://CRAN.R-project.org/package=nasapower)
<!-- badges: end -->

## POWER data vs {nasapower}

Please note that {nasapower} is **NOT** the source of NASA POWER data.
It is only an API client that allows easy access to the data.
{nasapower} does not redistribute the data or provide it in any way, *we
encourage users to follow the requests of the POWER Project Team and
properly acknowledge them for the data rather than citing this package*
(unless you have actually used it in your work).

> *When POWER data products are used in a publication, we request the
> following acknowledgement be included: “These data were obtained from
> the NASA Langley Research Center POWER Project funded through the NASA
> Earth Science Directorate Applied Science Program.”*
The previous statement that properly cites the POWER data is different
than the citation for {nasapower}. To cite this R package, {nasapower},
please use the output from `citation(package = "nasapower")` and cite
both the package manual, which includes the version you used and the
paper which refers to the peer-review of the software package as the
functionality of the package has changed and will likely change to match
the API in the future as necessary.
{nasapower} does not redistribute the data or provide it in any way, *we encourage users to follow the requests of the POWER Project Team and properly acknowledge them for the data rather than citing this package* (unless you have actually used it in your work).

>*When POWER data products are used in a publication, we request the following acknowledgement be included:
"These data were obtained from the NASA Langley Research Center POWER Project funded through the NASA Earth
Science Directorate Applied Science Program."*

The previous statement that properly cites the POWER data is different than the citation for {nasapower}.
To cite this R package, {nasapower}, please use the output from `citation(package = "nasapower")` and cite both the package manual, which includes the version you used and the paper which refers to the peer-review of the software package as the functionality of the package has changed and will likely change to match the API in the future as necessary.

## About {nasapower}

{nasapower} aims to make it quick and easy to automate *downloading* of
the [NASA-POWER](https://power.larc.nasa.gov) global meteorology,
surface solar energy and climatology data in your R session as a tidy
data frame `tibble` object for analysis and use in modelling or other
purposes. POWER (Prediction Of Worldwide Energy Resource) data are
freely available for download with varying spatial resolutions dependent
on the original data and with several temporal resolutions depending on
the POWER parameter and community.
{nasapower} aims to make it quick and easy to automate *downloading* of the [NASA-POWER](https://power.larc.nasa.gov) global meteorology, surface solar energy and climatology data in your R session as a tidy data frame `tibble` object for analysis and use in modelling or other purposes.
POWER (Prediction Of Worldwide Energy Resource) data are freely available for download with varying spatial resolutions dependent on the original data and with several temporal resolutions depending on the POWER parameter and community.

**Note that the data are not static and may be replaced with improved
data.** Please see <https://power.larc.nasa.gov/docs/services/> for
detailed information in this regard.
**Note that the data are not static and may be replaced with improved data.**
Please see <https://power.larc.nasa.gov/docs/services/> for detailed information in this regard.

### Quick start

Expand All @@ -60,25 +44,26 @@ detailed information in this regard.

The stable version is available through CRAN.

``` r

```r
install.packages("nasapower")
```

#### From GitHub for the version in-development

A development version is available through GitHub.

``` r

```r
install.packages("nasapower", repos = "https://ropensci.r-universe.dev")
```

### Example

Fetch daily “ag” community temperature, relative humidity and
precipitation for January 1, 1985 for Kingsthorpe, Queensland,
Australia.
Fetch daily “ag” community temperature, relative humidity and precipitation for January 1, 1985 for Kingsthorpe, Queensland, Australia.

``` r

```r
library("nasapower")
daily_ag <- get_power(community = "ag",
lonlat = c(151.81, -27.48),
Expand All @@ -89,37 +74,35 @@ daily_ag <- get_power(community = "ag",
daily_ag
```

## NASA/POWER CERES/MERRA2 Native Resolution Daily Data
## Dates (month/day/year): 01/01/1985 through 01/01/1985
## Location: Latitude -27.48 Longitude 151.81
## Elevation from MERRA-2: Average for 0.5 x 0.625 degree lat/lon region = 442.77 meters
## The value for missing source data that cannot be computed or is outside of the sources availability range: NA
## Parameter(s):
##
## Parameters:
## RH2M MERRA-2 Relative Humidity at 2 Meters (%) ;
## T2M MERRA-2 Temperature at 2 Meters (C) ;
## PRECTOTCORR MERRA-2 Precipitation Corrected (mm/day)
##
## # A tibble: 1 × 10
## LON LAT YEAR MM DD DOY YYYYMMDD RH2M T2M PRECTOTCORR
## <dbl> <dbl> <dbl> <int> <int> <int> <date> <dbl> <dbl> <dbl>
## 1 152. -27.5 1985 1 1 1 1985-01-01 54.7 24.9 0.9
```
## NASA/POWER CERES/MERRA2 Native Resolution Daily Data
## Dates (month/day/year): 01/01/1985 through 01/01/1985
## Location: Latitude -27.48 Longitude 151.81
## Elevation from MERRA-2: Average for 0.5 x 0.625 degree lat/lon region = 442.77 meters
## The value for missing source data that cannot be computed or is outside of the sources availability range: NA
## Parameter(s):
##
## Parameters:
## RH2M MERRA-2 Relative Humidity at 2 Meters (%) ;
## T2M MERRA-2 Temperature at 2 Meters (C) ;
## PRECTOTCORR MERRA-2 Precipitation Corrected (mm/day)
##
## # A tibble: 1 × 10
## LON LAT YEAR MM DD DOY YYYYMMDD RH2M T2M PRECTOTCORR
## <dbl> <dbl> <dbl> <int> <int> <int> <date> <dbl> <dbl> <dbl>
## 1 152. -27.5 1985 1 1 1 1985-01-01 54.7 24.9 0.9
```

## Documentation

More documentation is available in the vignette in your R session,
`vignette("nasapower")` or available online,
<https://docs.ropensci.org/nasapower/articles/nasapower.html>.
More documentation is available in the vignette in your R session, `vignette("nasapower")` or available online, <https://docs.ropensci.org/nasapower/articles/nasapower.html>.

## Meta

- Please [report any issues or
bugs](https://github.com/ropensci/nasapower/issues). Please note that
the {nasapower} project is released with a [Contributor Code of
Conduct](https://github.com/ropensci/nasapower/blob/main/CODE_OF_CONDUCT.md).
By participating in the {nasapower} project you agree to abide by its
terms.
- Please note that this package is released with a [Contributor Code of Conduct](https://ropensci.org/code-of-conduct/).
By contributing to this project, you agree to abide by its terms.

- Please [report any issues or bugs](https://github.com/ropensci/nasapower/issues).

- License: MIT

Expand Down

0 comments on commit ddb9b2b

Please sign in to comment.