SeaDAS Help - Data Processing Tools

mapgen

Creates a mapped output.

Takes a product (or products if netCDF output) from an L1, L2 or L3 bin file, reprojects the data using Proj.4 and writes a mapped file in the requested output format.

Location

SeaDAS-Toolobox -> SeaDAS Processors -> mapgen

GUI Usage
Command Line Usage

GUI Usage

Arguments/Keywords

UI Element Name	Type	Description	Required/Optional	Default Value
ifile	ifile	input file or text file list of files.	Required
ofile	ofile	output file name; default: <ifile>.MAP.<oformat ext>.	Required
product	string	product(s) to map; comma separated	Required
projection	string	One of the following predefined (proj4) projections may be selected: platecarree: Plate Carree (cylindrical) projection projection="+proj=eqc +lat_0=<central_meridian>" mollweide: Mollweide projection projection="+proj=moll +lat_0=<central_meridian>" lambert: Lambert conformal conic projection projection="+proj=lcc +lat_0=<central_meridian>" albersconic: Albers Equal Area Conic projection projection="+proj=aea +lat_0=<central_meridian>" mercator: Mercator cylindrical map projection projection="+proj=merc +lat_0=<central_meridian>" ease2: Ease Grid 2 projection projection="+proj=cea +lon_0=0 +lat_ts=30 +ellps=WGS84 +datum=WGS84 +units=m +lat_0=<central_meridian>"	Optional	platecarree
resolution	string	size of the output pixel in meters or SMI dimensions: #.#: width of a pixel in meters #.#km: width of a pixel in kilometers #.#deg: width of a pixel in degrees	Optional	2km
north	float	Northern most Latitude	Optional	-999
south	float	Southern most Latitude	Optional	-999
east	float	Eastern most Longitude	Optional	-999
west	float	Western most Longitude	Optional	-999
oformat	string	format of the output file : netCDF: Network Common Data Form v4 file can contain more than one product png: Portable Network Graphics format image ppm: Portable PixMap format image tiff: Tagged Image File Format with georeference tags	Optional	netCDF4
central_meridian	float	central meridian to use for projection in degrees east.	Optional	0
palfile	ifile	palette file name	Optional	see $OCDATAROOT/common/product.xml
datamin	float	minimum value for data scaling	Optional	default from product.xml
datamax	float	maximum value for data scaling	Optional	default from product.xml
scale_type	string	data scaling type: linear: linear scaling log: logarithmic scaling arctan: arc tangent scaling	Optional	default from product.xml
Product_rgb	string	comma separated string of RGB products e.g., product_rgb=rhos_645,rhos_555,rhos_469.	Optional	sensor specific, see $OCDATAROOT/<sensor>/l1mapgen_defaults.par
fudge	float	fudge factor used to modify size of L3 pixels	Optional	1.0
threshold	float	minimum percentage of filled pixels before an image is generated	Optional	0

Actions/Buttons

UI Element Name	Type	Description
Browser Button	Button	Selects ifile/ofile
use_rgb	Check Box	Generate an RGB image output
trimNSEW	Check Box	Do not trim output to match input NSEW range
Load Parameters ...	Button	Reads in previously saved parameters and populates the fields in GUI.
Save Parameters ...	Button	Saves the current arguments in GUI in a file.
Run	Button	Executes the mapgen command with arguments provided in the UI.
Cancel	Button	Closes current processor GUI.
Apply	Button	Makes current arguments effective.
Open in SeaDAS	Checkbox	If selected, the ofile will be added to the open products list right after its generation.
?	Button	Displays the help content of the current command.

Common proj4 formatted projection strings for direct entry:

Albers Conic Equal Area: "+proj=aea +lat_0={latitude_of_center} +lon_0={longitude_of_center} +lat_1={standard_parallel_1}"
Cylindrical Equal Area: "+proj=cea +lat_ts={standard_parallel_1} +lon_0={longitude_of_center}"
Ease2: "+proj=cea +lat_ts=30.0 +lon_0={longitude_of_center}"
Equidistant Conic: "+proj=eqdc +lat_0={latitude_of_center} +lon_0={longitude_of_center} +lat_1={standard_parallel_1}"
Lambert Azimuthal Equal Area: "+proj=laea +lat_0={latitude_of_center} +lon_0={longitude_of_center}"
Lambert Conformal Conic: "+proj=lcc +lat_1={latitude_of_origin} +lon_0={longitude_of_origin}"
Mercator: "+proj=merc +lon_0={longitude_of_origin}"
Mollweide: "+proj=moll +lon_0={central_+meridian}"
Oblique Stereographic: "+proj=sterea +lat_0={latitude_of_origin} +lon_0={longitude_of_origin}"
PlateCaree: "+proj=eqc +lon_0={central_meridian}"
Sinusoidal: "+proj=sinu +lon_0={longitude_of_center}"
SMI: "+proj=eqc +lon_0={longitude_of_center}"
Tranverse Mercator: "+proj=tmerc +lat_0={latitude_of_origin} +lon_0={longitude_of_origin}"

Command Line Usage

usage: mapgen [-h] [--parfile PARFILE] [--ifile IFILE] [--geofile GEOFILE]
              [--ofile OFILE] [--logfile LOGFILE] [--use_rgb]
              [--product PRODUCT | --product_rgb PRODUCT_RGB]
              [--resolution RESOLUTION] [--oformat {netcdf4,png,ppm,tiff}]
              [--use_transparency] [--north NORTH] [--south SOUTH]
              [--east EAST] [--west WEST] [--projection PROJECTION]
              [--central_meridian CENTRAL_MERIDIAN] [--palfile PALFILE]
              [--fudge FUDGE] [--datamin DATAMIN] [--datamax DATAMAX]
              [--scale_type {linear,log,arctan}] [--threshold THRESHOLD]
              [--trimNSEW] [--write_projtext] [--keep-intermediates]
              [--verbose]

generate mapped output from a SeaDAS supported satellite data files
arguments can be specified on the commandline or in a parameter file
the two methods can be used together, with commandline over-riding the parfile

options:
  -h, --help            show this help message and exit
  --parfile PARFILE, -p PARFILE
                        input parameter file
  --ifile IFILE, -i IFILE
                        input file or text file list of files
  --geofile GEOFILE, -g GEOFILE
                        geolocation file or text file list of files
  --ofile OFILE, -o OFILE
                        output file name; default: <ifile>.MAP.<oformat ext>
  --logfile LOGFILE, -l LOGFILE
                        log file
                        default: mapgen_<timestamp>.log
                        <timestamp> is in seconds since Jan 1, 1970 00:00:00
                        this file is deleted if verbose is not set and no errors
                        occur during processing
  --use_rgb             generate an RGB image output
                        default: a pseudo-true color image with bands to use
                                 controlled by --product_rgb option
  --product PRODUCT     product(s) to map; comma separated
  --product_rgb PRODUCT_RGB
                        comma separated string of RGB products
                        e.g., product_rgb=rhos_645,rhos_555,rhos_469
                        default:  sensor specific, see
                        $OCDATAROOT/<sensor>/l1mapgen_defaults.par
  --resolution RESOLUTION, -r RESOLUTION
                             #.#:  width of a pixel in meters
                           #.#km:  width of a pixel in kilometers
                          #.#deg:  width of a pixel in degrees
  --oformat {netcdf4,png,ppm,tiff}
                        netcdf4: Network Common Data Form v4 file
                                   can contain more than one product
                        png:     Portable Network Graphics format image
                        ppm:     Portable PixMap format image
                        tiff:    Tagged Image File Format with georeference tags
  --use_transparency, -t
                        make missing data transparent
                        only valid for color PNG and TIFF output
  --north NORTH, -n NORTH
                        northern-most latitude; default: input file max lßatitude
  --south SOUTH, -s SOUTH
                        southern-most latitude; default: input file min latitude
  --east EAST, -e EAST  eastern-most latitude; default: input file max longitude
  --west WEST, -w WEST  western-most latitude; default: input file min longitude
  --projection PROJECTION
                         "proj" projection string or one of the following:
                            platecarree: Plate Carree (cylindrical) projection
                              projection="+proj=eqc +lat_0=<central_meridian>"
                            mollweide:   Mollweide projection
                              projection="+proj=moll +lat_0=<central_meridian>"
                            lambert:     Lambert conformal conic projection
                              projection="+proj=lcc +lat_0=<central_meridian>"
                            albersconic: Albers equal-area conic projection
                              projection="+proj=aea +lat_0=<central_meridian>"
                            mercator:    Mercator cylindrical map projection
                              projection="+proj=merc +lat_0=<central_meridian>"
                            ease2:       Ease Grid 2 projection
                              projection="+proj=cea +lon_0=0 +lat_ts=30 +ellps=WGS84
                              +datum=WGS84 +units=m +lat_0=<central_meridian>"
  --central_meridian CENTRAL_MERIDIAN
                        central meridian to use for projection in degrees east
  --palfile PALFILE     palette filename
                        default: see $OCDATAROOT/common/product.xml
  --fudge FUDGE         factor used to modify pixel search radius for mapping
  --datamin DATAMIN     minimum value for scaling (default from product.xml)
  --datamax DATAMAX     maximum value for scaling (default from product.xml)
  --scale_type {linear,log,arctan}
                        data scaling method (default from product.xml)
  --threshold THRESHOLD
                        minimum percentage of filled pixels for image generation
                        default: 0
  --trimNSEW            do not trim output to match input NSEW range
  --write_projtext      write projection information to a text file (for mapgen_overlay script)
  --keep-intermediates  do not delete the intermediate L2/L3B files produced
  --verbose, -v         let's get chatty; each occurrence increases verbosity
                        default: error
                        -v info -vv debug'