SeaDAS Level-2 Mapping Program

bl2map

Description: This program maps SeaWiFS and MODIS Level-2 products. The products selected for mapping are written to the specified output file as HDF SD objects along with specified mapping attributes and can be displayed and navigated using the Load->SeaDAS Mapped option in the 'seadisp' program.

The map projections are created using IDL's map projection capabilites. See Map Projection Keywords - Meanings and Defaults for a brief description of the available map projections and map projection keywords. For more detailed information about the specific mapping parameters, see the description about the MAP_SET and MAP_IMAGE functions in the IDL Reference Guide.

[Command Mode][Interactive Mode]

Command Mode:

Usage:bl2map, ifile, ofile, prodname, append=append, block=block, help=hlp, map_pfile=map_pfile, iproj=iproj, xsize=xsize, ysize=ysize, position=position, p0lat=p0lat, p0lon=p0lon, rot=rot, limit=limit, title=title, missing=missing, source=source, unit=unit, isotropic=isotropic, scale=scale, ellipsoid=ellipsoid, central_azimuth=central_azimuth, standard_parallels=standard_parallels, /CYLIN, /MERCATOR, /MOLLWEIDE, /STEREOGRAPHIC, /ORTHOGRAPHIC, /CONIC, /LAMBERT, /GNOMIC, /AZIMUTHAL, /SINUSOIDAL, /AITOFF, /HAMMER, /ALBERS, /MILLER, /TRANSVERSE_MERCATOR, /ROBINSON, /SATELLITE

Minimum command: bl2map, ifile, ofile

Examples:

(1) bl2map, '$SDSDEMO/l2_gac1.hdf', 'l2_gac1_map.hdf', ['nLw_412','chlor_a'], xsize=300, ysize=300, /stereo
(2) bl2map, '$SDSDEMO/l2_gac2.hdf', 'l2_gac2_map.hdf', ['nLw_443','nLw_555'], xsize=300,ysize=400, /merc, POSITION=[0.2,0.2,0.8,0.8]

Arguments/Keywords:

ifile Input SeaWiFS or MODIS Level-2 file name. (Required)

ofile The output HDF file name for the mapped Level-2 product images. If the file already exists, it must be an HDF file and the mapped images will be appended to it as SD objects. (Required)

prodname An array containing the product names of the Level-2 products to be projected. Each product specified will be written to ofile as an SD object with SD name(s) attributes as specified in title. (Required).
NOTE: prodname replaces the old argument prodnums that was used in previous versions of SeaDAS. Since some users may have old scripts which use product numbers rather than names, the following numbers may still be used in place of the equivalent product name:
1 = nLw_412
2 = nLw_443
3 = nLw_490
4 = nLw_510
5 = nLw_555
6 = La_670
7 = La_865
8 = CZCS_pigment
9 = chlor_a
10= K_490
11=eps_78
12=tau_865
13=l2_flags
For all other products, the product name must be used instead of a number.

append 0 = Remove output file if exists and create a new HDF file. (default)
Non_zero = append all SD's to existing file

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

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

Map Projection Keywords - Meaning and Defaults Click here for a full description.
Note: All projection keywords are stored as SD attributes in the output file.

title The SD name(s) to assign to the mapped SD's. If not specified, the default product names are used.

missing An array of missing values to use for any unmapped areas for the products specified in prodname. 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 values are specified in terms of raw data values.

unit The default units used are product-dependent and are stored in the Level-2 data file as attributes.

source The source of the mapped image as an attribute to the SD object written to the output HDF file. Default is ifile.

help To list all arguments and keywords available for this program.

Interactive Mode:

Main Widget:

The main widget can be accessed by selecting "bl2map" from the Process->SeaWiFS or Process->MODIS pull down menu in SeaDAS main menu or from the command line mode by typing: "bl2map".

Input file The input SeaWiFS or MODIS Level-2 file.

Select (Input file) To display the File Selection Widget for selecting the input Level-2 file. The file selected will be displayed in the Input File field.

Output file The output HDF file name for the mapped Level-2 images. If the file already existed, it has to be an HDF file and the mapped Level-2 images will be appended as SD objects in it.

Output File Mode Action to take if output HDF file already exists.
New - Remove the existing HDF file before creating a new file (default)
Append- Append output SDs to the existing HDF file.

Map Projection Inputs Map Projection Compound Widget

Log file The output file name for the process log if the user selects Submit.

Select output products Toggle buttons to select the products in the Level-2 file to be projected. When the Submit or Run button is pressed, all products selected will be projected to the specified projection. (This section is not visible until an input file has been selected.)

Current working product The product name of the current working product is displayed. The Title field is available for modification for the current working product listed. (This section is not visible until an input file has been selected.)

Title The SD name of the mapped image in the output HDF file. (This section is not visible until an input file has been selected.)

Missing The missing values to use for unmapped areas, for each product selected. Leaving this blank denotes to take the default behavior. See missing keyword in command mode. (This section is not visible until an input file has been selected.)

Run Run this program in the foreground using the options specified. Process log messages will print to the main SeaDAS window.

Submit Run this program as a background process using the options specified.

Help Display this HTML help file in local HTML viewer.

Quit Quit this program.

File Selection Widget:

Input items:

Path The directory from which the subdirectories and files are listed for selection.

Filter The string for filtering the files in the Path directory and displayed in the Files list for selection.

Subdirectories Listing of all the subdirectories under the Path directory. The listing will be updated if the field Path got updated.

Files Listing of all the files that are under the Path directory and match the Filter strings. The listing will be updated if fields Path, Filter, or Subdirectories got updated. If the left mouse button is used to click on any file, that file will be listed in the Selection field.

Selection The file to be selected when the OK button is clicked. If this field is empty, the directory in the Path field is returned.

Action items:

OK Returns the selected file list in the Selection field (or Path field, if Selection field is blank), and quits the File Selection Widget.

Cancel Cancels and quits the File Selection Widget. No file is selected.

Help Displays the IDL version of online help on this widget.

Curator: OceanColor Webmaster

Authorized by: gene carl feldman

Updated: Thursday, 11-Dec-2008 10:52:36 EST

ifile	Input SeaWiFS or MODIS Level-2 file name. (Required)
ofile	The output HDF file name for the mapped Level-2 product images. If the file already exists, it must be an HDF file and the mapped images will be appended to it as SD objects. (Required)
prodname	An array containing the product names of the Level-2 products to be projected. Each product specified will be written to *ofile* as an SD object with SD name(s) attributes as specified in title. (Required). NOTE: *prodname* replaces the old argument *prodnums* that was used in previous versions of SeaDAS. Since some users may have old scripts which use product numbers rather than names, the following numbers may still be used in place of the equivalent product name: 1 = nLw_412 2 = nLw_443 3 = nLw_490 4 = nLw_510 5 = nLw_555 6 = La_670 7 = La_865 8 = CZCS_pigment 9 = chlor_a 10= K_490 11=eps_78 12=tau_865 13=l2_flags For all other products, the product name must be used instead of a number.
append	0 = Remove output file if exists and create a new HDF file. (default) Non_zero = append all SD's to existing file
block	The number of lines of the output projection (see ysize) to process in a chunk. (Default=128)
map_pfile	The name of an optional ASCII file which contains the map projection keyword values.
Map Projection Keywords - Meaning and Defaults	Click here for a full description. Note: All projection keywords are stored as SD attributes in the output file.
title	The SD name(s) to assign to the mapped SD's. If not specified, the default product names are used.
missing	An array of missing values to use for any unmapped areas for the products specified in prodname. 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 values are specified in terms of raw data values.
unit	The default units used are product-dependent and are stored in the Level-2 data file as attributes.
source	The source of the mapped image as an attribute to the SD object written to the output HDF file. Default is ifile.
help	To list all arguments and keywords available for this program.

Input file	The input SeaWiFS or MODIS Level-2 file.
Select (Input file)	To display the *File Selection Widget* for selecting the input Level-2 file. The file selected will be displayed in the *Input File* field.
Output file	The output HDF file name for the mapped Level-2 images. If the file already existed, it has to be an HDF file and the mapped Level-2 images will be appended as SD objects in it.
Output File Mode	Action to take if output HDF file already exists. New - Remove the existing HDF file before creating a new file (default) Append- Append output SDs to the existing HDF file.
Map Projection Inputs	*Map Projection Compound Widget*
Log file	The output file name for the process log if the user selects *Submit*.
Select output products	Toggle buttons to select the products in the Level-2 file to be projected. When the Submit or Run button is pressed, all products selected will be projected to the specified projection. (This section is not visible until an input file has been selected.)
Current working product	The product name of the current working product is displayed. The *Title* field is available for modification for the current working product listed. (This section is not visible until an input file has been selected.)
Title	The SD name of the mapped image in the output HDF file. (This section is not visible until an input file has been selected.)
Missing	The missing values to use for unmapped areas, for each product selected. Leaving this blank denotes to take the default behavior. See *missing* keyword in command mode. (This section is not visible until an input file has been selected.)
Run	Run this program in the foreground using the options specified. Process log messages will print to the main SeaDAS window.
Submit	Run this program as a background process using the options specified.
Help	Display this HTML help file in local HTML viewer.
Quit	Quit this program.

Path	The directory from which the subdirectories and files are listed for selection.
Filter	The string for filtering the files in the *Path* directory and displayed in the *Files* list for selection.
Subdirectories	Listing of all the subdirectories under the *Path* directory. The listing will be updated if the field *Path* got updated.
Files	Listing of all the files that are under the *Path* directory and match the *Filter* strings. The listing will be updated if fields *Path, Filter, or Subdirectories* got updated. If the left mouse button is used to click on any file, that file will be listed in the *Selection* field.
Selection	The file to be selected when the OK button is clicked. If this field is empty, the directory in the *Path* field is returned.

OK	Returns the selected file list in the *Selection* field (or *Path* field, if *Selection* field is blank), and quits the *File Selection Widget.*
Cancel	Cancels and quits the *File Selection Widget*. No file is selected.
Help	Displays the IDL version of online help on this widget.