Tstorms2Xml
From Lrose Wiki
Tstorms2Xml converts Titan files to XML or Spdb.
Contents
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