Download   Help   Documents   Contact   Links   OceanColor   News   FAQ   Forum 

Seadisp Coast Function (coast)

Description: For all navigable file types, the coast function can add a graphics coastline on the current or specified window.

For navigable file types which are in an IDL recognized map projection more coast options are available such as a solid continental mask, political boundaries, rivers, US states, etc.  The data types which are currently recognized IDL projections are: SeaDAS Mapped files, loaded SeaWiFS L3-binned files and SeaWiFS SMI products.  In addition, all navigable input data can be recognized as an IDL projection if projected with the mapimg function after loading.

[Interactive mode][Command mode]

Command mode:

Usage: coast, fbuf=fbuf, color=color, mlinestyle=mlinestyle, mlinethick=mlinethick, merge_mode=merge_mode, hires=hires, idl_opts=idl_opts, fill_continents=fill_cont, /continents, /coasts, /countries, /USA, /rivers, spacing=spacing, orientation=orientation, rate=rate, help=help

Examples:

  1. Drop a coastline on the current seadisp window:
    2. coast
  2. Drop a high-resolution black continental mask on the IDL map-projected data displayed in window #3:
    3. coast, FBUF=3, COLOR=7, FILL_CONT=1, /HIRES
Keywords for all navigable input types:
fbuf Seadisp window number(default is current window).
color 1 to 7 of the SeaDAS graphics palette (default is 1).
mlinestyle 0 = solid (default)
1 = dotted
2 = dashes
3 = dash-dot
4 = dash 3 dot
5 = long dashes
mlinethick Line thickness.  1 to 10. (Default=1)
merge_mode 0 = replace all current bitmap graphics with this coast
1 = overlay on top of any existing bitmap graphics (Default)
2 = underlay coast under any existing bitmap graphics
3 = erase all bitmap graphics, redraw new coastline and overlay last gridlines specified. 
hires 0 = Use low resolution CIA database (~10 KM). 
1 = Use high resolution CIA database (~1KM).   (Default is dependent on file type)
help Print out usage message.

Keywords for data displayed in a recognized IDL map projection:
idl_opts IDL coast options:
  • 0 = Continental outline (or use /CONTINENTS) (default)
  • 1 = Solid fill continents (or use FILL_CONTINENTS=1)
  • 2 = Line-filled continents (or use FILL_CONTINENTS=2)
  • 3 = Islands and lakes (or use /COASTS)
  • 4 = Policical boundaries (or use /COUNTRIES)
  • 5 = USA state boundaries (or use /USA)
  • 6 = World rivers (or use /RIVERS)
spacing applicable to FILL_CONTINENTS=2 option only.  Spacing (in cm) between the fill lines.
orientation applicable to FILL_CONTINENTS=2 option only.  Line angle (in degrees) of the fill lines.

Keywords for non-IDL mapped file types. Currently this would include files using SeaWiFS navigation (L1A, L1B and L2), CZCS and OCTS files:
rate CIA database sampling rate.(default is file-dependent).

Interactive mode:

Description:  There are two separate sets of options that appear in the Seadisp Coastline Setup Widget, depending on the navigation type of the file displayed. Most navigable files will have coastline only options:


Files which IDLrecognizes as IDL-mapped files(currently only the SeaDAS mapped files) have in addition filled continents, political boundaries, rivers, etc:

Selecting Setups->Coast within the Seadisp Display Window Widget will bring up either of the coast setup widgets which contain all the coast options.  Some of the defaults (such as CIA DB resolution) are set on an image-by-image basis.  You do not need to use the setup widget in order to drop a default coastline.  Simply select Functions->Coast.

Action items:

Options for all navigated files:
Color The color of the coastline.  Click the mouse on the graphics color bar to specify a different color.
Modify Bring up the widget to allow modification of the graphics color hues.  Once modified, the changes will apply to all currently displayed images.
Line Thickness The line thickness of the coastline.
Line Style The line style of the coastline (solid, dots, dashes, dash-dot, dash 3 dots,long dash)
CIA DB Resolution Whether to use the high resolution or low resolution coastline database.  An intelligent default is set on an image-by-image basis.
Graphics Apply Mode
Replace Graphics Replace all existing graphics in the display window with the coastline.
Overlay Overlay the coastline graphics on top of any existing graphics in the window.
Underlay Place the coastline graphics on top of the image, but underneath all other graphics in the window.
Redraw Coast/Grid Redraw the coastline and gridlines using the current settings.
Apply Apply the coastline graphics to the current window, using the options above.
Quit Exit the coastline widget.  All settings will be retained the next time the coast setup widget is opened.

Options for non-IDL mapped files only:
CIA DB Sample Rate The sampling rate to use when accessing the coastline database.  An intelligent default is set on an image-by-image basis.

Options for IDL mapped files only:
Mapping Options
  • Continental Outline
  • Continents (Solid Fill)
  • Continents (Line Fill)
  • Coasts (Islands and Lakes)
  • Countries
  • USA States
  • Rivers
    		•
    Line Fill Spacing (cm) Only active for Continents (Line Fill) Mapping Option.  The spacing between lines.
    Line Fill Angle Only active for Continents (Line Fill) Mapping Option.  The angle of the lines.

    Curator: OceanColor Webmaster

    Authorized by: gene carl feldman     		Privacy Policy and Important Notices

    Updated: Thursday, 20-Mar-2008 16:33:11 EDT     		NASA logo