ccmval-cdx 0.0.1dev-r5450

What You Get

In this distribution you’ll find:

ccmval

The beta9 version of the CCMValDiag code taken from its subversion repository including enhancements by CDX.

README.txt

This file.

setup.py

Standard distutils and setuptools metadata.

setup.cfg

Standard configuration for distutils and setuptools.

Dependencies

The enhancements to CCMValDiag rely on the cdx.client package. You can learn more about cdx.client at this address:

http://cdx.jpl.nasa.gov/software/cdx-client

or by reviewing its Python Package Index (“Cheeseshop”) entry at:

http://pypi.python.org/pypi/cdx.client/

See either website for detailed installation instructions. To see if your Python installation already has the cdx.client package, try running python and enter the following:

>>> import cdx.client

If you receive an ImportError, you’ll need to install cdx.client.

Use

For use of CCMValDiag, consult the README* files in the ccmval directory. (JPL is solely responsible for the enhancements that enable reading from CDX product servers and, unfortunately, cannot assist you with running of CCMValDiag.)

The input models for CCMValDiag are specified as filesystem path names in a “namelist” file. You create a namelist file to identify input models, variables to validate, plot types, and so forth. To query from CDX, you replace the filesystem path name with a cdx: URL.

Here is an example cdx: URL:

cdx://jpl-esg.jpl.nasa.gov:8080/cdxesg/prod/commit/atm/da/hfls/pr/ncar_ccsm3_0/run1

Let’s look at each part of this URL.

cdx:

This is the URL scheme. It should always be cdx:

jpl-esg.jpl.nasa.gov:8080

This is the net location of the CDX product server. In this case, we’re access the host called jpl-esg.jpl.nasa.gov and the server listening on port number 8080.

cdxesg

This is the web endpoint to use. It identifies a particular web application on the server listening on port 8080, in this case cdxesg. Each CDX product server is differentiated by its web endpoint.

prod

This string indicates we want to access the product service. It should always be prod.

/commit/atm/da/hfls/pr/ncar_ccsm3_0/run1

This identifies the path within the product server of the data to access. In this case, this path references three NetCDF files on the product server that live in the run1 directory (which lives in the ncar_ccsm3_0 directory, and so forth).

By placing such a URL in the MODELS section of a namelist file, CCMValDiag will be able to work its magic on CDX data.

For an example namelist that uses CDX URLs, see the namelist_cdx file in the ccmval directory.