CDX Data Wrappers
Project description
CDX DataWrappers provides an API into the CDX data systems that enables subsetting and spatial and temporal access to date made available from CDX. CDX is the Climate Data Exchange, an effort of the Jet Propulsion Laboratory to create a virtual environment for the sharing of climate data.
Installation
This document tells you how to install cdx-datawrappers.
Quick Instructions
As a user with administrative privileges, run:
easy_install cdx-datawrappers
That’s it.
Full Instructions
cdx-datawrappers requires the Python programming language. We recommend version 2.4 or later. As of this writing, 2.6 is the latest stable version. If Python is not yet installed on your system, you can find binary and and source distributions from the Python website.
To test if a correct version of Python is available on your system, run:
python -V
You should see output similar to:
Python 2.6
indicating the version of Python installed.
By far the easiest, recommended, and encouraged way to install cdx-datawrappers is to use EasyInstall. If your Python installation has EasyInstall available to it, then this one command is all you need to run in order to download, build, install, and generate command-line tools all in one go for all users on your system:
easy_install cdx-datawrappers
Be sure to run that command as an administrative user. For example, on Mac OS X and other Unix systems, you might need to run:
sudo easy_install cdx-datawrappers
That will also download and install all dependencies, including Setuptools.
Executables
Installing EasyInstall
If you happen to be on a system where your Python installation lacks easy install, fret not. Upgrading your system to gain EasyInstall’s abilities is quite simple. Follow these instructions:
As an administrative user, run the freshly-downloaded ez_setup.py file using your system’s Python.
EasyInstall and its necessary libraries will be downloaded, built, and installed for you, and the easy_install executable generated. The location of the easy_install executable is as described above.
Installing Without EasyInstall
If EasyInstall is not available on your system, you can still make a proper installation of cdx-client. Follow these instructions:
Download the cdx-datawrappers source distribution from http://cdx.jpl.nasa.gov/software/dist/cdx-datawrappers/cdx-datawrappers-0.0.0.tgz Substitute version numbers as appropriate.
Unpack each archive.
Change the current working directory to each newly-created subdirectory, cdx.datawrappers-0.0.0, again substituting version numbers as appropriate.
As an administrative user, run: python setup.py install in each subdirectory.
Issues and Questions
To report any problems with or ask for help about cdx-datawrappers, visit our contact web page.
Changelog
0.0.8 - 10/19/2011
This release includes CDX-120 that provides data wrapper support for AIRX2STC products (AIRS CO2 products).
For the issue tracker, see https://oodt.jpl.nasa.gov/jira/browse/CDX
0.0.7 - 06/27/2011
This release adds functionality to enable ESG security, and to allow OPeNDAP URLs to be configurable by a user. See CDX-116 and CDX-111 respectively.
For the issue tracker, see http://oodt.jpl.nasa.gov/jira/browse/CDX
0.0.6 - 11/13/2010
This release adds in functionality to do subsetting by latitude, longitude, and time (adding the time dimension) to improve upon the work in CDX-94. See CDX-103 for more details.
For the issue tracker, see http://oodt.jpl.nasa.gov/jira/browse/CDX
0.0.5 - 09/10/2010
This release updates the CloudSAT datawrappers URL. See CDX-99 for more details.
For the issue tracker, see http://oodt.jpl.nasa.gov/jira/browse/CDX
0.0.4 - 09/03/2010
This release includes a subtle, but important improvement to the GetVariableByLatLon functionality provided by each data wrapper. Instead of returning an 1 or 2 dimensional array of values (1 dimension if the original array was 2d, and 2 dimensional if it was 3d) that fall within the provided lat/lon range, the data wrappers have been modified to return a 1 or 2 dimensional array of tuples of the form lat, lon, value, so that the values can be remapped onto a new spatial grid to support the conditional analysis scenario. See CDX-94 for more details.
For the issue tracker, see http://oodt.jpl.nasa.gov/jira/browse/CDX
0.0.3 - 03/24/2010
This release includes improvements to the MLS, MISR, CloudSAT and CCSM data wrappers, adding in the subsetByLatLon function (per CDX-84). Additionally this release includes modifications to the GetVariable function in the CDXDataWrapper.py interface and all subsequent implementations to allow a constraint to be specified for further subsetting (see CDX-86 for more details).
For the issue tracker, see http://oodt.jpl.nasa.gov/jira/browse/CDX
0.0.2 - 02/27/2010
This release includes improvements to the CDXDataWrapper interface including the ability to subset by lat and lon for AIRS data on the AIRSDataWrapper.
For the issue tracker, see http://oodt.jpl.nasa.gov/jira/browse/CDX.
0.0.1 - 10/02/2009
This release includes its own specially modified version of PyDAP to work around some outstanding issues in that library.
0.0.0 - Initial
This is an initial release of cdx-datawrappers providing local data access to MISR, MLS AIRS and NCAR’s Community Climate Simulation Model (CCSM) output netCDF data, and remote access to MLS, AIRS and CCSM data.
