GithubHelp home page GithubHelp logo

nasa / nasaaccess Goto Github PK

View Code? Open in Web Editor NEW
73.0 9.0 23.0 10.28 MB

NASAaccess is R package that can generate gridded ascii tables of climate (CIMP5) and weather data (GPM, TRMM, GLDAS) needed to drive various hydrological models (e.g., SWAT, VIC, RHESSys, ..etc)

License: Other

R 96.30% TeX 3.70%

nasaaccess's Introduction

NASAaccess

Anaconda-Server Badge Anaconda-Server Badge Anaconda-Server Badge

Ibrahim N. Mohammed

What is NASAaccess?

NASAaccess is a software application in the form of a R package, a conda package, and a Tethys web application. NASAaccess software can generate gridded ascii tables of climate CMIP5, CMIP6, and earth observation remote sensing data (GPM, TRMM, GLDAS) needed to drive various hydrological models (e.g., SWAT, VIC, RHESSys, …etc.). The NASAaccess Tethys web-based application can be used for accessing, reformatting, and visualizing climate and earth observation remote sensing gridded time series data as well.

Where to find the NASAaccess software?

How NASAaccess software is distributed?

NASAaccess is an open-source software package under NASA Open Source Agreement v1.3.

What is needed to install the NASAaccess software on my local machine?

R Library

On a local machine the user should have installed the following programs as well as setting up a user account. The list below gives a summary of what is needed to be done prior to work with NASAaccess software on any local machine:

  • Installing R software

  • Installing Rstudio software (OPTIONAL)

  • NASAaccess R package needs a user registration access with Earthdata. Users should set up a registration account(s) with Earthdata login as well as well as authorizing NASA GES DISC data access. Please refer to https://disc.gsfc.nasa.gov/information/documents Data Access section for further details.

  • curl software . Since Mac users have curl as part of macOS build, Windows users should make sure that their local machines build have curl installed properly.

    • Checking if you can run curl from your command prompt. Type curl --help and you should see the help pages for the curl program once everything is defined correctly.
  • Within Rstudio or R terminal run the following commands to install NASAaccess:

    • library(devtools)

    • install_github("nasa/NASAaccess", build_vignettes = TRUE)

    • library(NASAaccess)

Within the Rstudio help tab the user can verify that the package has been installed and browse the help pages of the various functions of NASAaccess. The GES DISC user registration access logging information will be processed by masking (i.e., not displaying the lieteral typed text as input) on most but not all platforms. Without providing GES DISC user registration access logging information, the user will receive ‘You need to provide your Earthdata GES DISC login to proceed…’ message.

Conda Package

  • NASAaccess conda package needs a user registration access with Earthdata. Users should set up a registration account(s) with Earthdata login as well as well as authorizing NASA GES DISC data access. Please refer to https://disc.gsfc.nasa.gov/information/documents Data Access section for further details.

    • Creating the .netrc file at the user machine Home directory and storing the user NASA GES DISC logging information in it is done automatically to execute the NASAaccess package commands. Accessing data from NASA servers is further explained at Here. The GES DISC user registration access logging information will be processed by masking in the terminal on any major OS. Without providing GES DISC user registration access logging information, the user will receive ‘You need to provide your Earthdata GES DISC login to proceed…’ message.
  • To install NASAaccess package in a conda environment run the following:

conda install -c conda-forge r-nasaaccess

Tethys web-based Application

Full details on installing the web-based application of NASAaccess on single machines and local servers can be found at readthedocs.

Is there a walk through examples for NASAaccess software?

Software users are encouraged to visit (https://imohamme.github.io/NASAaccess/) to learn more on NASAaccess functionality and capabilities.

How to cite R NASAaccess package?

citation(package = 'NASAaccess')
#> To cite package 'NASAaccess' in publications use:
#> 
#>   Mohammed I (2024). _NASAaccess: Downloading and Reformatting Tool for
#>   NASA Earth Observation Data Products_. R package version 4.0.0,
#>   <https://github.com/nasa/NASAaccess>.
#> 
#> A BibTeX entry for LaTeX users is
#> 
#>   @Manual{,
#>     title = {{NASAaccess}: Downloading and Reformatting Tool for NASA Earth Observation Data Products},
#>     author = {Ibrahim Mohammed},
#>     year = {2024},
#>     institution = {National Aeronautics and Space Administration, Goddard Space Flight Center},
#>     address = {Greenbelt, Maryland},
#>     note = {R package version 4.0.0},
#>     url = {https://github.com/nasa/NASAaccess},
#>   }

Reference

Mohammed, I.N., Bustamante, E.G.R., Bolten, J.D., Nelson, E.J., 2023. Technical note: NASAaccess – a tool for access, reformatting, and visualization of remotely sensed earth observation and climate data. Hydrol. Earth Syst. Sci. 27, 3621-3642, https://doi.org/10.5194/hess-27-3621-2023

nasaaccess's People

Contributors

imohamme avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

nasaaccess's Issues

Issue with NASAaccess Package

I am running the following code in R:
dem_path <- system.file("extdata", "DEM_TX.tif", package = "NASAaccess")

shape_path <- system.file("extdata", "basin.shp", package = "NASAaccess")`

NASAaccess::GLDASwat(Dir = "./GLDASwat/", watershed = shape_path, DEM = dem_path, start = "2022-08-1", end = "2022-08-3")

However, I encountered the following error:

Error in R_nc4_open: NetCDF: Unknown file format Error in ncdf4::nc_open(paste("./temp/", filenames[1], sep = "")) : Error in nc_open trying to open file ./temp/GLDAS_NOAH025_3H.A20220801.0000.021.nc4 (return_on_error= FALSE )

I have checked my inputs and attempted various troubleshooting steps, but the issue persists. I would appreciate your guidance on resolving this problem or any suggestions you might have. Your assistance is highly valuable to me.

Thank you for your time and support.

Required packages removed from CRAN

Dear Sir,
I have been trying to install NASAaccess in RStudio, using a M1 MacBook notebook. I recently updated my R Version. Unfortunately, when I attempted the installation as indicated in the instructions, the system indicates that libraries rgdal, rgeos and maptools have been retired from CRAN, as part of a long term strategy to migrate access to GDAL libraries through sf and Terra packages. I will attempt to use NASAaccess through Anaconda, but I would like to know if there are any plans to address these changes in the R version?. Thank you for any comments,
best regards,

Fabio Labra

The GPM IMERG server is temporarily unable to service your request

i'm attempting to run the example code below

NEX_GDDP_CMIP6(Dir = "NEX_GDDP_CMIP6", 
              watershed = shape_path,
              DEM = dem_path,  
              start = "2060-12-1", 
              end = "2060-12-3",
              model = 'ACCESS-CM2', 
              type = 'tas', 
              slice = 'ssp245')

and get the following error.

"Error in NEX_GDDP_CMIP6(Dir = "NEX_GDDP_CMIP6", watershed = shape_path, :
The GPM IMERG server is temporarily unable to service your request due to maintenance downtime or capacity problems. Please try again later."

As far as I can tell the server is up. Any advice?

sessionInfo()

R version 4.3.1 (2023-06-16 ucrt)
Platform: x86_64-w64-mingw32/x64 (64-bit)
Running under: Windows 10 x64 (build 19045)

Matrix products: default

locale:
[1] LC_COLLATE=English_United States.utf8 LC_CTYPE=English_United States.utf8 LC_MONETARY=English_United States.utf8
[4] LC_NUMERIC=C LC_TIME=English_United States.utf8

time zone: EST
tzcode source: internal

attached base packages:
[1] stats graphics grDevices utils datasets methods base

other attached packages:
[1] sf_1.0-13 NASAaccess_3.4.3

loaded via a namespace (and not attached):
[1] dplyr_1.1.2 compiler_4.3.1 tidyselect_1.2.0 Rcpp_1.0.10 stringr_1.5.0 yaml_2.3.7 fastmap_1.1.1
[8] lattice_0.21-8 R6_2.5.1 generics_0.1.3 curl_5.0.1 classInt_0.4-9 knitr_1.43 XML_3.99-0.14
[15] tibble_3.2.1 units_0.8-2 maptools_1.1-7 DBI_1.1.3 pillar_1.9.0 rlang_1.1.1 utf8_1.2.3
[22] rgdal_1.6-7 sp_2.0-0 stringi_1.7.12 terra_1.7-37 xfun_0.39 getPass_0.2-2 cli_3.6.1
[29] magrittr_2.0.3 class_7.3-22 digest_0.6.31 grid_4.3.1 ncdf4_1.21 rstudioapi_0.14 lifecycle_1.0.3
[36] vctrs_0.6.3 KernSmooth_2.23-21 proxy_0.4-27 evaluate_0.21 glue_1.6.2 raster_3.6-20 codetools_0.2-19
[43] rgeos_0.6-3 shapefiles_0.7.2 fansi_1.0.4 e1071_1.7-13 foreign_0.8-84 rmarkdown_2.22 httr_1.4.6
[50] pkgconfig_2.0.3 tools_4.3.1 htmltools_0.5.5

Advise to install the package. Help...

install_github("nasa/NASAaccess", build_vignettes = TRUE)
Downloading GitHub repo nasa/NASAaccess@HEAD
── R CMD build ──────────────────────────────────────────────────────────────────────────────────────────────────────
✔ checking for file ‘/private/var/folders/7w/0t3xsr8d06s9yndqn7gxl_h80000gn/T/Rtmp0aOggl/remotes1380116490986/nasa-NASAaccess-e2707e1/DESCRIPTION’ ...
─ preparing ‘NASAaccess’:
✔ checking DESCRIPTION meta-information ...
─ installing the package to build vignettes
E creating vignettes (11.4s)
--- re-building ‘About.Rmd’ using rmarkdown
--- finished re-building ‘About.Rmd’

--- re-building ‘GLDAS.Rmd’ using rmarkdown
--- finished re-building ‘GLDAS.Rmd’

--- re-building ‘GPM.Rmd’ using rmarkdown

Quitting from lines 30-71 [unnamed-chunk-2] (GPM.Rmd)
Error: processing vignette 'GPM.Rmd' failed with diagnostics:
there is no package called 'ggmap'
--- failed re-building ‘GPM.Rmd’

--- re-building ‘NEXGDDP-CMIP6.Rmd’ using rmarkdown
--- finished re-building ‘NEXGDDP-CMIP6.Rmd’

--- re-building ‘NEXGDDP.Rmd’ using rmarkdown
--- finished re-building ‘NEXGDDP.Rmd’

SUMMARY: processing the following file failed:
‘GPM.Rmd’

Error: Vignette re-building failed.
Execution halted
Error: Failed to install 'NASAaccess' from GitHub:
! System command 'R' failed

Query

Hello sir,
I'm new to git (and R) and am interested to use this great work of yours.
I have already followed the steps for the installation of the package via R Studio (+ the _netrc and the .urs_cookies).

However, it still prompts me with this message. I don't know the reason behind this. My_netrc file is within my designated home directory. But from the looks of it, it's searching for the .netrc file.

Please let me know if what I'm doing is right.
Untitled

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.