Jazz


 
     

Introduction

     Jazz is a Java-based data display designed for scientific use. The display can be used to explore datasets in various data formats (MDV, SPDB, NetCDF, etc) as well as Open Geospatial protocols (WMS, WFS, and WCS). It supports thematic basemaps from Shapefile, WMS, and CIDD Map, as well as multiple feature overlays from WFS and ADDS Dataserver. It slices data in five dimensions: horizontal slices at selectable altitudes over time for selectable model runs and lead times. It is highly customizable through a simple XML configuration file that can be shared with colleagues. It also contains a suite of optional tools for more advanced data analysis and depiction.

     The Jazz display is built on top of the RAL-developped JADE toolkit. That toolkit has been used for the ADDS Flight Path Tool and HEMS Tool, ATEC JViz, MDSS display, and several other research displays. The toolkit is still under active development. We welcome your feedback about any of its applications.

     Jazz is free to use under the terms of this BSD license.

Running Jazz

     Due to Oracle's licensing requirements for Java, RAL uses an Open-Source OpenJDK for Jazz development and releases. This should not affect any of the application's functionality.

     We are no longer providing older versions of Jazz that were compiled to run under Java version 8's JavaWebStart. Java 8 has reached its end of life and is no longer receiving public security updates. Users are encouraged to move to currently-supported versions that will support the current Jazz releases.

  1. Make sure you have Java (JRE or JDK) 11+ installed on your system and verify that it is in your search path by running the command:  
        java -version
    You should see a confirmation, such as: "openjdk 11.0.1 2018-10-16"

  2. Download this zip file (sha256) and unpack it with the command:
        unzip jazz.zip

  3. Go into the newly created directory and launch Jazz with this command:
        java -jar jazz.jar .
    or the runJazz.[sh|bat|command] script appropriate for your platform.
    Additional options are documented in the README.run file.

The latest release of Jazz, which requires JRE 11+, is v2.9, released on 1/31/2024 (Release Notes)

You should automatically be updated to this version (and future versions) when you restart Jazz.
 
NOTE: In the unlikely event that you are still on Linux Debian Jesse OS, this release may NOT work for you, as the default JDK for that OS is the old JDK 8 in /usr/local/jdk. In that case, you will need to point to a JRE/JDK 11+ explicitly by setting your $JAVA_HOME environment variable like this: then source your updated environment and confirm that your path is picking up the correct Java as described in step #1 above.

Configuring Jazz

     To view all of the documentation for Jazz XML configuration files, select "Config Help..." from the "Help" menu or run Jazz from the command with a "-help" argument, like this:
          java -jar jazz.jar . -help
     The help text will be displayed in the jazz.log file, located in the unzipped directory where you are running Jazz.

     To see a working configuration, download this sampleConfig.xml file, and load it from the configuration chooser dialog when Jazz first starts.

     To automatically configure Jazz from an existing MDV and/or SPDB server, run Dan Adriaansen's very useful jazzparamgen tool. It generates a Jazz config file for you, containing every field on the server(s). You can download it from https://github.com/NCAR/jazzparamgen.

Upgrading to Jazz from CIDD

     If you are currently a CIDD user, you can use the CiddParams2JazzXml application to convert your CIDD parameter files to Jazz configuration files. This application is included in the RAL nightly builds so can be found in /rap/dev/bin and /rap/bin on RAL internal hosts. If you are an external user, you will have to get a copy of the application from your RAL contact. Note that Jazz does not currently support all of the options available in the CIDD parameter file so only those options that are supported are included in the Jazz XML file. Some CIDD parameters cannot be converted exactly into the Jazz XML.

Parameters that might need some tweaking when converting CIDD parameter files into Jazz XML configuration files:

Support

     For questions and updates, please join the Jazz Google Group at: https://groups.google.com/a/ucar.edu/g/ral-jazz. RAL internal users can also file bugs directly in JIRA at: https://sdg.rap.ucar.edu/jira/projects/JAZZ. External users should obtain support through their NCAR project contact.


Direct questions or comments to Arnaud Dumont (dumont@ucar.edu).