Skip to main content

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.


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.

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:

  1. Download
  2. As an administrative user, run the freshly-downloaded 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:

  1. Download the cdx-datawrappers source distribution from Substitute version numbers as appropriate.
  2. Unpack each archive.
  3. Change the current working directory to each newly-created subdirectory, cdx.datawrappers-0.0.0, again substituting version numbers as appropriate.
  4. As an administrative user, run: python install in each subdirectory.

Issues and Questions

To report any problems with or ask for help about cdx-datawrappers, visit our contact web page.


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

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

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

0.0.5 - 09/10/2010

This release updates the CloudSAT datawrappers URL. See CDX-99 for more details.

For the issue tracker, see

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

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 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

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

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.

Project details

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page