tcldorade

tcldorade − access and manipulate DORADE sweep files.

2

package require dorade 2
::radar::dorade::read fileName

The tcldorade package provides Tcl with variables and commands that access and manipulate data from DORADE sweep files. When loaded, the package creates a namespace named ::radar::dorade to store variables and commands related to DORADE data.

::radar::dorade::read fileName

This command reads a DORADE sweep from file fileName. Return value is the name of a new Tcl command that accesses and manipulates the sweep as described in the SWEEP COMMANDS section below.

sweep_command::file_type

Returns "Dorade".

sweep_command::sweep_header

Returns a list of recognized header members.

sweep_command::sweep_header ?header_member header_member? ...

Given a list of header members, this command returns a list of form {header_member value header_member value ...}. Note that the array get command can easily assign this result to an array that maps header members to values.

sweep_command::sweep_header {?header_member new_value?}

This command changes the value of header_member to new_value.

sweep_command::parameter parameter_name

Returns header information about a specific parameter from the sweep. Use ’sweep_command parms’ to get a list of parameters.

sweep_command::ray_header ray_index

Returns header information for a ray.

sweep_command::ray_header time

Returns a list of times for the all rays in the sweep. Each element is a list of form {year month day hour minute second}

sweep_command::ray_header azimuth

Returns a list of azimuths for the all rays in the sweep.

sweep_command::ray_header azimuth

Returns a list of elevations for the all rays in the sweep.

sweep_command::latlon_to_bin {latitude longitude}

Returns a list of form {ray_index cell_index} identifying the cell above geographic location with coordinates {latitude longitude}. Return value is nobin if the location is outside the sweep.

sweep_command::data parm

Returns a two dimensional list of all data from the sweep for parm. parm can be an index or a name from the sweep parameter list.

sweep_command::data parm {latitude longitude}

Returns the data value from the sweep for the cell above geographic point with {latitude longitude}, or nodat if the point is outside the sweep.

sweep_command::data parm ray_index

Returns a one dimensional list of data values for the ray with index ray_index. The first ray has index 0.

sweep_command::data parm ray_index cell_index

Returns the data value for the cell at index cell_index along ray with index ray_index. The first ray and first cell in any ray have index 0.

sweep_command::median_tilt

Returns the median tilt for all rays in the sweep.

sweep_command::bintvl parm min max outlines

This command puts outlines of bins with values > min and <= max for parameter parm into a new geolinearray named outlines.

sweep_command::bintvls parm bounds outlines

This commands puts outlines for a set of bounds into a set of geolinearrays. Upon return, element i of outlines will be the name of a geolinearray containing outlines of bins with data value v for parameter parm such that:
[lindex bounds i] < v <= [lindex bounds [expr {i + 1}]].
bounds must be monotonic.

sweep_command::copy copy_name

Makes a copy of the sweep. The new sweep will be governed by new Tcl command copy_name.

sweep_command::write file_name

Writes the sweep to a DORADE sweep file. If file_name is not given, the output file is given a default name. This command returns the name of the output file.

sweep_command::shift_az angle

Adds angle to the azimuths of all rays in the sweep.

sweep_command::to_ground parm polar_grid_name polar_data_name

This command interpolates sweep values for parameter parm to a grid on the ground identified as polar_grid_name, which should have been created with the ::radar::polar_grid command. The interpolated values will go into a new polar data structure named polar_data_name. See tclradar (n) for information on polar grid and polar data commands.

libtcldorade2.1.4.so

radar, dorade