Seadisp Map Projection Widget: Program-level Documentation

Seadisp Map Image Projection Function (mapimg)

Description: The mapimg function provides two main functions:

Project single or multiple loaded product(s) using a single set of projection parameters. The number of projected products will equal the number of input products. The new projected product(s) will be added to the current list of products available for display.
Composite a set of bands into a single output projection. Add the single new mapped product to the current list of bands available for display.

This command can be run in command mode or accessed interactively by selecting Functions->Projection in the Main Seadisp Widget.

NOTE: Products must be loaded with the load function in order to be able to use the mapimg function.

[Interactive mode][Command mode]

Command Mode:

Usage: mapimg, bands=bands, ix=ix, missing=missing, composite=composite, block=block, map_pfile=map_pfile, iproj=iproj, xsize=xsize, ysize=ysize, limit=limit, p0lat=p0lat, p0lon=p0lon, rot=rot, position=position, isotropic=isotropic, scale=scale, /CYLIN, /MERCATOR, /MOLLWEIDE, /STEREO, /ORTHO, /CONIC, /LAMBERT, /GNOMIC, /AZIMUTHAL, /SINUSOIDAL, /AITOFF, /HAMMER, /ALBERS, /MILLER, /TRANSVERSE_MERCATOR, /ROBINSON, ellipsoid=ellipsoid, central_azimuth=central_azimuth, standard_parallels=standard_parallels, help=hlp

Arguments/Keywords:

bands An array containing a list of the loaded product numbers to map. (Required)

ix The index number in the above band list (relative to 0), representing the band to be used to calculate any unspecified mapping parameters. (Default is the last band in the list)

missing An array of missing values to use for any unmapped areas for the products specified in bands. If not specified, the missing value to use for each product is searched for in the seadas_defaults file. If the product is not listed in the defaults file, then the minimum data value is used. The missing value is represented n terms of raw data values.

composite If not specified or 0, then project each band specified in bands individually creating multiple output maps. If specified and non-zero, then composite the bands specified in bands onto a single output map projection.

block The number of lines of the output projection (see ysize) to process in a chunk. (Default 128).

map_pfile The name of an ASCII file which contains the map projection keywords values.

Map Projection Keywords - Defaults IDL-specific mapping keywords with default values.

Examples:

Map the first loaded product to /CYLIN projection using the lat/lon limits stored in the internal band information.

mapimg, bands=[1]

Composite the first two loaded products onto a map in mercator projection with the limits specified. Make the map an isotropic map.

mapimg, bands=[1,2], /MERC, LIMIT=[-80,-180,80,180.], P0LAT=0.0, P0LON=0.0, /COMPOSITE, /ISOTROPIC

Interactive Mode:

Seadisp Map Projection Widget: This widget can be accessed within the Seadisp Main Menu by selecting Functions->Projection.

Selection Section:

Selection List The list of the bands currently loaded into memory. Clicking on a band in this list adds the band to the Selected for projection list. Also, if Automatically load defaults is set to YES, then the output projection options will be updated according to the lat/lon range of this input file.

Update Update the current Selection List with any bands that have been added or deleted.

Selected for projection List Specify the bands for data viewing. (Default is to display values for all loaded bands). Also, if Automatically load defaults is set to YES, then the output projection options will be updated according to the lat/lon range of this input file.

Delete Remove the highlighted item from the Selected for projection list.

Extra Mapping Options:

Missing value The missing value to use for unmapped areas, for each product selected. Leaving this blank denotes to take the default behavior. See missing keyword in command mode.

Automatically load defaults If YES, then whenever a band in either the Selection List or the Selected for projection List is selected, then the output option values listed below will be updated according to the lat/lon range of the selected band. If NO, then the output option values will not change when bands are selected.

Individual/Composite Specify whether the bands listed in the Selected for projection list should be projected as individual projections or composited into one output projection.

Map Projection Inputs Section: Map Projection Compound Widget

Action items:

Go	Map the products listed in the Selected for projection list into the requested projection and add the new projected products to the current list of products available for display. All products listed in the Selected for projection list will be processed using the current output mapping values.
Help	Display this online help in HTML browser.
Quit	Destroy the Seadisp Projection Widget.

Curator: OceanColor Webmaster

Authorized by: gene carl feldman

bands	An array containing a list of the loaded product numbers to map. (Required)
ix	The index number in the above band list (relative to 0), representing the band to be used to calculate any unspecified mapping parameters. (Default is the last band in the list)
missing	An array of missing values to use for any unmapped areas for the products specified in bands. If not specified, the missing value to use for each product is searched for in the seadas_defaults file. If the product is not listed in the defaults file, then the minimum data value is used. The missing value is represented n terms of raw data values.
composite	If not specified or 0, then project each band specified in bands individually creating multiple output maps. If specified and non-zero, then composite the bands specified in bands onto a single output map projection.
block	The number of lines of the output projection (see ysize) to process in a chunk. (Default 128).
map_pfile	The name of an ASCII file which contains the map projection keywords values.
Map Projection Keywords - Defaults	IDL-specific mapping keywords with default values.

Selection List	The list of the bands currently loaded into memory. Clicking on a band in this list adds the band to the Selected for projection list. Also, if Automatically load defaults is set to YES, then the output projection options will be updated according to the lat/lon range of this input file.
Update	Update the current Selection List with any bands that have been added or deleted.
Selected for projection List	Specify the bands for data viewing. (Default is to display values for all loaded bands). Also, if Automatically load defaults is set to YES, then the output projection options will be updated according to the lat/lon range of this input file.
Delete	Remove the highlighted item from the Selected for projection list.

Missing value	The missing value to use for unmapped areas, for each product selected. Leaving this blank denotes to take the default behavior. See missing keyword in command mode.
Automatically load defaults	If YES, then whenever a band in either the Selection List or the Selected for projection List is selected, then the output option values listed below will be updated according to the lat/lon range of the selected band. If NO, then the output option values will not change when bands are selected.
Individual/Composite	Specify whether the bands listed in the Selected for projection list should be projected as individual projections or composited into one output projection.