Previous: Performance Tuning Next: Wind Barbs in the IDV Table of contents Images Frames Unidata's Integrated Data Viewer > Miscellaneous

7.9 Building the IDV from Source
Developers can download the source files for the IDV and build it from scratch.

Before building the IDV you need to first install Java and Java 3D on your system. You need to use the Java SDK, because the Java RunTime Environment (JRE) does not contain the Java compiler (javac). You need to use a version of Java 1.6. You can use either the Java 3D SDK or JRE, version 1.3.x or higher (1.5.2 is recommended).

You will also need to install Ant (http://ant.apache.org/) on your machine. Ant is similar to make - instead of a Makefile, Ant uses a build.xml file. Be sure to follow the instructions for installing Ant, especially those for setting up environment variables.

Download the IDV source files from the Unidata Web Site.

  1. Open the IDV Downloads page in a new window by clicking here.
  2. To download the IDV source, you must be registered as a Unidata user. If you have already registered, log in using your user name and password. If you have not registered or you have forgotten your password, follow the instructions on the login sidebar.
  3. On your computer, create a folder/directory called "idv".
  4. Under "IDV 5.6 Documentation and Source Code", click on the IDV 5.6 Source Code link to start the download. Save it to the idv directory you just created.
  5. You will also need the set of ancillary libraries (VisAD, netCDF, etc) that the IDV uses contained in the zip file: IDV 5.6 JAR Files. Save this to your idv directory.
  6. After the download is complete, close the extra browser window.

You are now ready to install the IDV source.

  1. Open a terminal window.
  2. Change to the idv directory or the directory to which you downloaded the source and binary files (if you are not already there).
  3. unJAR the source file.

    This will create a "src" directory underneath the install directory (where you unJAR'ed the file).

  4. Next, you need to create a lib directory as a peer of the src directory that holds the ancillary JAR files from the IDV Binary distribution that are needed to build the classes. The structure will look like this:
    idv
       |
       +----src
       |
       +----lib (holds the ancillary jar files).
    
  5. Change to the lib (if you are not already there).

  6. Unzip the file you downloaded into this directory.

Now you should be able to build the IDV from scratch.
  1. From the download directory, execute the ant command to build idv.jar.

    This removes all Java class files (there will be none the first time), re-builds them and creates the idv.jar file, copying it to the lib directory.

  2. To run the IDV using your build:

 


Previous: Performance Tuning Next: Wind Barbs in the IDV Table of contents Images Frames Unidata's Integrated Data Viewer > Miscellaneous