Seadisp Ship Track Command

Seadisp Ship Track Output Command Mode

Description: General display program command mode procedure for outputting band image data under line segments (ship track) defined by lat/lon or pixel/line locations entered in the command or read from an ASCII file.

[Interactive Mode] [Command Mode]

Command mode:

Usage:out_track, iband=iband, ifile=ifile, pxln=pxln, latlon=latlon, ofile=ofile, /overwrite, /append, iopt=iopt, skip=skip, totline=totline, col1=col1, col2=col2, slope1=slope1, intcp1=intcp1, slope2=slope2, intcp2=intcp2, ptaverage=ptaverage, /no_connect, /help

Note: The command mode procedure load must be run before out_track.

Examples:

Output the line segment band 1 image data defined by the lat/lon points from the first and second columns of the file '$SDSDEMO/track1.dat' to the output file 'track.out'

out_track, iband=1, ifile='$SDSDEMO/track1.dat', ofile='track.out'

Output the line segment band 2 image data defined by the pixel/line points from the first and second columns of the file '$SDSDEMO/track1.dat' to the output file 'track.out' with averaged raw and geo-physical value output.

out_track, iband=2, ifile='$SDSDEMO/track2.dat', iopt=1, ofile='track.out', pnt_average=1, /no_connect

Output the band 1 image data ONLY on the four pixel/line points [100,100], [200,200], [300,300], [400,400] to the seadisp output widget.

out_track, iband=1, pxln=[100,100,200,200,300,300,400,400], /no_connect

Arguments/Keywords for all output types:

iband	The band number for the image data loaded in under seadisp to be output.
ifile	The input ASCII file that contains the lat/lon or pixel/line points that define the line segments of the band image data to be output. (Note that the arguments ifile, pxln, and latlon should be the only ones used)
pxln	The pixel/line points that define the line segments of the band image data to be output.
latlon	The lat/lon points that define the line segments of the band image data to be output.
ofile	The output file name for the line segments output. If not specified, the output will be written to the Seadisp Text Display Widget.
overwrite	If this keyword is set, the output file will be overwritten if it already exists.
append	If this keyword is set, the line segments image data output will be appended to the output file. If not set, the output file has to be a new file.
no_connect	The keyword if set, only the points defined in the ifile, or pxln, or latlon will be output. Otherwise (the default), all points under the line segments connected by those points defined in ifile, or pxln or latlon will be output.
pnt_average	pnt_average = 0 (Default) for exactly raw and geo-physical value output. pnt_average = 1 Neighbour pixel points (up to 9 pixels) are used for averaged raw and geo-physical value output. This method only works for pixel/line option with "no_connect" keyword.
help	Print usage of this command to screen.

Arguments/Keywords for reading pixel/line or lat/lon from an ASCII file ONLY:

iopt Option to decide the lat/lon (0, default) or pixel/line (1) to be read from the input ASCII file.

skip The number of lines to skip in the input file before starting to read.

totline The number of lines to read from the input file. If not specified or a value 0, the program will read to the end of the file.

col1 The column number in the input file for the latitude or pixel data. Default is 1.

col2 The column number in the input file for the longitude or line data. Default is 2.

slope1 The slope to be applied to the latitude or pixel data. Default is 1.0.

intcp1 The intercept to be applied to the latitude or pixel data. Default is 0.

slope2 The slope to be applied to the longitude or line data. Default is 1.0.

intcp2 The intercept to be applied to the longitude or line data. Default is 0.

Curator: OceanColor Webmaster

Authorized by: gene carl feldman

iopt	Option to decide the lat/lon (0, default) or pixel/line (1) to be read from the input ASCII file.
skip	The number of lines to skip in the input file before starting to read.
totline	The number of lines to read from the input file. If not specified or a value 0, the program will read to the end of the file.
col1	The column number in the input file for the latitude or pixel data. Default is 1.
col2	The column number in the input file for the longitude or line data. Default is 2.
slope1	The slope to be applied to the latitude or pixel data. Default is 1.0.
intcp1	The intercept to be applied to the latitude or pixel data. Default is 0.
slope2	The slope to be applied to the longitude or line data. Default is 1.0.
intcp2	The intercept to be applied to the longitude or line data. Default is 0.