tracks [ parameter=value ... ] [ inputfile ... outputfile ]
Parameters are: master_file, sort_variable, line_color, text_color, text_height, marker_color, marker_type, marker_height, display_var, full_name, printout.
tracks produces a TeraScan metafile dataset that posts the locations and displays the values of data contained in a 1-D TeraScan dataset. These points can be connected by lines or marked with a user-selected symbol. One use of this function is to plot drifting-buoy locations obtained from DCS data that have been sorted by time. See dcsin for information on DCS data. If necessary, it is also possible to sort the data by time using the sort_variable parameter.
The annotation for each point is displayed directly above or below the latitude and longitude coordinates of the data point. The format of the posting when full_name=yes is:
variable name value variable units
+
For example:
temperature 8.7 deg C
+
If full_name=no, only the data values are posted.
The output metafile can be displayed using the xvu Overlay Metafile command panel. It can be rendered over any image with the same earth location as the master_file.
In addition to generating the output TeraScan metafile dataset, this function also produces an optional report listing the times, positions, and values of the selected input data.
This is the filename of the master dataset. The earth location transform of the master dataset is used to convert latitude and longitude coordinates to line and sample coordinates during the metafile generation process. Valid responses are any TeraScan dataset that contains an earth transform. The default is Master.
The data in the input TeraScan dataset is sorted into ascending order according to sort_variable. If platform_id is entered, only the first value for each platform is posted. If the data is to be posted without connecting lines, it is not necessary to sort the data by any variable. In this case, enter none to eliminate the sort operation.
Sorting by any variable is allowed. The default is platform_id.
This is the color index for the connecting lines. Lines will not be drawn if 0 is entered. . The valid range is [0\f, 255]. The default is 1.
This is the color index for the text. Text will not be drawn if 0 is entered. The valid range is [0, 255]. The default is 2.
This is the height of the text in units of pixels. Assuming that the master dataset is normally displayed at full resolution, a text height of 25 pixels results in ~1/4 inch text on a 16-inch graphics display. The valid range is [>1]. The default is 22.
This is the color index for the marker symbols. Markers will not be drawn if 0 is entered. The valid range is [0, 255]. The default is 3.
When the response to marker_color is greater than 0 the type of marker is requested. Valid responses are [+, ., *, o, or x]. The default is +.
This is the height of the markers in units of pixels. This parameter is only requested when marker_color is greater than 0. Assuming that the master dataset is normally displayed at full resolution, a marker height of 25 pixels results in ~1/4 inch text on a 16-inch graphics display.
The valid range is [>1]. The default is 10.
These are the input TeraScan dataset variables for which the metafile is to be produced. Enter a single variable name at each prompt. If the first response to display_var is blank and the text color index is non-zero all 1-D variables are displayed. Otherwise a blank response causes the function to continue with the full_name parameter.
In addition, any 2-D variable that is of datatype BYTE and has a second dimension of 15 bytes is assumed to be an ASCII character string.
Valid responses are any existing variable within the dataset. There is no default.
Enter yes to post the variable name, the value, and its units. Enter no to post only the value.
Valid responses are [yes, no]. The default is no.
If the response to this parameter is yes, a hardcopy listing is produced. If the response to this parameter is no, a hardcopy report is not produced.
Valid responses are [yes, no]. The default is no.
This example posts data from EG&G current meters. Only the first record for each platform is plotted. The report is listed below.
[24] % tracks
in/out files : char(75) ? egg.plats egg.meta
master_file : char(75) ? [Master]
sort_variable : char(15) ? [platform_id]
line_color : int ? [1] 0
text_color : int ? [2] 0
marker_color : int ? [3] 1
marker_type : char( 1) ? [+]
marker_size : real ? [10]
printout : char( 3) ? [no] y
egg.plats:
TeraScan DCS TRACKS LIST
File:egg.plats Page 1
platform_id date time of day latitude longitude
8150 89/04/18 16:41:04.648 39 35.94 N 123 59.16 W
8152 89/04/18 16:37:00.648 40 48.54 N 124 23.16 W
8154 89/04/18 16:37:14.648 38 39.00 N 123 25.74 W
8155 89/04/18 16:38:56.648 38 30.78 N 123 39.72 W
8156 89/04/18 16:37:46.148 38 34.56 N 123 31.44 W
8157 89/04/18 16:37:35.648 40 47.22 N 124 19.86 W
8159 89/04/18 16:37:28.148 38 37.20 N 123 27.48 W
8160 89/04/18 16:37:26.648 39 38.76 N 123 49.68 W
8163 89/04/18 16:41:02.148 38 37.74 N 123 54.60 W
8164 89/04/18 16:37:39.648 40 50.64 N 124 28.56 W
8165 89/04/18 16:37:21.648 41 34.44 N 124 21.78 W
8166 89/04/18 16:37:31.648 39 38.58 N 123 51.06 W
8167 89/04/18 16:37:47.648 41 34.92 N 124 16.98 W
8168 89/04/18 16:37:09.148 40 11.22 N 124 21.54 W
8169 89/04/18 16:38:17.148 41 34.26 N 124 25.98 W
8170 89/04/18 16:37:33.148 41 33.42 N 124 31.50 W
dcsin, dcsloc, dcsmix, dcslist, weather, mcmegu, dcs
Since the same parameter name display_var is requested for each variable, this function cannot be run as a batch command unless there are no variables displayed.
Last Update: $Date: 1998/05/29 20:54:44 $