Data

Tools

Indexes

Applications

Experiments

Open Source Science

loadeR

A climate4R package for data access

https://github.com/SantanderMetGroup/loadeR

Science Score: 39.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ○
    CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ✓
    DOI references
    Found 8 DOI reference(s) in README
  • ○
    Academic publication links
  • ○
    Committers with academic emails
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (14.4%) to scientific vocabulary
Last synced: 6 months ago · JSON representation

Repository

A climate4R package for data access

Basic Info
Statistics
  • Stars: 13
  • Watchers: 14
  • Forks: 15
  • Open Issues: 37
  • Releases: 39
Created over 10 years ago · Last pushed 6 months ago
Metadata Files
Readme Changelog License

README.md

What is loadeR?

loadeR is an R package for climate data access building on the NetCDF-Java API. It allows user-friendly data access either from local or remote locations (e.g. OPeNDAP servers) and it is fully integrated with the User Data Gateway (UDG), a Climate Data Service deployed and maintained by the Santander Meteorology Group. loadeR has been conceived to work in the framework of both seasonal forecasting and climate change studies. Thus, it considers ensemble members as a basic dimension of its two main data structures (grid and station). Find out more about this package at the loadeR wiki.

This package is part of the climate4R framework, formed by loadeR, transformeR, downscaleR, visualizeR and other packages dealing with climate data analysis and visualization.

The recommended installation procedure (for loader and the companion loadeR.java and climate4R.UDG packages) is to use the install_github command from the devtools R package (see the installation info in the wiki):

r devtools::install_github(c("SantanderMetGroup/loadeR.java", "SantanderMetGroup/climate4R.UDG", "SantanderMetGroup/loadeR")) IMPORTANT: On OS X, be sure to execute this in R started from the Terminal, not the R App! (This is because the R app doesn’t honor $PATH changes in ~/.bash_profile)

IMPORTANT: The package requires Java version 1.7 or higher. Several recommendations for known problems with R and Java are given in the wiki installation info).

NOTE: loadeR is enhanced by loadeR.ECOMS package which allows to remotely access harmonized data from several state-of-the-art seasonal forecasting databases stored at the ECOMS-UDG.

Testing loadeR

Setting Up the Test Environment:

  1. Create a Conda environment with R 3.6 and the packages that loadeR depends on: bash conda create -n c4r-loader-tests -c conda-forge r-base=3.6 r-loader.java "r-climate4r.udg>=0.2.0" r-abind r-rcurl

  2. Install the packages needed for testing: bash conda install -c conda-forge r-devtools r-covr libnetcdf The r-devtools package is used to run the test suite, without requiring the package to be formally installed. The r-covr package allows you to compute test coverage. Finally, libnetcdf is needed to generate temporary .nc files from .cdl definitions included in the package. These NetCDF files are created and deleted dynamically during testing, and serve as input data for specific test cases. If you use R versions 4.3 or 4.4 on Windows, you may encounter compatibility issues with the r-devtools package. It is recommended to use R 3.6 for full compatibility.

Running the Tests:

  1. Before running any tests, you need to clone the loadeR package repository locally: bash git clone https://github.com/SantanderMetGroup/loadeR.git cd loadeR This puts you in the root directory of the package.

  2. Make sure to activate the environment you created earlier: bash conda activate c4r-loader-tests

  3. Once you're in the root directory of the cloned package and the environment is active, run the following command to execute the test suite: bash Rscript -e "devtools::test()" The test() function from the devtools package runs all tests located in the tests/testthat/ directory of the package without requiring the package to be installed. It is a shortcut for testthat::testdir(), and automatically reloads the package code using devtools::loadall() before running the tests. This means that any changes made to the functions in the package are detected immediately when the tests are run.

  4. Once you're in the root directory of the cloned package and the environment is active, run the following command to check the test coverage: bash Rscript -e "covr::package_coverage()" This command returns the coverage percentage for each R file in the package, indicating how much of the code is exercised by the test suite.

Note: you can also develop and use the package outside the test suite. To do so, start an R session from the root directory of the package (with the environment activated), and run: R devtools::load_all() This will simulate loading the package from the local source directory (where you're located) and make all its functions available in the R session. Any change you make to the R scripts will be picked up the next time you run devtools::load_all(). After that, you can call the functions normally from your R session, and they will reflect your latest changes without requiring installation.

Reference and further information:

[General description of the climate4R framework] Iturbide et al. (2019) The R-based climate4R open framework for reproducible climate data access and post-processing. Environmental Modelling and Software, 111, 42-54. https://doi.org/10.1016/j.envsoft.2018.09.009 Check out the companion notebooks with worked examples.

[Statistical Downscaling] Bedia et al. (2020). Statistical downscaling with the downscaleR package (v3.1.0): contribution to the VALUE intercomparison experiment. Geoscientific Model Development, 13, 1711–1735. https://doi.org/10.5194/gmd-13-1711-2020

[Seasonal forecasting applications] Cofiño et al. (2018) The ECOMS User Data Gateway: Towards seasonal forecast data provision and research reproducibility in the era of Climate Services. Climate Services, 9, 33-43. http://doi.org/10.1016/j.cliser.2017.07.001

[Example of a sectoral application (fire danger)] Bedia et al. (2018) Seasonal predictions of Fire Weather Index: Paving the way for their operational applicability in Mediterranean Europe. Climate Services, 9, 101-110. http://doi.org/10.1016/j.cliser.2017.04.001

Owner

  • Name: Santander Meteorology Group (UC-CSIC)
  • Login: SantanderMetGroup
  • Kind: organization
  • Location: Santander

a multidisciplinary approach to weather & climate

GitHub Events

Total
  • Create event: 1
  • Release event: 1
  • Issues event: 2
  • Member event: 1
  • Issue comment event: 1
  • Push event: 1
  • Pull request event: 1
  • Fork event: 4
Last Year
  • Create event: 1
  • Release event: 1
  • Issues event: 2
  • Member event: 1
  • Issue comment event: 1
  • Push event: 1
  • Pull request event: 1
  • Fork event: 4

Committers

Last synced: 6 months ago

All Time
  • Total Commits: 395
  • Total Committers: 12
  • Avg Commits per committer: 32.917
  • Development Distribution Score (DDS): 0.559
Past Year
  • Commits: 5
  • Committers: 3
  • Avg Commits per committer: 1.667
  • Development Distribution Score (DDS): 0.4
Top Committers
Name Email Commits
jbedia j****a@g****m 174
Your Name m****e@g****m 127
Sixto Herrera García h****s@u****s 55
Jose M. Gutierrez g****m@u****s 19
Jorge b****a@i****s 6
Ezequiel Cimadevilla Alvarez e****a@u****s 4
Jorge Bano Medina j****a@M****l 3
mor427unican m****7@a****s 3
Antonio S. Cofiño c****a@g****m 1
Etienne Tourigny e****y@b****s 1
María Isabel de la Osa Rocha 1****n@u****m 1
jesusff j****f@u****m 1
Committer Domains (Top 20 + Academic)
unican.es: 3 bsc.es: 1 alumnos.unican.es: 1 ifca.unican.es: 1

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 81
  • Total pull requests: 6
  • Average time to close issues: 4 months
  • Average time to close pull requests: 6 months
  • Total issue authors: 47
  • Total pull request authors: 6
  • Average comments per issue: 2.23
  • Average comments per pull request: 1.67
  • Merged pull requests: 2
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 2
  • Pull requests: 1
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 2
  • Pull request authors: 1
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
View more stats
Top Authors
Issue Authors
  • matteodefelice (14)
  • jbedia (6)
  • cofinoa (5)
  • xiaoyujiaxyj (3)
  • gcurci (3)
  • sixtohg (2)
  • jesusff (2)
  • dinilu (2)
  • zepedromvramiao (2)
  • cherryniu (2)
  • rmanzanas (2)
  • ABY1950 (2)
  • jpvergnes (2)
  • wspt96 (1)
  • dhruv2207 (1)
Pull Request Authors
  • matteodefelice (1)
  • etiennesky (1)
  • miturbide (1)
  • mor427unican (1)
  • sixtohg (1)
  • cofinoa (1)
Top Labels
Issue Labels
enhancement (13) help wanted (8) bug (3) question (2) wontfix (1)
Pull Request Labels

Packages

  • Total packages: 3
  • Total downloads: unknown
  • Total dependent packages: 2
    (may contain duplicates)
  • Total dependent repositories: 4
    (may contain duplicates)
  • Total versions: 34
proxy.golang.org: github.com/santandermetgroup/loader
  • Versions: 30
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 7.0%
Average: 8.2%
Dependent repos count: 9.3%
Last synced: 6 months ago
conda-forge.org: r-loader
  • Versions: 2
  • Dependent Packages: 2
  • Dependent Repositories: 2
Rankings
Dependent packages count: 19.6%
Dependent repos count: 20.1%
Average: 33.9%
Forks count: 42.5%
Stargazers count: 53.4%
Last synced: 6 months ago
conda-forge.org: r-loader.2nc
  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 2
Rankings
Dependent repos count: 20.1%
Average: 41.9%
Forks count: 42.5%
Dependent packages count: 51.5%
Stargazers count: 53.4%
Last synced: 6 months ago

Dependencies

DESCRIPTION cran
  • R >= 3.5.0 depends
  • climate4R.UDG >= 0.2.0 depends
  • loadeR.java * depends
  • rJava * depends
  • RCurl * imports
  • abind * imports
  • utils * imports
  • downscaleR * suggests
  • loadeR.ECOMS * suggests
  • transformeR * suggests
  • visualizeR * suggests