Actions

Tstorms2Xml

From Lrose Wiki

Tstorms2Xml converts Titan files to XML or Spdb.

Overview

Tstorms2Xml reads native TITAN data files, converts the data into XML format, and writes the data out to XML files or SPDB.


Prerequesites

The following items are required:

  • Storms data from Titan


Parameter file

Tstorms2Xml uses one parameter file that includes the input directory and track processing options.

Ensure file is up to date

To obtain the default parameter file, use the following command:

/path/to/lrose/install/bin/Tstorms2Xml -print_params > param_file_name

If you already have a parameter file and simply want to check for (and add) updated parameters while retaining current parameters, use the following command:

/path/to/lrose/install/bin/Tstorms2Xml -params orig_param_file_name -print_params > new_param_file_name

Important parameters

Debugging and process control

  • mode: determines if the program waits for new files (REALTIME), moves through start and end times specified on the command line (ARCHIVE), moves through list of files specified on the command line (FILELIST), or take XML data stored in plain files and store it into Spdb (XML)

Data input

  • input_dir: path of the directory containing the storms data from Titan

XML details

  • xml_format: indicate the XML format, including TSTORMS_FORMAT or WXML_FORMAT (Bureau of Meteorology)

Data output

  • write_to_xml_files: option to write XML files
  • xml_dir: path where XML files will be written
  • write_to_spdb: option to write Spdb database
  • spdb_url: path where Spdb database will be written


Running Tstorms2Xml

To check all command line options for Tstorms2Xml, including debugging options and file paths, type the following command into a terminal.

/path/to/lrose/install/bin/Tstorms2Xml -h

Once your parameter file is complete, use a command similar to the following to run the application:

/path/to/lrose/install/bin/Tstorms2Xml -params param_file_name

The user can also specify the location of titan files in the following manner:

/path/to/lrose/install/bin/Tstorms2Xml -f /path/to/titan/files/ -params param_file_name