View source for Tstorms2Xml

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:

<code lang="bash">/path/to/lrose/install/bin/Tstorms2Xml -print_params &gt; param_file_name</code>

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:

<code lang="bash">/path/to/lrose/install/bin/Tstorms2Xml -params orig_param_file_name -print_params &gt; new_param_file_name</code>

==== '''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.

<code lang="bash">/path/to/lrose/install/bin/Tstorms2Xml -h</code>

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

<code lang="bash">/path/to/lrose/install/bin/Tstorms2Xml -params param_file_name</code>

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

<code lang="bash">/path/to/lrose/install/bin/Tstorms2Xml -f /path/to/titan/files/ -params param_file_name</code>