mapgen |

### 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-Toolbox -> 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, -p PARFILE
                            input parameter file
      --ifile, -i IFILE     input file or text file list of files
      --geofile, -g GEOFILE
                            geolocation file or text file list of files
      --ofile, -o OFILE     output file name; default: <ifile>.MAP.<oformat ext>
      --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, -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, -n NORTH     northern-most latitude; default: input file max lßatitude
      --south, -s SOUTH     southern-most latitude; default: input file min latitude
      --east, -e EAST       eastern-most latitude; default: input file max longitude
      --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'