Multi-level Processor |

### Multi-level Processor

Processes a file or list of files through multiple levels.

Location
Details
Sub-Programs
Command Line Usage

#### Location

SeaDAS-Toolbox -> SeaDAS Processors -> multilevel_processor

#### Details

multilevel_processor - Main Tab

Arguments/Keywords

UI Element Name | Type | Description | Required/Optional | Default Value
ifile | file name | Input file or list of files | Required | none
odir | output directory name | output directory name | Optional | none
Parfile | text | all parameters for each section | Required | none

Actions/Buttons

UI Element Name | Type | Description
Browser Button | Button | Selects the input file/output directory
overwrite | Check Box | Overwrite existing intermediate and output files
use_existing | Check Box | Do not re-create intermediate files if they already existe
deletefiles | Check Box | Delete intermediate files
use_ancillary | Check Box | Get the ancillary data for l2gen processing
combine_files | Check Box | Combine Files for l2bin
Load Parameters | Button | Selects a parfile to load
Retain Selected IFILE | Check Box | When loading a parfile, use the ifile selected ifile instead of the ifile in the parfile
Save Parameters | Button | Write the current parfile to a file
Run | Button | Executes multilevel_processor with arguments provided in the UI
Cancel | Button | Closes current processor GUI
Apply | Button | Makes current arguments effective
? | Button | Displays the help content of the current command

multilevel_processor - Processor Chain Tab

Actions/Buttons

UI Element Name | Type | Description
Program Buttons | Button | Opens a GUI window to configure the individual step/program
+ | Check Box | When selected the processor will be added to the chain
Params | Text | Parameters passed to this step/program
Browser Button | Button | Selects the output directory for the processor
Run | Button | Executes multilevel_processor with arguments provided in the UI
Cancel | Button | Closes current processor GUI
Apply | Button | Makes current arguments effective
? | Button | Displays the help content of the current command

#### Sub-Programs

- modis_L1A
- modi_GEO
- geolocate_hawkeye
- geolocate_viirs
- l1aextract
- l1brsgen
- modis_L1B
- calibrate_viirs
- l1bgen_generic
- l2gen
- l2extract
- l2brsgen
- l2bin
- l3mapgen

#### Command Line Usage

    Usage:
        multilevel_processor [options] parameter_file

        The parameter_file is similar to, but not exactly like, parameter
        files for OCSSW processing programs:
         - It has sections separated by headers which are denoted by "["
            and "]".
        The section named "main" is required.  Its allowed options are:
            ifile - Required entry naming the input file(s) to be processed.
            use_ancillary - use near real time ancillary data
            deletefiles - delete all the intermediate data files genereated
            overwrite - overwrite any data files which already exist
            use_existing  - use any data files which already exist
            combine_files - l2bin bin all the L2 files together instead of bin each L2 file separately

            Simultaneous use of both the overwrite and use_existing options
            is not permitted.

        The names for other sections are the programs for which that section's
        entries are to be applied.  Intermediate sections which are required for the
        final level of processing do not need to be defined if their default options
        are acceptable.  A section can be empty.  The final level of processing
        must have a section header, even if no entries appear within that section.
         - Entries within a section appear as key=value.  Comma separated lists of
        values can be used when appropriate.
         - Comments are marked by "#"; anything appearing on a line after that
        character is ignored.  A line beginning with a "#" is completely ignored.

        In addition to the main section, the following sections are allowed:
            Section name:           Applicable Instrument(s):
            -------------           -------------------------
            level 1a:               modis
            geo:                    hawkeye, modis, viirs
            l1aextract:             modis, seawifs, viirs
            l1brsgen:               general, goci, hawkeye, meris, modis, seawifs, viirs
            level 1b:               general, goci, meris, modis, seawifs, viirs
            l2gen:                  general, goci, hawkeye, meris, modis, seawifs, viirs
            l2extract:              general, goci, hawkeye, meris, modis, seawifs, viirs
            l2brsgen:               general, goci, hawkeye, meris, modis, seawifs, viirs
            l2bin:                  general, goci, hawkeye, meris, modis, seawifs, viirs
            l3mapgen:               general, goci, hawkeye, meris, modis, seawifs, viirs

        Example:

        # Sample par file for multilevel_processor.
        [main]
        ifile=2010345034027.L1A_LAC
        [l2gen]
        l2prod=chlor_a
        # final processing level

    Options:
      --version             show program's version number and exit
      -h, --help            show this help message and exit
      -d, --deletefiles     delete files created during processing
      --ifile=IFILE         input file
      --output_dir=ODIR, --odir=ODIR
                            user specified directory for output
      --overwrite           overwrite files which already exist (default = stop
                            processing if file already exists)
      --use_existing        use files which already exist (default = stop
                            processing if file already exists)
      --combine_files       combine files for l2bin instead of binning each file
                            separately
      -v, --verbose         print status messages to stdout