General Display Program

• Loading data
• General Display/Imaging:
• Displaying
• Rescaling Images
• Roaming full resolution image
• Zooming full resolution image
• Color Bar
• Histogram
• Band X-Y Shift
• Contour
• Bathymetry
• Image Animation
• Location/Navigation/Map Projection:
• Coastline
• Gridlines
• Uni-directional point location
• Bi-directional point location
• Map Projection
• L3-binned file animation (globe spinning)
• Data Viewing/Analysis:
• Arithmetic Band Functions: Difference, Simple Avg, General Summation
• Single-point data read
• Box-area data read
• Full Data Spreadsheet
• Multi-Band Data Display
• Ship Track Overplot
• Profile
• Scatterplot
• SeaWiFS/OCTS L2 Flags Display
• Graphics:
• Annotation
• Load Graphics
• Save Graphics
• Graphics Control
• Copy Graphics
• Color:
• Data Portion:
• Load Color LUT
• Change Color LUT
• Save Color LUT
• Color Bar
• Paint (Density Slice)
• Multiple Concurrent Color Tables
• Graphics Portion:
• Modify Graphics Colors
• Output:
• Binary: Data & Graphics&Display(image plus graphics)
• ASCII

Displaying Loaded Bands (display)

Interactive mode

1. From the Band List Widget, select the loaded product you would like to display.
2. Select the window number for display.
3. Press the Display button.

Command mode:

Note: The display command must be preceded by the seadas, seadisp and load commands.

• Display 1st band list entry into display window #1 (default action).

display


• Display 2nd band list entry into display window #2 .

display, band_no=2, fbuf=2

Roaming

Interactive mode:

1. For this example, the image loaded must contain scroll bars. To achieve this, either load a large image, or resize your current image to be smaller, so that scroll bars appear. (Resize your current image by dragging a corner of the window.)
2. From the Display Window Widget->Functions, select Roam Window On.
3. To roam through your full-resolution image, either:
• use the left mouse button to drag the rectangle that appears in the roam window OR
• Use the scroll bar(s) on the full-resolution image.
4. To turn off, select Functions -> Roam Window Off.

Command mode: Not available.

Zooming

Interactive mode:

1. From the Display Window Widget->Functions, select the Zoom Window On.
2. Move the zoom box to a new location by either:
• Jumping the zoom box to new position by clicking the middle mouse button in the displayed image.
• Dragging the zoom box with the left mouse button in the displayed image window.
3. Change the zoom factor by:
• To increase the zoom factor, click the middle mouse button while in the zoom window.
• To decrease the zoom factor, click the right mouse button while in the zoom window.

Command mode:

• Turn zoom box on.

fbuf_zoom, /ON

Generating Coastlines (coast)

Interactive mode:

1. From the Display Window Widget->Functions, select Coastline.
2. To modify the coastline defaults, select Coastline from the Display Window Widget->Setups menu.
3. Toggled between the High Resolution and Low Resolution coastline database options to see the results.
4. Notice that a navigable image which is in an IDL-recognized map projection will have different parameters than an image in a non-standard projection (such as the SeaWiFS Level-1 and Level-2 data).
• Non-IDL mapped file: Try $SDSDEMO/L1_gac1.hdf or L2_gac1.hdf
• Notice option for CIA coastline database subsampling rate
• IDL mapped example: Try file $SDSDEMO/L1_gac1_map.hdf
• Notice options for solid continent fill, rivers, islands & lakes, political boundaries

Command mode:

• Put coastline on display window #2 using the 7th graphics color (white).
coast, FBUF=2, COLOR=7
• For data of an IDL-recognized map projection only. Put on solid coast in black, explicitly specifying high-resolution database, then overlay blue coast, islands & lakes
coast, FBUF=1, IDL_OPTS=1, COLOR=6, /HIRES
coast, FBUF=1, IDL_OPTS=3, COLOR=3
• For data of a non-IDL-recognized map projection only. Put on black coastline subsample the high resolution coastline database by 4.
coast, FBUF=1, COLOR=6, RATE=4, /HIRES

Generating Gridlines (grid)

Interactive mode:

1. To display default gridlines, from the Display Window Widget->Functions, select Grid.
2. To modify the gridline defaults:
• From the Display Window Widget->Setups, select Gridlines.
• Modify any parameters in the setup. The Graphics Apply Mode specifies whether to overlay, replace or underlay the gridlines graphics in relation to existing graphics. You can also select to redraw any existing coastline graphics before replacing your new gridline graphics.
• As with the coastline, notice that the gridlines function provides slightly different parameters and behavior if displaying data mapped in an IDL-recognized map projection or not.
• Non-IDL mapped file: Try $SDSDEMO/L1_gac1.hdf or L2_gac1.hdf
• Notice that the gridlines will be marked at user-friendly intervals, i.e. [-78,-70,-60,-50,...].
• Try the Samples parameter. This allows much greater accuracy in drawing your gridlines - it allows you to specify how many points to locate between gridlines when drawing the gridlines (i.e. instead of simply drawing straight lines between the gridline intervals).
• IDL mapped example: Try file $SDSDEMO/L1_gac1_map.hdf
• Notice that the gridlines will be marked at intervals relative to the limits of the file, i.e. [-78, -68, -58, ...]. Currently this is not controllable in IDL mapped files.
• Press Apply

Command mode:

• Put gridlines on current display window using latitude spacing and longitude spacings between gridlines to be 5 degrees.

grid, LATDEL=5.0, LONDEL=5.


• For a non-IDL mapped file only: Put gridlines on current display window using latitude spacing and longitude spacings between gridlines to be 5 degrees. Sample 10 points between every gridline when drawing the gridlines. Make the gridlines white and the grid labels black.

grid, LATDEL=5.0, LONDEL=5.0, LATSAMP=10, LONSAMP=10, LBLCOL=6, GRDCOL=7

Cursor Position: Uni-directional point location & single-point data read

Interactive mode:

1. From the Display Window Widget->Functions, select Cursor Position.
2. To display lat/lon and data value information for the point under the cursor, move the cursor around in any of the 3 display windows. The pixel/line displayed for all windows will be relative to the full resolution data.
• full-resolution image window
• zoom window
• roam window
3. To only display values when the left button is clicked, turn on the Mouse button option in the Cursor Position widget.

Command mode: Not available

Read: Bi-directional point location & box-area data read & Profile

Interactive mode:

1. From the Display Window Widget->Functions, select Read & Profile.
2. To display lat/lon and data values under the cursor drag the left mouse button through the virtual window provided in the read widget.
3. To move the cursor to a precise lat/lon or pixel/line location, in the displayed image:
• Enter in the desired lat/lon or pixel/line values
• Press either Move to pixel/line or Move to lat/lon.
4. To display the data values and statistics for a small region around the cursor:
• Select a Box size
• Press Output box data.
5. To mark a graphics cross on the image:
• Select a color for the graphics cross with Color to mark the cursor.
• Press Mark cursor location.
6. To plot a row or column profile:
• Move the cursor to the location for row or column profile to be plotted.
• Press Plot row profile or Plot column profile to generate the profile plot.
• To change the default setups for profile plot, you can press Profile plot setup.

Command mode: Not available.

Rescaling the Image

Interactive mode:

1. To modify the default scaling options for a displayed window, either:
1. from the Display Window Widget->Functions, select Rescale OR
2. from the Display Window Widget->Setups, select Rescale.
2. Modify the scaling range or scaling mode. The scaling range can be specified in either raw data values or geophysical values.
3. Press Redisplay.

Note: The color bar will redraw automatically when the image is rescaled. Also, you might want to try the histogram function before rescaling your image.

Command mode: Not available.  (However, see $SEADAS/config/seadas_defaults file for controlling default scaling ranges)

Histogram

Interactive mode:

1. From the Display Window Widget->Functions, select Histogram.
2. You can modify the default histogram values:
• data range over which to produce the histogram,
• whether to perform the histogram on the raw or geophysical data values,
• the number of bins or the histogram bin size.
3. Press Plot after making any input modifications.
4. The histogram plot window may be resized by dragging any corner of the window.
5. Area refers to the data on which the histogram is performed:
• Full image - Perform histogram on full data
• Blotch - Perform histogram only on data areas underneath graphics of the specified color. Graphics can be created in the Annotate function.
• Non-Blotch - Perform histogram only on data area NOT underneath the graphics color specified.
6. To output the histogram plot, press the Output button on the histogram plot window.
7. To output the histogram bin values to a standard SeaDAS text window, press Output Data on the main histogram setup window.

Command mode: Not available yet

Color Bar

Interactive mode:

1. From the Display Window Widget->Functions, select Color Bar->On.
2. To modify the default annotation values either:
• Press Functions-> Color Bar -> Setup OR
• Press Display Window Widget->Setups->Color Bar
3. Modify any of Label Increment, Label Values, Label Format or Label Annotation.Hit <RETURN> after entering values. The color bar annotation values update immediately.
4. Also note that if the image is displayed with a log scaling, then the color bar increment value represents the multiplier of the base 10 exponent that falls within the data range. (i.e., an increment of 2.0 would denote 2.0x10^n, 2.0x10^n+1 2.0x10^n+2...)

Command mode: Sort of available.  You can specify the /CBAR option on the OUT command for PNG or postscript files. However currently you can't control the annotation, etc.

Full Data Spreadsheet

Interactive mode:

1. From the Display Window Widget->Functions, select Spreadsheet->Raw Data or Spreadsheet->Geophysical Data.
2. Roam through the data by using the scrollbars on the right and bottom. The top row shows the pixel number and the left-hand column shows the line numbers. These correspond to the full-resolution data line/pixel numbers displayed in both the Cursor Position and Read& Profile widgets.
3. The spreadsheet widget can be resized by dragging any corner of the widget.

Command mode: Not available.  (However, see command out_data for outputting a data region to disk)

Load Color LUT : Predefined, ASCII or HDF color palette (loadpal)

Interactive mode:

1. From the Display Window Widget->Functions, select Color LUT->Load Color.
2. To load a predefined IDL color table:
• Click on any of the listed color lut names. Try predefined table 'Rainbow'.
3. To load an ASCII color LUT file:
• Enter the ASCII file name or press Select to select a file.
• Press Load. Try file '$SDSDEMO/demo1.lut'.
4. To load a color palette from an HDF file:
• Enter the name of the HDF file or press Select to select an HDF file.
• Press Load. Try file '$SDSDEMO/L3_daily1_brs.hdf'.
5. Note: This procedure has it's own HELP button.

Command mode:

• Load IDL color palette #14

loadpal, 14


• Load ASCII color lut '$SDSDEMO/demo1.lut'

loadpal,'$SDSDEMO/demo1.lut'


• Load the first color palette found in HDF file '$SDSDEMO/L3_daily1_brs.hdf'

loadpal,'$SDSDEMO/L3_daily1_brs.hdf'

Modify Graphics Colors

Interactive mode:

1. Select Modify Graphics Colors from Seadisp Main Menu->Functions.
2. To modify any of the seven graphics colors:
• To select a graphics color to modify, either:
• Click on the colored box corresponding to the graphics color you want to modify OR
• Move the Current Graphics Color slider
• To modify the selected color, move the Red, Green and Blue sliders until you create the desired color seen in the box Current Color. If you want to work in a different color system other than RGB (such as HSV), select a color system from the Select Color System menu.
• Press Update to update the graphics palette and all displayed window graphics.

Note: Function Modify Color LUT will also allow you to modify the SeaDAS graphics palette.

Command mode: Not available

Modify Color LUT

Interactive mode:

1. From the Display Window Widget->Functions, select Color LUT->Change Color.
2. Notice:
• the Number of Colors value. This tells you how many colors have been allocated to your current SeaDAS session.
• Clicking on any colored rectangle in the displayed palette will show you the color index of that color and its color.
• The last 11 boxes in the color table are reserved by SeaDAS for non-data use. Counting from the end of the color table:
• Box 1: Foreground color (for plot windows)
• Box 2: Background color (for plot windows)
• Box 3: SeaDAS cursor color
• Boxes 4 to 10 : The seven SeaDAS graphics colors.
• Select Predefined button to load new color tables. Notice that the color table is applied only to the data portion of the current color table. The last 10 color table entries remain unchanged. Also, any non-current color tables will remain unchanged.
3. To modify a single color entry (data or graphics portion).
• Click on the colored rectangle which you would like to change.
• Select a Color System and modify your color. Notice that the change is applied for all displayed windows immediately.

NOTE: To modify graphics palette colors, it is easier to use the display program function Functions->Modify Graphics Colors.

4. To create your own color stretch between any two color entries in your table:
• Click on a colored rectangle to define the start of the stretch and press button Set Mark.
• Click on a colored rectangle to define the end of the stretch and press button Interpolate.
• An interpolation will take place between these two color entries.

Note: Press the Help button for more detailed information on how to use other color modification functions.

Command mode: Not available

Save Color LUT

• an ASCII file, or
• a palette object within an HDF file.

Interactive mode:

1. Select either:
• From Seadisp Main Menu->Functions, select Color LUT->Save Color
• From Display Window Widget->Functions, select Color LUT->Save Color
2. Select the color table number you wish to output.

Note: If you don't know which color table number is assigned to the window you are interested in, press the Info button on the window. Look at the item LUT number applied under the General Window Info category.

3. Specify whether to write to an ASCII file or an HDF file.
4. Select or enter a file name and press Save.

Command mode: Not available

Annotation (Text, Lines, Circles, Rectangles, Polygons, Arrows)

Interactive mode:

1. From the Display Window Widget->Functions, select Annotate/Blotch->Main Window.
2. To put text on your image:
• Specify the text object by clicking the 'Abc' button.
• Enter your annotation in the entry labelled 'Text :'
• Place the object initially by clicking the left mouse button in your image window.
• To move the object, drag the text around with the left mouse button to place it by positioning the mouse over the center positioning box OR
• Stretch or rotate the text by either:
• dragging one of the end positioning boxes OR
• Using the size and orientation widgets
• Change the font and the color
• To save a graphics object, click the right mouse button or press Save.
3. To put a circle on your image:
• Push the button next to the circle object.
• With the left mouse button, drag the mouse from a central point to define the diameter of the circle and release.
• Change any attributes such as color, line thickness, solid fill, etc.
• To save the graphics object, click the right mouse button or press Save.
4. To re-edit an object:
• Change mode from Draw to Select
• Click on the object you want to re-activate
• Make any attribute changes and remember to save the object.
5. To delete an object:
• Select the object
• Instead of saving it, click on another graphics object type
6. To exit the annotation widget:
• Select File ->Exit.

Note: Annotation objects can still be re-edited once you've exited the annotation program.

Command mode: Not Available.  (However, see commands load_graph and out_graph)

Load Graphics from Binary Flat File or HDF SD (load_graph)

Interactive mode:

1. To load graphics from a binary flat file:
• From the Display Window Widget->Functions, select Load Graphics->Flat File
• Select input flat file. Try file '$SDSDEMO/lgraph_248x884_1b.flat.'
• For this file, enter skipbytes = 0, number of points = 248, number of lines = 884 and datatype = BYTE
• Specify whether the graphics should overlay, replace, or underlay existing graphics.
2. To load graphics from an SD in an HDF file:

From the Display Window Widget->Functions, select Load Graphics->HDF
• Select the HDF file for input. All available byte type SDs in this HDF file will be listed for selection. Try file '$SDSDEMO/lgraph1.hdf'
• Specify whether the graphics should overlay, replace, or underlay existing graphics.

Command mode:

Load graphics file from a flat file and overlay on existing graphics.

load_graph, '$SDSDEMO/lgraph_248x884_1b.flat', /OVER

Load two graphic SDs file from an HDF file and underlay existing graphics.

load_graph,'$SDSDEMO/lgraph1.hdf', SD=['graph1','graph2'], /UNDER

Ship Track Overplot

Interactive mode:

1. Load and display $SDSDEMO/L1_gac1.hdf or $SDSDEMO/L2_gac1.hdf first.
2. From the Display Window Widget->Functions, select Ship Track.
3. Select file '$SDSDEMO/track1.dat' and press button Load Data.
4. Press Plot Menu->Overplot Track on Image to overplot the locations of the ASCII data on the current display window.
5. To change options such as color and line-style for this overplot, select Setup Menu->Ship Track Display.
6. To see separate data plots of both the ship track data values and the corresponding image data values at the same locations, select Plot Menu->Ship and Image Data.
7. To see a plot of the image data which would lie under connected ship track points, select Plot Menu->Image data on Ship Track.
8. To clear graphics, select Functions->Graphics Control->Graphics Clear from the main Display Window Widget.

Command mode: Not available.  (However, see commands out_graph and load_graph).

Output Image Data to Binary Flat File or HDF SD (out_data)

Interactive mode:

1. From the Display Window Widget->Functions, select Output->Data->Binary.
2. From the Output Setup Widget:
• Select Type-> Image Data
• Select whether Raw or GeoPhysical data to be output
• A meaningful output file name will be automatically generated if the Output File Name field is left blank.
• Select window and region to be output
• Select whether to output a binary flat file or a Scientific Dataset (SD) in an HDF file
3. Press the OK button to write the file.

Command mode:

• Output data region bounded by pixels 30 to 100 and lines 50 to 200 in geophysical data values to a binary flat file.

out_data, FBUF=1, FTYPE='flat', /GEO, REGION=[30,100,50,200]

Output Display to Postscript or PNG (out_display)

Interactive mode:

1. From the Display Window Widget->Functions, select Output->Display.
2. From the Output Setup Widget:
• Select Type-> Image Display
• A meaningful output file name will be automatically generated if the Output File Name field is left blank.
• Select window and region to be output
• Select whether to output a postscript or PNG file
• If postscript is selected, the xsize, ysize, xoffset, yoffset values are automatically calculated to center the image on the page. It is never necessary to modify these values unless centering is undesired.
3. Press the OK button to write the file.

Command mode:

• Output the image display region bounded by pixels 1 to 50 and lines 1 to 75, of the currently displayed window to a postscript file. Force the orientation to be landscape and add a color bar to the image.

out_display, 'test.ps', /LANDSCAPE, REGION=[1,50,1,75], /CBAR

Save Graphics to Binary Flat File or HDF SD (out_graph)

Interactive mode:

1. From the Display Window Widget->Functions, select Output->Binary.
2. From the Output Setup Widget:
• Select Type-> Graphics Data
• A meaningful output file name will be automatically generated if the Output File Name field is left blank.
• Select window and region to be output
• Select whether to output a binary flat file or a Scientific Dataset (SD) in an HDF file
3. Press the OK button to write the file.

Command mode:

• Output graphics contained in current window, to a scientific dataset (SD) called 'Graphics overlay for 412 nm' in HDF file 'my_graphics.hdf'. If this HDF file already exists, then the SD is appended to it. If this HDF file does not exist, then it is created. Graphics are saved in arrays as values 1 to 7 and can be loaded with the command load_graph.

out_graph, 'my_graphics.hdf', SD='Graphics overlay for 412nm'

Map Projection (mapimg)

Interactive mode:

1. From Seadisp Main Menu->Functions, select the menu item Projection.
2. Select as many products as desired from the selection list. Selected products will appear in the list entitled Selected for projection.
3. Select the projection options desired and the output size of your new projected product.
4. Press the Go button.
5. The new projected data will now appear in the band list of loaded products available for display. Display the projected data as you would any other data. Add gridlines and coastlines as you would with any other data.

Command mode:

• Create a mercator projection of the 1st loaded memory band, size 300 x 300.


mapimg, bands=[1], /MERC, xsize=300, ysize=300

L3-binned file animation

Interactive mode:

From Seadisp Main Menu->Functions, select the menu item Spin L3 Binned File.

1. Enter '$SDSDEMO/L3_daily1.hdf' in the Input file field.
2. Select the statistical variable from the Category field and the L3 product from the Product field to be projected.
3. Select the Orthographic projection from the Map Projection window.
4. Change the window size to (300, 300) and the number of frames to 4 to save memory and time.
5. Click the Go button and wait.
6. Click the Quit button to quit this program.

Command mode: Not Available

Multi-Band Data Display

Interactive mode:

1. From Seadisp Main Menu->Functions, select the menu item Multiple Bands Data Display.
2. Turn off any products which may be inappropriate to compare.
3. Move the cursor in any display window.
4. The raw and geophysical data values as well as the lat/lon coordinates will be displayed for all selected bands at the cursor location.

Command mode: Not available.

Movie :Multi-Display Window/Band Looping (loop)

Interactive mode:

1. From Seadisp Main Menu->Functions, select the menu item Looping.
2. Select products desired to be animated.
3. Note that if there is a discrepancy between the image size and the window size, that the image data will be truncated (not resized) to fit the window.
4. Press the Go button to start the animation.

Command mode:

• For the command mode, loaded memory bands are specified with negative numbers, display windows with positive numbers. Therefore, to loop loaded memory bands 1 & 2 and display windows 1 and 2:


loop, bands=[-1, -2, 1,2], xrange=[1,50],yrange=[1,50], wsize=[100,100]

Generate Bathymetry Image

Interactive mode:

1. From Seadisp Main Menu->Functions, select the menu item Generate Bathymetry Image to display the Bathymetry Image Generation widget.
2. Select the option to create the bathymetry image:
• User define - to create a gridded bathymetry image determined by the input fields Output image size, Latitude range, and Longitude range.
• Based on band number - to create a bathymetry based on the image loaded into the memory and listed in the Band List Selection widget. The image must have navigation information for this purpose.
3. Press Okay to start generating the bathymetry image. When it is created a new entry for this bathymetry image will be added to the Band List Widget.

Command mode: Not available.

Contour

Interactive mode:

1. From the Display Window Widget->Functions, select Contour to display the Contour Main Window widget.
2. Click Go button to display the default contour plot on a new window for the current displayed image. The window may be resized by dragging any corner of the window and a new contour plot will be generated to fit inside the new window. You can output the contour plot to a Postscript or PNG file by using the Output button inside the window.
3. You can modify the following setups and click Go button to generate new contour plot.
• Algorithm - The default is cell-based algorithm and is faster. The Follow algorithm is contour-line based algorithm will be slower but looks better with dashed line styles.
• Fill - Yes to fill the contour levels. No means no fill.
• Contour level -
• Equally Spaced - The contour plots will based on the equally spaced levels of the image data. The number of levels is defined in Number of equally spaced contour level.
• User Specified - The contour plots will based on the levels entered by the user in User specified contour levels. The levels entered here have to be separated by commas and the units have to match the data selected in the Data source.
• Annotation - Enter a list of annotation for each contour level. Separate values with commas.
• Graphics palette - Enter a list of graphics palette colors (1 to 7) for each contour level. These colors will apply to either the contour lines or the contour fill colors. Separate with commas.
• More graphics parameters - To change the default setups for X axis and Y axis of the contour plots.
• Output to -
• New Window - The default.  The contour plots will be generated on a new window. The initial window size may be changed with the X size and Y size fields. However, once the contour plots created, you can always resize it and the contour plots will be regenerated based on the new window size. You can also include the image with the contour plots by selecting Yes in the Include Image field.
• Frame Buffer - To generate the contour plots on the window the image currently displayed.

Command mode: Not available.

Band X-Y Shifting

Interactive mode:

1. From Seadisp Main Menu->Functions, select the menu item Band X-Y Shifting to display the SEADISP Band X-Y Shifting widget.
2. Select the band images to be shifted by clicking the left mouse button on the images listed in the Band selection list. The list is copied from Band List Widget the first time the SEADISP Band X-Y Shifting widget is displayed. If the list is empty, or does not have the image you want, or does not match to the list in the Band List Widget, then you have to load the image first (see how to load data) and press the update button to update the list.
3. The selected images will be listed in the Selected for shifting list. To remove an entry in this list, first use left mouse button to highlight the item to be removed then click the Delete button.
4. Enter the pixels to be shifted in the X- and Y- directions.
5. Select the output to new bands or original bands (overwrite)
6. Press Go to generate the shifted images. The results will update the Band List Widget.

Command mode: Not available.

Scatter Plot

Interactive mode:

1. From Seadisp Main Menu->Functions, select the menu item Scatter Plot to display the main widget for this function.
2. Make sure that the images for scatter plotting are listed in the Frame buffer selection list. If not, you have to load those images into the Band List Selection widget and then click the Update button to copy all the available images from the Band List Selection widget to the Frame buffer selection list.
3. Select the images for scatter plotting by clicking the image from the Frame buffer selection list. The image selected will be displayed in either Image 1 (X-Axis) or Image 2 (Y-Axis) depending on if the toggle button on top of the widget is 1 or 2.
4. Update the Data source, Data range, Display histogram option, Display grid option, if necessary for Image 1 and Image 2 .
5. Click the More Setup button if you want to change the default setups for X axis and Y axis of the scatter plot.
6. Click the Go button and the scatter plot will be generated on a new window with a default size. The scatter plot may take a while depending on the image size. Once the scatter plot is created, you can always resize the window and the scatter plot will be regenerated based on the new window size.
7. Click the Quit button to quit the Scatter Plot widget.

Command mode: Not available.

SeaWiFS/OCTS L2 Flags Display

Interactive mode:

1. Make sure that the L2 flags data is loaded and displayed in the Band List Selection widget and the corresponding L1 or L2 image to be applied is loaded and displayed in one of the display windows.
2. From Seadisp Main Menu->Functions, select the menu item SeaWiFS & OCTS/NASDA L2 Flags Display to display the main widget for this function.
3. On the main widget, select the band number from Band List Selection widget that the L2 flags data is loaded to.
4. On the main widget, select the display window number that the L1 or L2 image is displayed on and to be applied by the flags.
5. Change the Flag type to OCTS L2 Flags if you are working on OCTS L2 data.
6. To select and display a single flag:
• Select the flag to be displayed using the One Flag slide bar or just click the flag toggle button.
• Click the Load button and all the pixels in the display window with that flag set will be displayed with the color assigned to that flag. The color assigned to each flag may be changed using Modify flags' colors option under the Flag Function Menu.
7. To select and display multiple flags at once:
• To add or remove a flag from the Multiple Flags list, just click the toggle button of that flag. The flag will be inserted in the beginning of the list, if it is not in the list, otherwise, it will be removed from the list.
• Click the Load button and all the pixels in the display window with those flags set will be displayed with the colors assigned to those flags. The priority order for flags on the same pixel is from left to right (low to high) of the flag list. The color assigned to each flag may be changed using Modify flags' colors option under the Flag Function Menu.
8. More functions from the drop down Flag Function Menu:
• Load one flag - To display the flag specified in the One Flag field with its assigned color on top of the selected display window.
• Load multiple flags - To display the flags specified in the Multiple Flags field with their assigned colors on top of the selected display window.
• Load all flags - To display all flags (1-16) on top of the selected display window.
• Toggle flags on - To turn on the overlay flags, if they were turned off on the selected display window.
• Toggle flags off - To turn off the overlay flags on the selected display window.
• Quick flag on/off loop - To turn on/off the overlay flags continuously for 8 times.
• Clear all flags - To clear all the overlay flags on the selected display window.
• Make blotches on flags - To mask all flag pixels that are currently displayed as blotches with color given in the Color to mark flags as blotches field. To save the blotches as overlay graphics in the displayed window, you have to quit the SeaWiFS & OCTS L2 Flag Display widget when the blotches are on, otherwise any other flag display function may clear the blotches.
• Modify flags' colors - To open the Flag Color Set Up widget for the user to change the default colors for flags.
9. Click the Quit button to quit the SeaWiFS & OCTS L2 Flags Display widget.

Command mode: Not available.

Paint Color (Density Slice)

Interactive mode:

1. From Seadisp Main Menu->Functions, select the menu item Paint Color (Density Slice) to display the Paint - Density Slice widget.
2. Select the display window number for the image displayed to be applied by the paint function.
3. Select the Raw or Geophysical data type the data ranges for paint colors to be applied.
4. Add a range to the List of Density Slice Ranges list:
• Enter the data range in Min and Max fields. The values have to match the image data type in raw or geophysical units.
• Select the color from the Color index drop down menu to be applied for the specified range.
• Click Add button and the program will append it to the List of Density Slice Ranges.
5. Add multiple equal distance ranges to the List of Density Slice Ranges list:
• Enter the number of ranges to be added.
• Enter the starting range and the size (image data value) to be automatically increased for each range.
• Click Add button and the program will append the data ranges defined in here with colors automatically assigned from the starting color index before the Add button is clicked to the List of Density Slice Ranges.
6. Click the Apply button to apply the colors to image pixels in the selected display window based on the order of the density slice ranges listed in the List of Density Slice Ranges field. Note that the program will not check for duplicated or overlapped ranges and the minimum and maximum ranges for each density slice are inclusive when comparing with the image data.
7. Paint function manipulation from the drop down Function Menu:
• Paint selected range - To display all pixels that have values inside (inclusive) the density slice range that is highlighted in the List of Density Slice Ranges field with the color assigned to that range.
• Clear selected range - To clear the color on pixels that have been painted based on the information of the highlighted entry in the List of Density Slice Ranges field.
• Paint all ranges - Same as the Apply button.
• Clear all ranges - To clear all colors that have been painted on the selected display window.
• Mark selected range as blotches - To mask all pixels that have values inside (inclusive) the density slice range that is highlighted in the List of Density Slice Ranges field as overlay graphics on the selected display window with the color given in the Color to mark density slice(s) as blotches field. Once the blotches are generated, they will stay with the display window and the paint function will not work on top of the blotches.
• Mark all ranges as blotches - To mask all pixels that satisfy any of the ranges listed in the List of Density Slice Ranges field as overlay graphics on the selected display window with the color given in the Color to mark density slice(s) as blotches field. Once the blotches are generated, they will stay with the display window and the paint function will not work on top of the blotches.
• Quick selected range on/off loop - To display the image with the painted color over pixels defined by the highlighted density slice range in the List of Density Slice Ranges field on/off for 10 times.
• Quick all ranges on/off loop - To display the image with the painted colors over pixels defined by all the density slice ranges in the List of Density Slice Ranges field on/off for 10 times.
8. Click the Quit button to quit the Paint - Density Slice widget.

Command mode: Not available.

Copy Graphics

Interactive mode:

1. From Seadisp Main Menu->Functions, select the menu item Copy Graphics to display the Copy Graphics widget.
2. Select the From Window number and To Window number.
3. Turn off any graphics color you do not wish to copy (by default all colors are selected).
4. Select an alternate Graphics Mode if you do not wish to overlay the specified graphics on the new graphics window. Make sure that your To Window already has its own graphics to see the different effects of the Overlay, Underlay or Replace options.
5. Press Go to generate the copy the specified graphics.

Command mode: Not available.

Graphics Control

For the following example, make sure you have selected a window which contains graphics of several different colors. If you want to load pre-created graphics, load the test graphics file $SDSDEMO/lgraph1.hdf with the Load Graphics->HDF option.

Interactive mode:

Simple control:
1. To turn off all graphics objects temporarily, select the menu item Graphics Control->All Off from Display Window Widget->Functions.
2. To turn all the graphics objects back on, select the menu item Graphics Control->All On from Display Window Widget->Functions.

Custom control by color:
1. You can toggle or erase graphics objects by color by bringing up the Graphics Control Window. Bring up this widget by either selecting Graphics->Graphics Control Window from Display Window Widget->Functions, or by selecting Graphics Control from Display Window Widget->Setups.
2. To toggle graphics objects on and off by color, press the button by the number of the color you wish to toggle on and off. The action takes place immediately; there is no associated action button.
3. To erase all graphics objects of a particular color(s) permanently, press the button next to the graphics color number(s) you wish to erase. Press Erase.

Command mode: Not available.

Multiple Concurrent Color Tables

For the following example, you will probably want to also bring up the Load Color Widget or the Change Color Widget. In this way, you can watch the color tables repartition within the available colors allotted for your session.

Interactive mode:

To display and load multiple color tables:
1. Display one image using display option LUT no.: 1. Display another image in another window using display option LUT no.:2.
2. To load separate color tables into each of these windows:
• Open the Load Color Widget.
• Select the Color table number 1 and then load a color table.
• The image loaded using color table 1 should change color.
• Select Color table number 2 and then load a different color table.
• The image loaded using color table 2 should now change color.
To change the number of pre-allocated color tables or change the partition sizes:
1. From Seadisp Main Menu->Global Setup, select the menu item Change Color Table Configuration.
2. Notice the Full session range values. This shows you how many colors you have available in your current session for coloring data (the graphics palette and other colors are excluded from this number).
3. To change the number of concurrent color tables, select a number from No. of concurrent tables menu. If you don't like the calculated default partitions, you can change the partition range values. When you are satisfied with the new partitions, press Apply.
4. If you have the Load Color Widget up, you should be able to see the color table repartition and rescale. Any currently displayed windows will rescale and redisplay and should look the same as before the repartitioning.

Command mode: Not available.

Arithmetic Band Functions: Difference, Simple Average, General Summation

Interactive mode:

1. Load at least 2 different bands from the same file.
2. From Seadisp Main Menu->Functions, select the menu item Arithmetic Band Functions.

Difference Function:

The list of available loaded products should appear at the top of the widget. To create the output product Image3 = Image1 - Image2 :
1. Click on the data product you wish to assign to variable Image1.
2. Push the I2 button, and click on the product you wish to assign to variable Image2.
3. Specifying Data Type:  The data type selected (either Raw or Geophysical), specifies whether to perform the difference calculation on the raw data values or the geophysical data values.
• Raw:  If both of the data products have the same slope & intercept conversion from raw to geophysical values, then you can specify Raw. In this case, the difference will be performed on the raw data, and the resultant difference data image will be stored in raw data values with the correct slope and intercept values.
• GeoPhysical:  If both of the data products have the same geophysical data units, but the slopes and intercepts to convert between raw and geophysical are different, then the difference should be performed on the GeoPhysical data values. In this case, the resultant difference image will be stored in geophysical data values and assigned a slope of 1.0 and intercept of 0.0.
4. Press Go. The difference image should appear as a new loaded product, available for display.
Simple average and General Summation Functions: These two functions operate similarly to the difference function.

Command mode: Not available.

ASCII Output

Interactive mode:

Select the ASCII Output function either:
• From the Seadisp Main Menu->Functions, select the menu item ASCII Output OR
• From the Display Window Widget->Functions, select Output->ASCII.
Case 1: Simplest case (geophysical data values only for entire image):
1. Select the window number containing the displayed product you want to output.
2. Press Write File
Case 2: Output latitude, longitude, and geophysical data values for a rectangular region.
1. Select the window number containing the displayed product you want to output.
2. To output the top lefthand corner of the data (50x50), modify opp. corner to be 50 in both the Pixel and Line columns.
3. Press Setup to get the custom setup menu.
4. Click on the desired variables to output. They will be added to the output variable list. You can delete variables or reorder variables.
5. Press Write File.
Case 3: Output the latitude, longitude, and geophysical data values for a transect between two points.
1. Select the window number containing the displayed product you want to output.
2. Select the Line option for Region of Interest.
3. Define the two endpoints of the transect line either by modifying the pixel/line values or the latitude/longitude values. Pixel/line values will automatically update when modifying latitude/longitude values and vice versa.
4. Press Setup to get the custom setup menu.
5. Click on the desired variables to output. They will be added to the output variable list. You can delete variables or reorder variables.
6. Press Write File

Command mode: Not available.

Curator: OceanColor Webmaster Authorized by: gene carl feldman

Privacy Policy and Important Notices Updated: 20 March 2008