Git Product home page Git Product logo

nasapower's Introduction

{nasapower}: NASA POWER API Client logo

R-CMD-check codecov DOI Project Status: Active – The project has reached a stable, usable state and is being actively developed. peer-review JOSS CRAN status

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: “The data was obtained from the National Aeronautics and Space Administration (NASA) Langley Research Center (LaRC) Prediction of Worldwide Energy Resource (POWER) Project funded through the NASA Earth Science/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 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.

Quick start

{nasapower} can easily be installed using the following code.

From CRAN

The stable version is available through CRAN.

install.packages("nasapower")

From GitHub for the version in-development

A development version is available through GitHub.

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.

library("nasapower")
daily_ag <- get_power(
  community = "ag",
  lonlat = c(151.81, -27.48),
  pars = c("RH2M", "T2M", "PRECTOTCORR"),
  dates = "1985-01-01",
  temporal_api = "daily"
)
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

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.

Meta

References

https://power.larc.nasa.gov

https://power.larc.nasa.gov/docs/methodology/

nasapower's People

Contributors

adamhsparks avatar

Watchers

 avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.