l3mapgen

l3mapgen

Creates a Level 3 mapped image.

Location
Details
Command Line Usage

Location

Tools -> OCSSW Processing -> l3mapgen

<

Details

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

l3mapgen GUI

Arguments/Keywords
UI Element Name Type Description Required/Optional Default Value
ifile Text Field Input Level 3 bin file name. Required
ofile Text Field Output filename for generated level 3 image file. Required
palfile Text Field palette file name Optional the palette is chosen using the product.xml file
palette_dir Text Field palette directory Optional $OCDATAROOT/common/palette
product string product(s) to map Required
resolution string size of the output pixel in meters or SMI dimensions: 
         90km: 432 x 216 image for full globe
         36km: 1080 x 540
         18km: 2160 x 1080
         9km: 4320 x 2160
         4km: 8640 x 4320
         2km: 17280 x 8640
         1km: 34560 x 17280
         hkm: 69120 x 34560
         qkm: 138240 x 69120
         smi: 4096 x 2048
         smi4: 8192 x 4096
         land: 8640 x 4320
         #.#:  width of a pixel in meters
         #.#km:  width of a pixel in kilometers
         #.#deg:  width of a pixel in degrees
Optional 9km
oformat string format of the output file : 
                 netCDF:  netCDF file, can contain more than one product
                 hdf4:    HDF4 file (old SMI format)
                 png:     PNG image file
                 ppm:     PPM image file
                 geoTIFF: TIFF file with georeference tags
Optional netCDF
projection string One of the following predefined (proj4) projections may be selected: 
     albersconic: "+proj=aea +lon_0={central_meridian}"
     ease2: "+proj=cea +lat_ts=30.0 +lon_0={central_meridian}"
     lambertconformal: "+proj=lcc +lon_0={central_meridian}"
     mercator: "+proj=merc +lon_0={central_meridian}"
     mollweide: "+proj=moll +lon_0={central_meridian}"
     platecaree:"+proj=eqc +lon_0={central_meridian}"
     raw: raw dump of the bin file
     smi: "+proj=eqc +lon_0={central_meridian}"

     Proj4 strings can also be directly entered.
     (See below for a listing of common proj4 formatted strings.)
Optional smi
central_meridian float central meridian for projection in deg east. Only used
for convenience projections and assumes whole earthe from east to west.		 Optional 0
interp string interpolation method: 
     nearest: Nearest Neighbor
     bin:     bin all of the pixels that intersect the
                area of the output pixel
     area:    bin weighted by area all of the pixels that
                intersect the area of the output pixel
Optional nearest
north float Northern most Latitude Optional 90.0
south float Southern most Latitude Optional -90.0
east float Eastern most Longitude Optional 180.0
west float Western most Longitude Optional -180.0
apply_pal boolean apply color palette: 
            yes: color image
            no: grayscale image
Optional yes
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
Optional default from product.xml
pversion string Processing version string Optional
deflate int deflation level Optional 4
quiet boolean stop the status printing Optional false

Actions/Buttons
UI Element Name Type Description
Browser Button Button Selects infile/ofile
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 l2mapgen 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: l3mapgen argument-list

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

      The argument-list is a set of keyword=value pairs. The arguments can
      be specified on the commandline, or put into a parameter file, or the
      two methods can be used together, with commandline over-riding.

    The list of valid keywords follows:

       -help (boolean) (alias=-h,--help) (default=false) = print usage information
       -version (boolean) (alias=--version) (default=false) = print the version
            information
       -dump_options (boolean) (alias=--dump_options) (default=false) = print
            information about each option
       -dump_options_paramfile (ofile) (alias=--dump_options_paramfile) = print
            information about each option to paramfile
       -dump_options_xmlfile (ofile) (alias=--dump_options_xmlfile) = print
            information about each option to XML file
       par (string) = input parameter file
       ifile (ifile) = input L3 bin file name
       ofile (ofile) (default=output) = output filename
       product (string) = product(s) to map
       resolution (string) (default=9km) = size of the output pixel in meters or
            SMI dimensions
            90km: 432 x 216 image for full globe
            36km: 1080 x 540
            18km: 2160 x 1080
             9km: 4320 x 2160
             4km: 8640 x 4320
             2km: 17280 x 8640
             1km: 34560 x 17280
             hkm: 69120 x 34560
             qkm: 138240 x 69120
             smi: 4096 x 2048
            smi4: 8192 x 4096
            land: 8640 x 4320
             #.#:  width of a pixel in meters
           #.#km:  width of a pixel in kilometers
          #.#deg:  width of a pixel in degrees
       oformat (string) (default=netCDF) = output file format
            netCDF:  netCDF file, can contain more than one product
            hdf4:    HDF4 file (old SMI format)
            png:     PNG image file
            ppm:     PPM image file
            geoTIFF: TIFF file with georeference tags
       ofile2 (ofile) = output2 filename
       oformat2 (string) (default=png) = output2 file format
       projection (string) (default=smi) = proj.4 projection string or one of the
            following predefined projections:
            smi:       Standard Mapped image, cylindrical projection, uses
                       central_meridian
                       projection="+proj=eqc +lat_0="
    mollweide: Mollweide projection
    projection="+proj=moll +lat_0=
    "
        raw: raw dump of the bin file
        central_meridian (float) (default=0) = central meridian for projection in
        deg east. Only used for smi, mollweide and raw projection
        interp (string) (default=nearest) = interpolation method:
        nearest: Nearest Neighbor
        bin: bin all of the pixels that intersect the area of the
        output pixel
        area: bin weighted by area all of the pixels that intersect
        the area of the output pixel
        north (float) (default=90.0) = Northern most Latitude
        south (float) (default=-90.0) = Southern most Latitude
        east (float) (default=180.0) = Eastern most Longitude
        west (float) (default=-180.0) = Western most Longitude
        apply_pal (boolean) (default=yes) = apply color A palette:
        yes: color image
        no: grayscale image
        palfile (ifile) = palette filename. (default = means the palette
        is chosen using the product.xml file
        palette_dir (ifile) (default=$OCDATAROOT/common/palette) = directory
        containing the palette files
        datamin (float) = minimum value for scaling (default from product.xml)
        datamax (float) = maximum value for scaling (default from product.xml)
        scale_type (string) = data scaling type (default from product.xml)
        linear: linear scaling
        log: logarithmic scaling
        quiet (boolean) (default=false) = stop the status printing
        pversion (string) (default=Unspecified) = processing version string
        use_quality (boolean) (default=yes) = should we do quality factor processing
        deflate (int) (default=4) = deflation level