{ "info": { "author": "Ag Stephens", "author_email": "ag.stephens@stfc.ac.uk", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: Science/Research", "License :: Other/Proprietary License", "Operating System :: POSIX :: Linux", "Topic :: Scientific/Engineering :: Atmospheric Science" ], "description": "=========\ncdat-lite\n=========\n\n.. contents::\n\n.. sectnum::\n\nCdat-lite is a Python package for managing and analysing climate\nscience data. It is a subset of the Climate Data Analysis Tools\n(CDAT_) developed by PCMDI_ at Lawrence Livermore National Laboratory.\n\nCdat-lite aims to complement CDAT by focusing on its core data\nmanagement and analysis components and by offering a radically\ndifferent installation system to CDAT. As a result it is much more\nlightweight (hence the name): CDAT's source distribution is the order\nof 1Gb whereas cdat-lite is under 5Mb.\n\nCdat-lite is designed to work with the `CF checker`_ package.\n\n.. _CDAT: http://www2-pcmdi.llnl.gov/cdat\n.. _PCMDI: http://www2-pcmdi.llnl.gov/\n.. _`CF checker`: http://pypi.python.org/pypi/cfchecker\n\n\ncdat-lite versioning\n====================\n\nCdat-lite is a project that tracks versions of 2 other projects (CDAT\nand cdunifpp). From version 6.0rc1 the cdat-lite version will not be\nbased directly on the CDAT version. This is because CDAT updates its\nversion very seldom and stays as an \"alpha\" distribution for long\nperiods when the parts included in cdat-lite are generally stable.\n\nFull details of which versions of CDAT and cdunifpp a cdat-lite\ndistribution includes is available in the setup.py file and the\nPKG_INFO metadata.\n\nInstalling cdat-lite\n====================\n\ncdat-lite is distributed as a tarball available from the `cdat-lite\nhomepage`_ on the `NERC Data Grid wiki` . It is also installable\nusing the ``easy_install`` tool. If you are familiar with\n``easy_install`` try this super-quick installation recipe::\n\n $ export NETCDF_HOME=/usr/local/netcdf\n # Required if using a NetCDF4 compiled with HDF5\n $ export HDF5_HOME=/usr/local/hdf5\n $ easy_install cdat_lite \n\n\nDependencies\n------------\n\nTo install cdat-lite you will need:\n\n 1. `Python 2.5.x`_. cdat-lite has not been tested on 2.6 but may\n work (feedback would be gratefully received). It is unlikely to work on 3.0.\n\n 2. `setuptools`_. cdat-lite will attempt to download and install\n setuptools if it is missing but it is safer to install it first.\n\n 3. `NetCDF-3.x`_ or greater. cdat-lite should work with any\n relatively modern NetCDF3 installation on your system provided it is\n compiled as a shared library. It will also work with NetCDF4\n configured in various different ways, including embedded OPeNDAP\n mode.\n\n 4. If you want to run the short test suite you will need nose_\n\n.. _`Python 2.5.x`: http://www.python.org/download/releases/2.5.4\n.. _`setuptools`: http://pypi.python/org/setuptools\n.. _`NetCDF-3.x`: http://www.unidata.ucar.edu/software/netcdf/\n.. _nose: http://somethingaboutorange.com/mrl/projects/nose/\n\nSelecting your NetCDF installation\n----------------------------------\n\ncdat-lite will work with NetCDF3 or NetCDF4 but because it is\nreferenced by shared libraries (the python C extension modules) it\nmust be compiled as position independent code. If you have a NetCDF4\ninstallation you almost certainly are using shared libraries and even\nif you wish to use NetCDF3 it is probably easiest to install NetCDF as\na shared library (use ``--enable-shared`` in the NetCDF ``configure``\nscript). Alternatively, you can configure NetCDF with::\n\n $ ./configure --with-pic ...\n\nIf you are using NetCDF4 you will also need to configure HDF5 with ``--enable-shared`` or ``--with-pic``.\n\nIf you have the command ``nc-config`` in your path cdat-lite will\ndetect all library and include dependencies. Otherwise cdat-lite will\nlook for a NetCDF installation in several places.\n\nIf your NetCDF is installed somewhere unusual, or if you want to\nselect a specific installation, set the NETCDF_HOME variable. E.g.::\n\n # sh users\n $ export NETCDF_HOME=/usr/local/netcdf\n # csh users\n $ setenv NETCDF_HOME /usr/local/netcdf\n\nIf you are using NetCDF4 cdat-lite will also look for your HDF5\ninstallation which you can configure in a similar way::\n\n # sh users\n $ export HDF5_HOME=/usr/local/hdf5\n # csh users\n $ setenv HDF5_HOME /usr/local/hdf5\n\nFor compatibility with the ``netcdf4-python`` package cdat-lite also accepts ``NETCDF4_DIR`` AND ``HDF5_DIR`` as synonims for these environment variables.\n\nNote, you don't need these environment variables set to run cdat_lite,\nalthough the libraries must be findable by your system's dynamic\nlinker. This can be configured by setting ``LD_LIBRARY_PATH`` or using ``ldconfig``.\n\nRunning the installer\n---------------------\n\nIf you have all the dependencies in place you can try using\n``easy_install`` to automatically download and install cdat_lite. Make sure you have access to the internet, with the appropriate HTTP proxy settings, and do::\n\n $ easy_install cdat-lite\n\nAlternatively you might want to see what you are installing :-). In\nthis case either download the tarball__ or use ``easy_install`` to do it for you::\n\n $ easy_install -eb . cdat-lite\n # The cdat-lite tarball will be downloaded unpacked into you current directory\n\nNow from the distribution directory run the build and install steps separately::\n\n $ python setup.py bdist_egg\n $ easy_install dist/cdat-lite*.egg\n\n__ `cdat-lite homepage`_\n\n\n.. _`installing locally`:\n\nInstalling as an unprivileged user\n----------------------------------\n\nIf you don't have write access to your python distribution you can use\nthe tool virtualenv_ to create a local python environment with\nits own ``easy_install`` executable which you can then use to install\ncdat-lite. In combination with ``NETCDF_HOME``, ``HDF5_HOME`` and\n``LD_LIBRARY_PATH`` it should be possible to install all dependencies\nof cdat-lite locally. See the virtualenv_ for details on\ninstallation or try this recipe after downloading the virtualenv::\n\n # From virtualenv distribution directory\n $ ./virtualenv.py \n $ cd \n $ source bin/activate\n (venv)$ easy_install cdat-lite\n\n.. _virtualenv: http://pypi.python.org/pypi/virtualenv\n\n\nPlatform-specific installation notes\n------------------------------------\n\nOS X\n''''\n\nChristopher Lee contributed the following experiences installing on OS X 10.6.7.\n\nMy particular Macbook has an Intel CPU, and the default on the Mac is\nto compile for the architecture x86_64. In order to override this\n(because python is 32 bit, and the netcdf libraries I use are also 32\nbit) I needed to pass in \"-arch i386\" to the compiler. I also needed\nthe little endian flag '-DBYTESWAP' when compiling the netcdf\ninterface (inside libcdms). The -DBYTESWAP flag should be included by\nthe libcdms configure script, where there is a section for 'darwin'\n(OS X), but it's currently configured without BYTESWAP (line\n6182). The problem here is that OS X used to run on PowerPC CPUs,\nwhich don't need the BYTESWAP flag. I'm not sure if this is your\nconfigure script or if it's from the cdat package.\n\nI included the -arch i386 and -DBYTESWAP in the setup.py in the\nlibcdms section, and the setup works fine.\n\nAfter running python setup.py build ; python setup.py install ; I\nstill get an error when importing cdms2. This problem is caused by the\nway that libcdms is linked to the netcdf libraries. The 'normal' Mac\nmethod is to link with absolute paths, but libcdms is linked with\nrelative paths (the libraries are references with @rpath). The result\nis that LD_LIBRARY_PATH environment variable is often empty. I'm not\nsure how to fix this in the 'Mac' way with absolute paths, but I added\nmy $NETCDF_HOME/lib directory to the variable and cdms2 now imports\nwithout error.\n\n\nTesting the installation\n========================\n\ncdat-lite ships with a small set of tests designed to verify that it\nhas been built successfuly. These tests require the testing framework\nnose_. Once cdat-lite is installed just run::\n\n $ nosetests cdat_lite\n\nWhen run from cdat-lite's distribution directory nosetests will run\nslightly differently, running some tests that are known to fail at the\nmoment. To disable this behaviour do:\n\n $ nosetests --config=''\n\n.. _`cdat-lite homepage`: http://proj.badc.rl.ac.uk/ndg/wiki/CdatLite\n.. _`NERC Data Grid wiki`: http://proj.badc.rl.ac.uk/ndg/wiki\n\n\n\nFAQ\n===\n\nWhat is CDAT?\n-------------\n\nCDAT_ is a large suite of open source tools distributed by PCMDI_ for\nthe management and analysis of climate data. It includes several\nvisualisation components and the graphical user interface VCDAT.\n\nWhat is the difference between CDAT and cdat-lite?\n--------------------------------------------------\n\nDifferences between CDAT and cdat-lite can be classified as\ndifferences in scope, i.e. which packages are included, and installation system.\n\ncdat-lite contains the 'cdms2' package and a few related\npackages. It does not include the 'vcs' visualisation package or the\nVCDAT graphical user interface. As of v5.1.1-0.3pre3 the included\npackages are:\n\n * cdms2\n\n * cdtime\n\n * cdutil\n\n * genutil\n\n * ncml\n\n * Properties\n\n * regrid2\n\n * unidataa\n\n * xmgrace\n\nCDAT bundles virtually all dependencies together in its source\ndistribution -- even Python itself. This has its advantages as it\nsimplifies satisfying dependencies and avoids version conflicts\nbetween dependencies. However, if you want to integrate CDAT's data\nmanagement components into your existing Python architecture CDAT can\nbe overkill.\n\n\nWhat has changed between cdat-lite-4.x and cdat-lite-5.x?\n---------------------------------------------------------\n\nIf you are a cdat-lite-4 user (or a CDAT 4 user) you have a big\nmigration job on your hands. CDAT-4 uses the ``Numeric`` package for\narrays which has been out of date and unmaintained for a long time\nnow. It is known to have problems on 64bit architectures.\n\nHow does cdat-lite track changes to CDAT?\n-----------------------------------------\n\ncdat-lite tries to release major new versions shortly after new\nversions of CDAT. Sometimes CDAT-trunk contains important fixes that\nshould be applied so that the latest cdat_lite can run ahead of\nofficial CDAT releases (although sometimes CDAT recommends you build\nfrom trunk anyway).\n\nThe one exception is the UK Met. Office PP file support which is\nusually updated in cdat_lite before CDAT. In all cases the exact\nbuild versions of CDAT and cdunifpp will be stated in the\ndistribution's ``setup.py`` file.\n\nHow can I use CMOR2 with cdat-lite?\n-----------------------------------\n\nWe are interested to hear any with experience of using CMOR2 with\ncdat-lite but it should be as simple as downloading the distribution\nand installing it in parallel with::\n\n # From the CMOR install directory\n $ python setup.py install\n\nHow can I use OPeNDAP with cdat-lite?\n-------------------------------------\n\nOPeNDAP support is an experimental feature of cdat-lite at the moment.\nUnlike CDAT you don't select OPeNDAP explicitly during installation\nbut cdat-lite will inherit any OPeNDAP support embedded into the\nNetCDF4 library. Recent beta releases of NetCDF4 provides a switch to\ntransparently use OPeNDAP.\n\nHow do I install cdat-lite as an unprivileged user?\n---------------------------------------------------\n\nSee `installing locally`_\n\nWhich versions of NetCDF does cdat-lite support?\n------------------------------------------------\n\nTODO", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://proj.badc.rl.ac.uk/cedaservices/wiki/CdatLite", "keywords": null, "license": "http://www-pcmdi.llnl.gov/software-portal/cdat/docs/cdat-license", "maintainer": null, "maintainer_email": null, "name": "cdat-lite", "package_url": "https://pypi.org/project/cdat-lite/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/cdat-lite/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://proj.badc.rl.ac.uk/cedaservices/wiki/CdatLite" }, "release_url": "https://pypi.org/project/cdat-lite/6.0.1/", "requires_dist": null, "requires_python": null, "summary": "Core components of the Climate Data Analysis tools. This software is based on CDAT-6.0.alpha-g82e6c52 and cdunfpp0.13.", "version": "6.0.1" }, "last_serial": 1865852, "releases": { "4.1.2-0.2.1": [], "5.2": [], "5.2rc1": [ { "comment_text": "", "digests": { "md5": "068853f87e0fd5d0a84dfbe30a6676e8", "sha256": "a8e95b68320033e9260f0a251772149ed306ea58557fca2e8b54b6dfdf852c15" }, "downloads": -1, "filename": "cdat_lite-5.2rc1.tar.gz", "has_sig": false, "md5_digest": "068853f87e0fd5d0a84dfbe30a6676e8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3474765, "upload_time": "2009-09-15T17:22:32", "url": "https://files.pythonhosted.org/packages/05/92/7bf70573a4d43922089ff8f352eddb8903de1b7995b7a9ef15f2d513d5fa/cdat_lite-5.2rc1.tar.gz" } ], "6.0.1": [ { "comment_text": "", "digests": { "md5": "6d5a6e86f15ce15291d25feab8793248", "sha256": "092ae4ff1fb03dee00096e8dd595b769b422759ce972d96525950adf8e1c9374" }, "downloads": -1, "filename": "cdat-lite-6.0.1.tar.gz", "has_sig": false, "md5_digest": "6d5a6e86f15ce15291d25feab8793248", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4042646, "upload_time": "2015-12-16T22:43:59", "url": "https://files.pythonhosted.org/packages/27/0f/793dc6c152b4281613417243728ff580c691b68d710544e06118f6eed4b5/cdat-lite-6.0.1.tar.gz" } ], "6.0.alpha-3": [], "6.0.alpha-4": [], "6.0rc1": [], "6.0rc2": [], "6.0rc3": [ { "comment_text": "", "digests": { "md5": "e90bce0a6180c44a2a2008dfd0b9e683", "sha256": "df3fe842711389ea62c327772fbd951a860e2b91db93a9da29b0700104d718e9" }, "downloads": -1, "filename": "cdat-lite-6.0rc3.tar.gz", "has_sig": false, "md5_digest": "e90bce0a6180c44a2a2008dfd0b9e683", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4042762, "upload_time": "2015-12-16T22:37:47", "url": "https://files.pythonhosted.org/packages/1f/08/5ce5263037587e656eb723f5a9766ff943170bdc0038711a9f91ebd66f09/cdat-lite-6.0rc3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "6d5a6e86f15ce15291d25feab8793248", "sha256": "092ae4ff1fb03dee00096e8dd595b769b422759ce972d96525950adf8e1c9374" }, "downloads": -1, "filename": "cdat-lite-6.0.1.tar.gz", "has_sig": false, "md5_digest": "6d5a6e86f15ce15291d25feab8793248", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4042646, "upload_time": "2015-12-16T22:43:59", "url": "https://files.pythonhosted.org/packages/27/0f/793dc6c152b4281613417243728ff580c691b68d710544e06118f6eed4b5/cdat-lite-6.0.1.tar.gz" } ] }