CDAT Documentation

We recommend that you build CDAT from the sources. CDAT is available on these platforms.

• Linux systems kernel 2.2 and up
• Sun/Solaris (we tested 5.6)
• Dec OSF 1 (we tested 5.0)
• Irix (we tested 6.5)
• HP-UX 11.0 (We know 10 will not work)
• MacOSX "Darwin"

We're working on a bug building Python on AIX.

For convenience we sometimes provide binary versions in our download area. Binaries might not work properly on your system. If you have trouble with a binary installation, please try a source build before reporting difficulty.

The latest install instructions are always in the README.txt file at the top level of the extracted files.

Obtaining and Installing CDAT Releases

You can download our sources or get them directly from our repository as explained in below.

1. Go the Sourceforge CDAT Project Page.
2. Scroll down to "Latest File Releases", find the line "CDAT" and click on "Download".
   The download page will appear and you can select the file you want.

   The distribution is available in one piece or in 3 separate pieces for easier downloading.

3. Uncompress and untar it
as follows:
• gunzip cdatfile.tar.gz
• tar xvf cdatfile.tar
• On some systems, such as Linux, you can just do one step: tar xvfz cdatfile.tar.gz.
4. Follow the instructions in the README.txt file.

Tutorials

1. Get the tutorial examples and the datasets as above.
2. Untar them both.
3. Enjoy discovering CDAT's capabilities

Direct Access to the Source Repository

CDAT is an open-source project. So how do you see the source? And never download by hand again?

Our normal release cycle releases a set of sources at a stable point. However, you might want to get an update between releases because someone has made an improvement you would like to use. You can now do this yourself. Be aware that while we make every attempt to only commit source that is correct and working, and that we develop in separate "branches" to help ensure this, this direct access is inherently less stable than using our official releases.

Here is how to do it:

[dubois@ldorritt ~/foo]$ p4 info
User name: pcmdi
Client name: pcmdi-junk
Client host: ldorritt
Client unknown.
Current directory: /pcmdi/dubois/foo
Client address: 192.12.134.251:33720
Server address: esg.llnl.gov:1666
Server root: /p4root
Server date: 2002/03/25 09:29:23 PST
Server version: P4D/LINUX52X86/2001.1/26850 (2001/10/15)
Server license: Lawrence Livermore National Laboratory (LLNL) 10 users

Edit this to add "main/" right before the two sets of ...'s, so it reads:
   //depot/main/...  //pcmdi-yourname/main/...
Save and close your editor.

If you want exactly the 3.2 release edit your client spec to add the line:
   //depot/releases/3.2/...  //pcmdi-yourname/releases/3.2/...

You can put a minus sign in front of either line if you don't want it now but want to remember how to get it. Full documentation for client mapping is on the Perforce web site.

You won't need to download from our website. And you'll find that p4 is VERY fast.

Perforce permits us to do this under our license; the read-only access for everyone only "uses up" one license. Write access for heavy contributors can be arranged by mutual agreement with PCMDI and payment of the Perforce license and annual support fee for an extra user (the license is about $750). You can always use the SourceForge patch facility to submit bug fixes if you do not have write access.

Troubles?

If you have trouble downloading/installing CDAT please email: cdat-discussion@list.sf.net. The project page http://sf.net/projects/cdat also has a bug reporting facility and information on our mailing lists.

UCRL-CODE-2002-0021

This work was produced at the University of California, Lawrence Livermore National Laboratory (UC LLNL) under contract no. W-7405-ENG-48 (Contract 48) between the U.S. Department of Energy (DOE) and The Regents of the University of California (University) for the operation of UC LLNL. The rights of the Federal Government are reserved under Contract 48 subject to the restrictions agreed upon by the DOE and University as allowed under DOE Acquisition Letter 97-1.

DISCLAIMER

This work was prepared as an account of work sponsored by an agency of the United States Government. Neither the United States Government nor the University of California nor any of their employees, makes any warranty, express or implied, or assumes any liability or responsibility for the accuracy, completeness, or usefulness of any information, apparatus, product, or process disclosed, or represents that its use would not infringe privately-owned rights. Reference herein to any specific commercial products, process, or service by trade name, trademark, manufacturer or otherwise does not necessarily constitute or imply its endorsement, recommendation, or favoring by the United States Government or the University of California. The views and opinions of authors expressed herein do not necessarily state or reflect those of the United States Government or the University of California, and shall not be used for advertising or product endorsement purposes.

NOTIFICATION OF COMMERCIAL USE

Commercialization of this product is prohibited without notifying the Department of Energy (DOE) or Lawrence Livermore National Laboratory (LLNL).

NOTE

Portions of this open-source software, including especially portions of the contents of subdirectories pysrc, contrib, and cdat/Tars, were not written by us and are redistributed here under the terms of their own licenses.