[[Image(Rlogo.jpg)]]

= Overview of the `ecomsUDG.Raccess` package  

Since the [http://www.r-project.org/ R language] has been adopted for some key tasks in the EUPORIAS and SPECS projects (including the development of comprehensive validation and statistical-downscaling packages), the `ecomsUDG.Raccess` is envisaged as a user-friendly, R-based interface to the ECOMS User Data Gateway, enabling [wiki:./Authentication authentication] and remote access to the different datasets (seasonal forecasting, observations, reanalysis) currently available. Moreover, `ecomsUDG.Raccess` implements data homogenization (a single vocabulary) and time filtering/aggregation functionality.

The `ecomsUDG.Raccess` package relies on the `rJava` package as an interface to the powerful capabilities of the [http://www.unidata.ucar.edu/downloads/netcdf/netcdf-java-4/index.jsp Unidata's netCDF Java library].

  * [wiki:./prerequisites Pre-requisites]
  * [wiki:./Authentication Authentication]
  * [wiki:./Homogeneization Data Homogeneization]
  * [wiki:./Examples Examples]
{{{#!comment
  * [wiki:./Functions Defined Functions]
 }}}

= Versions

The latest versions (stable and/or devel) can be installed directly from [https://github.com/SantanderMetGroup/ecomsUDG.Raccess gitHub], but please note that the R package [http://cran.r-project.org/web/packages/devtools/index.html devtools] must be installed.

== Latest stable release 2.1-1 (11 Jul 2014)

[https://github.com/SantanderMetGroup/ecomsUDG.Raccess/releases/tag/v2.1-1 see what's new]

 
To obtain the latest stable release of the `ecomsUDG.Raccess` package (and the associated dependencies), type the following commands from your R console:

{{{
#!text/R
devtools::install_github(c("SantanderMetGroup/downscaleR.java@stable", "SantanderMetGroup/ecomsUDG.Raccess@stable"))

}}}


{{{#!comment
Once installed, when loading the library it should look something like this:

{{{
> library(ecomsUDG.Raccess)
Loading required package: downscaleR.java
Loading required package: rJava
NetCDF Java Library v4.3.22 (27 May 2014) loaded and ready
Loading required package: abind
ecomsUDG.Raccess version 2.1.0 (08-Jul-2014) is loaded
>
}}}
}}}

== Development version

The development version is available at the 'master' branch of the ​[http://github.com/santandermetgroup/ecomsudg.raccess gitHub repository]

[[NoteBox(The development version is unstable and may not be functional)]]

{{{
#!text/R
devtools::install_github(c("SantanderMetGroup/downscaleR.java@stable", "SantanderMetGroup/ecomsUDG.Raccess"))

}}}

== Older versions

{{{#!comment
Current stable version sources: '''ecomsUDG.Raccess v2.0-0 (16-Jun-2014)''' [attachment:ecomsUDG.Raccess_2.0-0.tar.gz Linux/Mac] [attachment:ecomsUDG.Raccess_2.0-0.zip Windows]  [attachment:vignette.pdf Package Manual (pdf)]
}}}

* '''version 2.1-0''' (8 Jul 2014)
  * New extended list of available variables
  * NCEP reanalysis included in available datasets
  * On-the-fly computation of derived variables
  * Support for variables with vertical levels and static (e.g. geopotential surface zs)
  * New dependency on downscaleR.java R package containing Java dependencies


 * '''version 2.0-0''' (16-jun-2014). Includes access to a extended list of surface variables, a new observational gridded dataset WFDEI, and on-the-fly time filtering/aggregation capabilities. New input/output formats.

 * '''version 1.0-0''' (17-feb-2014). Access to a limited list of surface variables for System4 and CFSv2 datasets.