rtgrid

Syntax

rtgrid --help
rtgrid [options] host port
rtgrid -old [options] host port

Synopsis

Creates a grd or grdmap format file from a fitacf TCP/IP data stream.

Options

`--help`	print the help message and exit.
`--version`	print the RST version number and exit.
`-name stid`	specify the radar code stid to use for the output filename (the default value is taken from the radar parameter block but can sometimes become corrupted and set to tst).
`-tl tlen`	ignore the scan flag and instead use a fixed length scan of tlen seconds.
`-i intt`	integrate the grid data into records of length intt seconds.
`-cn channel`	process data from a specific channel number for stereo mode data or twofsound data.
`-ebm ebeams`	exclude the beam numbers listed in ebeams, comma separated.
`-minrng minrange`	exclude data from range gates lower than minrange.
`-maxrng maxrange`	exclude data from range gates higher than maxrange.
`-fwgt mode`	set the filter weighting mode to mode.
`-pmax pmax`	exclude data with a power greater than pmax.
`-vmax vmax`	exclude data with an absolute velocity greater than vmax.
`-wmax wmax`	exclude data with a spectral width greater than wmax.
`-vemax vemax`	exclude data with a velocity error greater than vemax.
`-pmin pmin`	exclude data with a power less than pmin.
`-vmin vmin`	exclude data with an absolute velocity less than vmin.
`-wmin wmin`	exclude data with a spectral width less than wmin.
`-vemin vemin`	exclude data with a velocity error less than vemin.
`-fmax fmax`	set the maximum allowed variation in frequency to be fmax Hertz.
`-alt alt`	set the altitude at which the mapping is done to be alt kilometers.
`-nav`	do not perform temporal averaging.
`-nlm`	do not exclude data because it exceeds the data limits.
`-nb`	do not exclude data based on the operating parameters.
`-xtd`	create extended output that includes both the power and spectral width measurements.
`-isort`	calculate the median power and spectral width independently of the velocity distribution.
`-ion`	exclude data marked as ground scatter.
`-gs`	exclude data marked as ionospheric scatter.
`-both`	do not exclude data based on the type flag.
`-inertial`	calculate the grid file in the inertial reference frame.
`-chisham`	calculate the grid file using the Chisham virtual height model.
`-old_aacgm`	calculate the grid file using old AACGM coefficients rather than v2.
`-L logname`	log connections and information in the file logname. By default, connections are recorded in `log.rt`.
`-p pathname`	store the daily files in the directory pathname.
`-f filename`	store the grid data in the file filename.
`-if pidname`	record the process Identifier (PID) of the server in the file pidname. By default, the PID is recorded in `pid.id`.
`host`	hostname or IP number of the system to connect to.
`rport`	port number to connect to on the server.
`-rpf`	The remote port number is stored in a text file.
`rportname`	filename of the text file containing the remote port number.
`-old`	produce `grd` format output files.

Description

Creates a grd or grdmap format file from a fitacf TCP/IP data stream.

A grid file is a highly processed data product consisting of geo-magnetically located line of sight velocity vectors.

The algorithm optionally applies a median filter to the scan data to remove noise. Each range-beam cell together with its immediate neighbors in the current, preceding and following scans is examined. A weighted sum of all the cells containing scatter is calculated and if this sum exceeds a certain threshold, the median data value of the cells is substituted for the central cell. Various command line options control how the filter is applied.

Once the data has been filtered, the geo-magnetic location of each line of sight velocity measurement is calculated. The vectors are then fixed to an equi-area grid to ensure that the data is not biased according to its location in the radar field of view.

The vectors in each cell are averaged together over a fixed period of time to generate an output record, which is then stored in the specified output file. An additional file containing all of the records for a given day is also created. The name of this file takes the form "yyyymmdd.iii.grdmap", where yyyy is the year, mm the month, dd the day, and iii the station identifier code.

Examples

rtgrid -L log -tl 120 -i 120 -if pid.id <ip address/hostname> <port number>

Generate a grdmap file using the real-time data stream from the specified <ip address/hostname>, served at the provided <port number>. Ignore the scan flag and use a scan length of two minutes. Generate a record every two minutes. The process identifier is recorded in the file "pid.id", logs of all transactions are recorded in the file "log.yyyymmdd" where yyyy is the year, mm is the month, and dd is the day.

rtgrid -rpf -L log -if pid.id -p /data/rt/grd <ip address/hostname> port.<radar identifier>

Generate a grdmap file using the real-time data stream from the specified ip address/hostname, served at the port number contained in the file "port.<radar identifier>". The process identifier is recorded in the file "pid.id", and logs of all transactions are recorded in the file "log.yyyymmdd" where yyyy is the year, mm is the month, and dd is the day. The daily files are stored in the directory "/data/rt/grd".