Datamanager.txt

Metadata is stored by WebWinds in a file called datamanagerX.txt where X is a number. In order to prevent overwriting this file when a new software version is released, X is incremented. If you want to use an older version, you must alias the old filename by modifiying the config.slang file. By default, this file exists in the file pSlang.jar and has the name datamanger.txt. If you wish to modify this file using an editor, you must create a version outside the jar file. One way to do this is to cut and paste the lines given below. This file can then be edited with any standard text editor (Windows users should use Wordpad- not Notepad). Information stored in datamanagerX.txt can also be modified in the Data Source object. During a session, changes scheduled for datamanagerX.txt will be saved in a temporary space. When exiting the session, the user will be prompted to confirm or reject the permanent changes to this file. Here is the default datamanagerX.txt supplied with the WebWinds package:
DataDirectory "Temp"

CloseDirectory

DataDirectory "Space"

DataDirectory "Magnetosphere"


DataSource "Proton Temp"

  file "protontemperature.dat"
  format "RawFloat"
  converter "Linear"
  meta "x" "rsat" axis 1 entries 100 range -8.0 8.0
  meta "y" "rSat" axis 2 entries 100 range -8.0 8.0
  meta "z" "rSat" axis 3 entries 100 range -8.0 8.0
  meta "temp" "eV" axis 0 entries 256 range 0.0 90.0
  colorhint "rgbI"

DataSource "Proton Den"

  file "protondensity.dat"
  format "RawFloat"
  converter "Linear"
  meta "x" "rsat" axis 1 entries 100 range -8.0 8.0
  meta "y" "rSat" axis 2 entries 100 range -8.0 8.0
  meta "z" "rSat" axis 3 entries 100 range -8.0 8.0
  meta "density" "part/cc" axis 0 entries 256 range 0.0 26.0
  colorhint "rgbI"
CloseDirectory

DataDirectory "NCSA"


DataSource "Filamentary Structures"

  file "http://imagelib.ncsa.uiuc.edu/project/download/95.FY.01.07"
  format "FITS"
  converter "Linear"
  colorhint "rgb"
CloseDirectory

CloseDirectory

DataDirectory "Earth"

  meta "Latitude" "degrees" range -90.0 90.0
  meta "Longitude" "degrees" range 0.0 360.0
DataDirectory "OceanAtlas"

  meta "Depth" "meters" entries 33 table
    0.0 10.0 20.0 30.0 50.0 75.0 100.0 125.0 150.0 200.0 250.0 300.0 400.0 500.0
    600.0 700.0 800.0 900.0 1000.0 1100.0 1200.0 1300.0 1400.0 1500.0 1750.0
    2000.0 2500.0 3000.0 3500.0 4000.0 4500.0 5000.0 5500.0
  meta "Longitude" "degrees" map entries 360 range 0.0 359.0
  meta "Latitude" "degrees" map entries 180 range 90.0 -89.0

DataSource "Temperature"

  file "temptr.map"
  format "RawByte"
  converter "Linear"
  meta "Longitude" "degrees" axis 1 inherit
  meta "Latitude" "degrees" axis 2 inherit
  meta "Depth" "meters" axis 3 inherit
  meta "Temperature" "degrees_C" axis 0 entries 254 range -2.02 29.5
  colorhint "temperature"

DataSource "Oxygen Content"

  file "oxygen.map"
  format "RawByte"
  converter "Linear"
  meta "Longitude" "degrees" axis 1 inherit
  meta "Latitude" "degrees" axis 2 inherit
  meta "Depth" "meters" axis 3 inherit
  meta "Oxygen" "ml/l" axis 0 entries 254 range 0.0 9.4
  colorhint "oxygen"
CloseDirectory

DataDirectory "MLSOzone"

  meta "Pressure" "mbars" entries 43 table
    1000.0 681.3 464.2 316.2 215.4 146.8 100.0 68.13 46.42 31.62 21.54 14.68 10.0
    6.813 4.642 3.162 2.154 1.468 1.0 0.6813 0.4642 0.3162 0.2154 0.1468 0.1
    0.06812 0.04642 0.03162 0.02154 0.01468 0.01 0.006813 0.004642 0.003162
    0.002154 0.001468 0.0010 6.813E-4 4.642E-4 3.162E-4 2.154E-4 1.468E-4 1.0E-4
  meta "Longitude" "degrees" map entries 128 range 0.0 360.0
  meta "Latitude" "degrees" map entries 128 range 90.0 -90.0

DataSource "92355"

  file "mpil9235512000001.r8"
  format "HDF"
  concat
  converter "Linear"
  meta "Longitude" "degrees" axis 1 inherit
  meta "Latitude" "degrees" axis 2 inherit
  meta "Pressure" "mbars" axis 3 inherit
  meta "Mixing Ratio" "ppmv" axis 0 entries 254 range 0.0 12.0
  colorhint "rgbI"
CloseDirectory

DataDirectory "TOMS MONTHLY"


DataSource "92-93"

  file "Ozone_Dec22_090631-0.hdf"
  format "HDF"
  concat
  converter ""
  meta "latitude" "latitude" axis 2 entries 180 range 90.0 -90.0
  meta "longitude" "longitude" axis 1 entries 360 range 179.0 -180.0
  meta "time" "time" axis 3 entries 12 range 1.0 12.0
  meta "Ozone" "Total Ozone" axis 0 entries 254
  colorhint "rgb"
CloseDirectory

CloseDirectory

Format RawFloat
Format FITS
Format RawByte
Format HDF
Format Ascii
Format Table
Format VICAR
Format RawShort
Format PDS
Format NetCDF
Format null
Convert Linear
Convert Log
Convert Log10
WriteFormat NetCDF
WriteFormat FITS
WriteFormat VICAR
WriteFormat Raw


This file is organized into data directories and data sources (short for data source descriptions). Directories can be nested (one inside the other) so that they can contain other directories or data sources. Only one directory is required: the Temp (temporary) directory must be at the beginning of the file. The beginning of a directory is denoted with a DataDirectory entry while the end of a directory has the CloseDirectory keyword. Within directories are data sources. The beginning of the entries for these objects is signified by the DataSource keyword: there is no ending keyword. Within data sources, the following keywords are required:
DataSource "'name'" 
file "'source_file_name or URL'" 
format "'value'"
For Raw (binary) and Ascii files, meta entries are needed in order to determine the dimensions of the data. In this case, the minimal amount of information required is:
meta axis 'number' entries 'number'
If a Raw file has a header that is some number, say 2445 bytes long, it can be skipped with the offset keyword, e.g.
 
offset 2445
 
Bytes in a Raw file may be swapped (i.e. the order is reversed):
swapbyte  X
Where X may be 1, 2 or 3 for 2, 4 and 8 byte words respectively.

In addition, both Table and Ascii files require:

schema
    "'value'"
endschema
where schema are used to describe input from ASCII files. See the TOMS example for more information on Ascii files.

The following keywords are optional:

colorhint "'name'"
meta "'name'" "'label'" axis 'number' entries 'number' range 'start_value end_value'
or meta "'name'" "'label'" axis 'number' inherit or
meta "'name'" "'label'" axis 'number' entries 'number' table 'a series of numbers' 
colorhint "grey"
Other optional keywords are defined in the sections on concatenation, Data Source, Meta Data and Color Tool objects.

Note that in the datamanagerX.txt file, the MLSOzone data directory has meta keywords associated with it which define 3 axes. Because these meta are associated with the entire directory, they will be applied to all the DataSource objects within the directory which use the "inherit" keyword. Note also that the source Filamentary Structures uses a file specified by a URL.

New data sources can be added to this file with a text editor, however there is a much easier way to add sources that are based on self-describing files. By choosing the "New Source" option from the "File" menu on the opening WebWinds window and selecting a file from the resulting file finder, the user will bring up a data source interface which can be opened. For an example of this, see the Aster description. New data sources can also be added using WebWinds as a helper application for a Web browser.
 
 
 
 


WebWinds Home / Oct 26, 2001