cdx.datawrappers 0.0.0.dev-r5638

**********
cdx.datawrappers
**********

.. contents::

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:

1. Download http://peak.telecommunity.com/dist/ez_setup.py
2. 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:

1. 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.
2. Unpack each archive.
4. Change the current working directory to each newly-created subdirectory,
``cdx.datawrappers-0.0.0``, again substituting version
numbers as appropriate.
5. 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.


.. References:
.. _contact: http://cdx.jpl.nasa.gov/contact-info
.. _EasyInstall: http://peak.telecommunity.com/DevCenter/EasyInstall
.. _Java: http://tinyurl.com/5kng2h
.. _OODT: http://oodt.jpl.nasa.gov/
.. _Python: http://python.org/

Changelog
*********

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.