Package: ccmval-cdx
This is CCMValDiag with enhancements to read data from CDX.CCMVal Diagnostic ToolThis is theChemistry Climate Model ValidationDiagnostictool with
modifications by theCDX(Climate Data Exchange) project ofJPLto support
transparent access to data stored within the CDX “cloud”.These modifications enhance the CCMValDiag tool by enabling it to access data
not only inNetCDFfiles in the local filesystem but also stored within CDX
product servers.  It does so by allowing you to specify acdx:style URL
in your diagnosticnamelistfile in place of a regular local filesystem
path.What You GetIn this distribution you’ll find:ccmvalThe beta9 version of the CCMValDiag code taken from itssubversion repositoryincludingenhancements by CDX.README.txtThis file.setup.pyStandarddistutilsandsetuptoolsmetadata.setup.cfgStandard configuration fordistutilsandsetuptools.DependenciesThe 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-clientor 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 runningpythonand enter the following:>>> import cdx.clientIf you receive an ImportError, you’ll need to install cdx.client.UseFor use of CCMValDiag, consult the README* files in theccmvaldirectory.
(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 acdx:URL.Here is an examplecdx:URL:cdx://jpl-esg.jpl.nasa.gov:8080/cdxesg/prod/commit/atm/da/hfls/pr/ncar_ccsm3_0/run1Let’s look at each part of this URL.cdx:This is the URL scheme. It shouldalwaysbecdx:jpl-esg.jpl.nasa.gov:8080This is the net location of the CDX product server.  In this case, we’re
access the host calledjpl-esg.jpl.nasa.govand the server listening
on port number 8080.cdxesgThis is the web endpoint to use.  It identifies a particular web
application on the server listening on port 8080, in this casecdxesg.
Each CDX product server is differentiated by its web endpoint.prodThis string indicates we want to access the product service.  It shouldalwaysbeprod./commit/atm/da/hfls/pr/ncar_ccsm3_0/run1This identifies the pathwithin the product serverof the data to
access.  In this case, this path references three NetCDF files on the
product server that live in therun1directory (which lives in thencar_ccsm3_0directory, 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 thenamelist_cdxfile in
theccmvaldirectory.Changelog0.0.0 - UnreleasedInitial releaseCopyrightThe enhancements to CCMValDiag that enable reading from CDX are copyright
2009 by the California Institute of Technology.  ALL RIGHTS RESERVED.  The
remaining software retains the copyright of its original owners.The enhancements are owned by Caltech/JPL and are protected by United States
copyright laws and applicable international treaties and/or conventions.  The
United States Government may have prior rights to use some or all of the
enhancements as determined under applicable contracts and license agreements
with Caltech/JPL.The enhancements were developed at the Jet Propulsion Laboratory, an operating
division of the California Institute of Technology and are not available for
use by any person, organization, or other entity without prior, specific
written permission.