SeaDAS Banner Image

bl1map

Description: This program maps SeaWiFS and MODIS L1A band products. The bands selected for mapping are written to the specified output file as HDF SD(Science Dataset) 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 - Meaning 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:bl1map, ifile, ofile, bands, 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:  bl1map, ifile, ofile, bands

Examples:

(1) bl1map, '$SDSDEMO/L1_gac1.hdf', 'L1_gac1_map.hdf', [1,4], xsize=300, ysize=300, /stereo
(2) bl1map, '$SDSDEMO/L1_gac2.hdf', 'L1_gac2_map.hdf', [2,5], xsize=300,ysize=400, /merc, POSITION=[0.2,0.2,0.8,0.8]
(3) bl1map, '$SDSDEMO/L1_gac1.hdf', 'L1_gac1.map.hdf', [1,2], append=0, block=128, iproj=8, xsize=400, ysize=400, position=[0.0,0.0,1.0,1.0], p0lat=0.0, p0lon=0.0, rot=0.0, limit=[-90.0,-180.0,90.0,180.0], title=['412','442'], missing=[0.0,0.0], unit='Radiance counts', isotropic=1, central_azimuth=0

Arguments/Keywords:
ifile Input SeaWiFS or MODIS L1A file name. It could be LAC, GAC or HRPT file. (Required)
ofile The output HDF file name for the mapped L1A band 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)
bands An array containing the band numbers of the L1A bands to be projected. Each band specified will be written to ofile as an SD object with SD name(s) attributes as specified in title. (Required).
            1 = 412nm
            2 = 443nm
            3 = 490nm
            4 = 510nm
            5 = 555nm
            6 = 670nm
            7 = 765nm
            8 = 865nm
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 text 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 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 values are specified in terms of raw data values.
unit Default is 'Radiance counts' for L1A data.
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 "bl1map" from the Process->SeaWiFS or Process->MODIS pull down menu in SeaDAS main menu or from the command line mode by typing: "bl1map".
 
Input file The input SeaWiFS or MODIS L1A file. It can be a LAC, GAC, or HRPT file.
Select (Input file) To display the File Selection Widget for selecting the input L1A file. The file selected will be displayed in the Input File field.
Output file The output HDF file name for the mapped L1A band images. If the file already existed, it has to be an HDF file and the mapped L1A band 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.
Select output bands Toggle buttons to select the bands in the L1A file to be projected. When the Submit or Run button is pressed, all bands selected will be projected to the specified projection.
Current working band The band name of the current working band is displayed. The Title field is available for modification for the current working band listed.
Title The SD name of the mapped image in the output HDF file.
Missing The missing values to use for unmapped areas, for each product selected. Leaving this blank denotes to take the default behavior.
Map Projection Inputs Map Projection Compound Widget
Log file The output file name for the process log if the user select Submit.
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 in the background 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 left mouse button 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

NASA logo

Privacy Policy and Important Notices

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