The bundle tag lets you load in a new bundle and takes the form:

<bundle file="some_bundle_file.xidv"/>

<bundle file="some_bundle_file.xidv" clear="false"/>

The wait attribute, if true (the default), will essentially do a pause, waiting until all displays have been rendered.

The times attribute allows you to override the set of time indices that are used in the data sources in the bundle. Note: this overrides the times for all data sources in the bundle.

The value is a comma separated list of time specifiers where the specifier can be a single time, a time range or a time range with a step. The time indices are 0 based, e.g., the first time index is 0. The time range is of the form "firsttime:lasttime". To specify a step do: "firsttime:lasttime:step"

For example, we have:

   times="0"                    -- Just use the first time
   times="2"                    -- Just use the third time
   times="0,1,2"                -- Just use the first 3 times
   times="0:10"                 -- 0 through 10
   times="0:10:2"               -- 0,2,4,6,8,10
   times="0:10:2, 20:30"        -- 0,2,4,6,8,10 20-30
   times="1,2,3,5:11:2,20,30"   -- 1,2 3, 5,7,9,11, 20, 30 

The bundle tag can contain any number of "setfiles" tags. Each of these setfiles tags has a datasource attribute which is used to find the data source in the bundle by name. There is also a file attribute which defines a file to use for that data source.

e.g.:

<isl debug="true" offscreen="false">
    <bundle file="test.xidv">
         <setfiles datasource=".*" file="/upc/share/testdata/grid/netcdf/nuwg/ruc.nc"/>
     </bundle>
     <image file="test.png"/>
</isl>

datasource=".*" 

<isl debug="true" offscreen="false">
    <bundle file="test.xidv">
        <setfiles datasource="datasource1" file="file for first data source"/>
        <setfiles datasource="datasource2" file="file for 2nd data source"/>
    </bundle>
    <image file="test.png"/>
</isl>

<setfiles datasource="datasource1">
    <fileset file="some file"/>
    <fileset file="some other file"/>
     ...
</setfiles>

The datasource tag lets you create a new data source and takes the form. The url attribute is required and specifies the file or url to load. The type attribute is optional and defines the data source type from the datasources.xml file in the source release. For a text listing see datasources.txt. For now you can only specify a data source that takes a single url (or filename). This will change in the future.

<isl>
  <datasource url="dods://motherlode.ucar.edu/cgi-bin/dods/DODS-3.2.1/nph-dods/dods/casestudies/idvtest/grids/small_ruc_grid.nc">
<!-- Set the name on the data source  -->
    <property
       name="name"
       value="the name"/>
  </datasource>
</isl>
datasource.isl

The display tag lets you create a display and can exist on its own:

<display type="somedisplaytype" param="some_parameter"/>

<isl>

<!-- Create   a datasource. Note: you can also have a template attribute
     that points to a bundle xidv file that was saved from a data source:
     bundle="${islpath}/datasource.xidv"
-->

  <datasource 
     url="dods://motherlode.ucar.edu:8080/thredds/dodsC/casestudies/idvtest/grids/small_ruc_grid.nc"
     id="datasource1">
<!-- Set the name on the data source  -->
    <property
       name="name"
       value="Example data source"/>
<!-- Create a display of RH. Here we load in the display from a template.  -->
<!--
    <display
       param="RH" template="${islpath}/template.xidv">
      <property
         name="id"
         value="display1"/>
      <property
         name="displayCategory"
         value="Category 1"/>
      <property
         name="legendLabelTemplate"
         value="%datasourcename% - %shortname%"/>
    </display>
-->


<!-- Create a display of T. Here we create the display from the type -->
    <display
	type="planviewcontour"
      param="T">
      <property
         name="displayCategory"
         value="Category 1"/>
<!--
        The contour info can be set with: interval;base;min;max
              <property name="contourInfoParams" value="10;40;-30;100"/>
         Or it can have names in it:
-->
      <property name="contourInfoParams" value="interval=10;base=40;min=-30;max=100;dashed=true;labels=false"/>
      <property
         name="legendLabelTemplate"
         value="%datasourcename% - %shortname%"/>
      <property
         name="dataSelectionLevel"
         value="500[hectopascals]"/>
    </display>
  </datasource>


<!-- Set the projection to the data projection  of the display we created above  -->
<!--
  <center
     display="display1"
     useprojection="true"/>
-->

</isl>
display.isl

The param attribute is not required. If specified it is the name of a parameter in either the containing datasource tag or in one of the currently loaded data sources. The display tag will evolve in time to provide a richer set of facilities for setting values on the display.

This removes all current displays. If there is the display attribute set then it removes that display. (See below).

<removedisplays/>

<removeall/>

<reload/>

The center tag comes in a number of forms, depending on the attributes:

<isl>
    <bundle file="test.xidv"/>
    <pause/>

    <echo message="Set the projection to be the projection of the first display"/>
    <center/>
    <pause seconds="10"/>

    <echo message="Center at a point"/>
    <center lat="15" lon="-65"/>
    <pause seconds="10"/>

    <echo message="Set the projection to be the lat/lon box"/>
    <center north="40.0" south="30" east="-90" west="-100"/>
    <pause seconds="10"/>

    <echo message="Set the projection from the specified display"/>
    <center display="display1" useprojection="true"/>
    <pause seconds="10"/>

    <echo message="Center at the center of the given displays projection"/>
    <center display="display1" useprojection="false"/>
    <pause seconds="10"/>

</isl>
center.isl

display="some name"

display="class:ucar.unidata.idv.TrackControl"
or:
display="TrackControl"

Unidata's Integrated Data Viewer > Miscellaneous > IDV Scripting