Seadisp Shiptrack Widget : Program-level Documentation

Seadisp Shiptrack Widget

Description: The Ship Track Widget provides the function to read and plot the pixel values of an image along a line segment. The points to define the line segment may be interactively generated by dragging the mouse inside the virtual mouse pad in the widget or read in as lat/lon or pixel/line pair from an ASCII file. The ship-track function can be activated by selecting Functions->Ship Track in the Display Window Widget.

[Interactive Mode] [Command Mode]

Interactive Mode:

This procedure provides the capability of overplotting external ASCII data on a display window. The points can be plotted with or without connecting the points. In addition, the procedure also provides two different types of x,y plots:

An x,y plot of the ASCII data values and the geophysical values of the corresponding image points
An x,y plot of all the geophysical data values lying beneath the connected input parameter points.

The data does not need to be ship track data, however the point connection option works well for a ship track application. The input file must contain ASCII data in any number of columns. The user must specify which columns contain latitude, longitude and the parameter value of interest. A slope and intercept may be specified for each column selected.

ASCII input items:

ASCII Ship Track File The name of the input ASCII text file.

Select Select the input ASCII file interactively.

Load Read in the input ASCII file.

Lines to skip from the beginning The number of lines to skip in the input ASCII file before the column data starts.

Lines to read The number of lines to read in the input ASCII file. The default value 0 is to read to the end of file.

Column The column numbers in the input ASCII file for the latitude, longitude and parameter values. (Default is 1,2,3).

Slope The slope to be applied to latitude, longitude and parameter input values. (Default is 1.0, 1.0, 1.0)

Intercept The intercept to be applied to latitude, longitude and parameter input values. (Default is 0.0, 0.0, 0.0)

Latitude The column number in the input ASCII file that contains the latitude information, and the slope and intercept to apply to that value. (Default is 1, 1.0, 0.0).

Longitude The column number in the input ASCII file that contains the longitude information, and the slope and intercept to apply to that value. (Default is 2, 1.0, 0.0).

Parameter The column number in the input ASCII file that contains the parameter information and the slope and intercept to apply to that value. (Default is 3, 1.0, 0.0).

Total number of stations The total number of entries found in the ASCII input file.

Active stations The range of input entries to use for the next plot. Ex: If the total ship track number is 100 and only entries 20 to 30 are desired for the current plot, then enter [20,30] in active stations.

Units The units of the input data.

Plotting items:

Plot Menu A menu of the 3 different plots available:

Track and image data Create an x-y plot of the ASCII point values and the corresponding image geophysical values. Plot to a new window using the options found in Setup Menu->Track and image data plot. The plot window contains an output button to allow outputting the plot to a Postscript file. (screen shot)

Image data along track Create an xy plot of the image geo-physical values lying underneath the connected ASCII input values. Plot to a new window using options found in Setup Menu->Image data along track plot. The plot window contains an output button to allow outputting the plot to a postscript file. (screen shot)

Track vs image scatter data Create a scatter plot of the track versus image data. The plot window contains an output button to allow outputting the plot to a postscript file. (screen shot)

Setup Menu Setup widgets for the display window overplot and the 2 different x-y plots.

TrackOverplot Bring up the option widget for the overplot of the ASCII data on the display window. (screen shot)

Track and image data plot Bring up the option widget for the x-y plot of the ASCII point values and corresponding image geophysical values. (screen shot)

Image data along track plot Bring up the option widget for the x-y plot of the image geophysical values lying underneath the connected ASCII input values. (screen shot)

Output Menu Output options:

Track and image data Print the ASCII input values and the corresponding image geophysical values to the SeaDAS Text Widget. This widget allows saving the text to a disk file. (screen shot)

Image data along track Print the image geophysical values lying underneath the connected input points to the SeaDAS Text Widget. This widget allows saving the text to a disk file. (screen shot)

Quit Quit the Shiptrack Widget.

Help Show this help in an HTML viewer.

Action items :

Mouse movement in the virtual mouse pad In order to move the software cursor within the display image, drag the hardware cursor around in the black square window. Think of the black square window as a "virtual mouse pad".

Up, Down, Left, Right These buttons provide the capability of moving the cursor by one pixel in any direction in the display image.

Middle mouse button Clicking the middle mouse button will cause the cursor to move to the center of the viewable display window.

Right mouse button Clicking the right mouse button will cause a graphics mark to be placed on the image at the cursor location. (Same as pressing button Mark cursor location).

Adda new point Add the point of the software cursor location to the end of the line segment. The plot of the line segment will be extended to the cursor location. This function can also be done by pressing the right mouse button when the mouse cursor is inside the virtual mouse pad.

Delete last point Delete the last point of the line segment. The plot of the line segment from the last point to the point before it will be cleared.

Output line segment data Print the sequence number, pixel/line and lat/lon location, raw and geo-physical values, and the distance of the pixels lying underneath the line segment to the SeaDAS Text Widget. This widget allows saving the text to a disk file.

Output points data only Print the pixel/line and lat/lon location, raw and geo-physical values, and the distance of the pixels that define the line segment to the SeaDAS Text Widget. This widget allows saving the text to a disk file.

Output points data
(averaged)
Print the pixel/line and lat/lon location, raw and geo-physical values, and the distance of the pixels that define the line segment to the SeaDAS Text Widget. The raw and geo-physical values are calculated from neighbour 3 pixels
(up to 9 pixels) with simple average (missing data are not used in averaging).

Plot line segment data Create an x-y plot of the pixel values (raw or geo-physical) lying underneath the line segment. The Line segment data plot setup button allows the user to change the default setups for the plot. The plot window contains an output button to allow outputting the plot to a Postscript or PNG file.

Move to pixel/line Move the cursor in the display image to the pixel/line coordinate specified in the Pixel/line fields.

Move to lat/lon Move the cursor in the display image to the lat/lon coordinate specified in the Lat/Lon fields.

Line segment plot setup Open the Line Segment Overplot Widget for setting the line segment plot options on the image display window.

Line segment data plot setup Open the Track Data Plot Setup Widget for setting the line segment data plot options.

Start a new line segment Start a new line segment. It may take a few seconds to save the previous line segment plot to the graphics memory.

Quit Destroy the Ship Track Main Window widget. It may take a few seconds to save the line segment plot to the graphics memory.

Help Show on-line documentation in HTML viewer.

Append Points from ASCII FILE Widget

Description: This widget allows the user to read the points for the line segment from an ASCII file.

Option items:

Input ASCII File The name of the input ASCII text file ontaining the points for the line segment to be read in.

Select Select the input ASCII file interactively.

Load Read in the points from the input ASCII file based on the options and selections from other fields. After the points are read in, they will be appended to the end of the current line segment.

Lines to skip from the beginning The number of lines to skip in the input ASCII file before the column data starts.

Lines to read The number of lines to read in the input ASCII file. The default value 0 is to read to the end of file.

Data format The toggle button to decide if the points in the input ASCII file is in lat/lon or pixel/line pairs.

Column The column numbers in the input ASCII file for the latitude and longitude or pixel and line. (Default is 1,2).

Slope The slope to be applied to latitude and longitude or pixel and line. (Default is 1.0)

Intercept The intercept to be applied to latitude and longitude or pixel and line. (Default is 0.0)

Latitude The column number in the input ASCII file that contains the latitude information, and the slope and intercept to apply to that value. (Default is 1, 1.0, 0.0).

Longitude The column number in the input ASCII file that contains the longitude information, and the slope and intercept to apply to that value. (Default is 2, 1.0, 0.0).

Pixel The column number in the input ASCII file that contains the pixel (1-rel) information, and the slope and intercept to apply to that value. (Default is 2, 1.0, 0.0).

Line The column number in the input ASCII file that contains the line (1-rel) information, and the slope and intercept to apply to that value. (Default is 2, 1.0, 0.0).

Action items :

Quit Close this Widget.

Overplot Track on Image screen shot:

Track and Image Data Plot screen shot:

Image Data Along Track Plot screen shot:

Track vs image Scatter Plot screen shot:

Track Overplot Setup screen shot:

Track and Image Data Plot Setup screen shot:

Image Data Along Track Plot Setup screen shot:

Track and Image Data Output screen shot:

Image Data Along Track Output screen shot:

Curator: OceanColor Webmaster

Authorized by: gene carl feldman

ASCII Ship Track File	The name of the input ASCII text file.
Select	Select the input ASCII file interactively.
Load	Read in the input ASCII file.
Lines to skip from the beginning	The number of lines to skip in the input ASCII file before the column data starts.
Lines to read	The number of lines to read in the input ASCII file. The default value 0 is to read to the end of file.
Column	The column numbers in the input ASCII file for the latitude, longitude and parameter values. (Default is 1,2,3).
Slope	The slope to be applied to latitude, longitude and parameter input values. (Default is 1.0, 1.0, 1.0)
Intercept	The intercept to be applied to latitude, longitude and parameter input values. (Default is 0.0, 0.0, 0.0)
Latitude	The column number in the input ASCII file that contains the latitude information, and the slope and intercept to apply to that value. (Default is 1, 1.0, 0.0).
Longitude	The column number in the input ASCII file that contains the longitude information, and the slope and intercept to apply to that value. (Default is 2, 1.0, 0.0).
Parameter	The column number in the input ASCII file that contains the parameter information and the slope and intercept to apply to that value. (Default is 3, 1.0, 0.0).
Total number of stations	The total number of entries found in the ASCII input file.
Active stations	The range of input entries to use for the next plot. Ex: If the total ship track number is 100 and only entries 20 to 30 are desired for the current plot, then enter [20,30] in active stations.
Units	The units of the input data.

Mouse movement in the virtual mouse pad	In order to move the software cursor within the display image, drag the hardware cursor around in the black square window. Think of the black square window as a "virtual mouse pad".
Up, Down, Left, Right	These buttons provide the capability of moving the cursor by one pixel in any direction in the display image.
Middle mouse button	Clicking the middle mouse button will cause the cursor to move to the center of the viewable display window.
Right mouse button	Clicking the right mouse button will cause a graphics mark to be placed on the image at the cursor location. (Same as pressing button Mark cursor location).
Adda new point	Add the point of the software cursor location to the end of the line segment. The plot of the line segment will be extended to the cursor location. This function can also be done by pressing the right mouse button when the mouse cursor is inside the virtual mouse pad.
Delete last point	Delete the last point of the line segment. The plot of the line segment from the last point to the point before it will be cleared.
Output line segment data	Print the sequence number, pixel/line and lat/lon location, raw and geo-physical values, and the distance of the pixels lying underneath the line segment to the SeaDAS Text Widget. This widget allows saving the text to a disk file.
Output points data only	Print the pixel/line and lat/lon location, raw and geo-physical values, and the distance of the pixels that define the line segment to the SeaDAS Text Widget. This widget allows saving the text to a disk file.
Output points data (averaged)	Print the pixel/line and lat/lon location, raw and geo-physical values, and the distance of the pixels that define the line segment to the SeaDAS Text Widget. The raw and geo-physical values are calculated from neighbour 3 pixels (up to 9 pixels) with simple average (missing data are not used in averaging).
Plot line segment data	Create an x-y plot of the pixel values (raw or geo-physical) lying underneath the line segment. The Line segment data plot setup button allows the user to change the default setups for the plot. The plot window contains an output button to allow outputting the plot to a Postscript or PNG file.
Move to pixel/line	Move the cursor in the display image to the pixel/line coordinate specified in the Pixel/line fields.
Move to lat/lon	Move the cursor in the display image to the lat/lon coordinate specified in the Lat/Lon fields.
Line segment plot setup	Open the Line Segment Overplot Widget for setting the line segment plot options on the image display window.
Line segment data plot setup	Open the Track Data Plot Setup Widget for setting the line segment data plot options.
Start a new line segment	Start a new line segment. It may take a few seconds to save the previous line segment plot to the graphics memory.
Quit	Destroy the Ship Track Main Window widget. It may take a few seconds to save the line segment plot to the graphics memory.
Help	Show on-line documentation in HTML viewer.

Input ASCII File	The name of the input ASCII text file ontaining the points for the line segment to be read in.
Select	Select the input ASCII file interactively.
Load	Read in the points from the input ASCII file based on the options and selections from other fields. After the points are read in, they will be appended to the end of the current line segment.
Lines to skip from the beginning	The number of lines to skip in the input ASCII file before the column data starts.
Lines to read	The number of lines to read in the input ASCII file. The default value 0 is to read to the end of file.
Data format	The toggle button to decide if the points in the input ASCII file is in lat/lon or pixel/line pairs.
Column	The column numbers in the input ASCII file for the latitude and longitude or pixel and line. (Default is 1,2).
Slope	The slope to be applied to latitude and longitude or pixel and line. (Default is 1.0)
Intercept	The intercept to be applied to latitude and longitude or pixel and line. (Default is 0.0)
Latitude	The column number in the input ASCII file that contains the latitude information, and the slope and intercept to apply to that value. (Default is 1, 1.0, 0.0).
Longitude	The column number in the input ASCII file that contains the longitude information, and the slope and intercept to apply to that value. (Default is 2, 1.0, 0.0).
Pixel	The column number in the input ASCII file that contains the pixel (1-rel) information, and the slope and intercept to apply to that value. (Default is 2, 1.0, 0.0).
Line	The column number in the input ASCII file that contains the line (1-rel) information, and the slope and intercept to apply to that value. (Default is 2, 1.0, 0.0).