Meris Case-2 Regional Processor Description

Please note: The chapter Data Processors - Introduction provides a general description for all BEAM data processors. It describes the common graphical user interface (GUI), the command-line interface and the common processing request file format.

Content

  • The In- and Output Parameters tab
  • The Processing Parameters tab
  • Description of the Processing Parameters
  • The Processing Request File
  • The In- and Output Parameters tab

    1. Input product file: Select the input product file by either typing the product path into the text field or by pressing the file selection button to invoke a standard file dialog.
    2. Output product file: Select the output product file by either typing the product path into the text field or by pressing the file selection button to invoke a standard file dialog.
    3. Output product format: Select one of the available output product formats.
    4. Log filename prefix: Select the prefix of the log file.
    5. Extra log to output directory: Select whether to write an additional log file to the directory selected for the output product.

    The Processing Parameters tab

    1. Save  Saves the edited parameters to a file.
    2. Restore  Resets the edited parameters text to the default text.
    3. You can select a file where the processing parameters are stored. This file has to be a *.txt or a *.properties file.

    In the text field you can edit and adjust the processing parameters for the current run of the processor.

    Format of the Parameter File

    This file uses a Java property file syntax. It is composed of lines which are key-value pairs in the form
       <key> = <value>
    Lines with a preceding # are comment-lines and will not be interpreted.
    If a given key is not known by the processor it will be ignored. When a parameter file does not contain a parameter of the processor, this parameter will be set to its default value.

    Description of the Processing Parameters

    Number Parameter Default Value Description
    1 waterNnInverseFilePath
    waterNnForwardFilePath
    atmCorrNnFilePath
    polCorrNnFilePath
    ./water_net_20020807/60x20x5_639.4.net
    ./water_net_20020807/15x20_144.8.net
    10x20_155.2.net
    18_518.1.netPolEffekt
    Paths and names of the neural network files: a relative path is assumed to be relative to ${BEAM-HOME}\auxdata\merisc2r.
    2 inputValidMask not l1_flags.INVALID and not l1_flags.SUSPECT and not l1_flags.LAND_OCEAN and not l1_flags.BRIGHT and not l1_flags.COASTLINE An arithmetic expression which defines the valid pixels for the processing. Pixels which are not valid are skipped by the processor.
    3 performSmileCorrection false Switch the smile correction on and off.
    4 outputAPig
    outputAGelb
    outputBTsm
    outputATotal
    true
    true
    true
    Select which of the IOP products shall be included in the output file. All are given for MERIS band 2 (443 nm).
    outpuAPig := absorption coefficient of phytoplankton pigments
    outputAGelb := absorption coefficient of yellow substance and of all particles after bleaching
    outputBTsm := scattering coefficient of all particles outputATotal := total absorption of water constituance
    5 outputKmin
    outputZ90max
    true
    true
    Select which of the transparency variables shall be included in the output file.
    outputKmin := downwelling irradiance atenuation coefficient
    outputZ90max := inverted value of Kmin
    6 outputChlConc
    outputTsmConc
    true
    true
    Select which of the concentrations shall be included in the output file.
    outputChlConc := chlorophyll concentration (mg m-3)
    outputTsmConc := total suspended matter dry weight (g m-3)
    7 outputAngstrom
    outputTau
    true
    true
    Controls the output of the angstrom coefficient (ang_620_681) and the spectral aerosol optical depth (tau_681).
    8 outputOutOfScopeChiSquare true Controls the Output of the chi2 value, i.e. the squared difference between measured and simulated water leaving radiance reflectances, shall be included in the product. A low value in the product indicates a higher success in the retrieval and that the conditions, which have led to the measured spectrum, are in (sufficient) agreement with the conditions and the bio-optical model used in the simulations for training the neural network. A value above a threshold of presently 4.0 triggers the out of training range == out of scope flag.
    9 performChiSquareFit
    outputFitAPig
    outputFitBTsm
    outputFitTsmConc
    outputFitChlConc
    outputFitAGelb
    outputChiSquareFit
    outputNIter
    false
    true
    true
    true
    true
    true
    true
    true
    Perform the optimization fitting algorithm, this has to be set true if the concentrations shall be computed alternatively or in addition using the optimization procedure. However, this procedure requires more computation time, but the results are normally improved.
    10 useInvNN
    nIterMax
    nu
    tau
    eps1
    eps2
    false
    30
    2.0
    0.05
    0.01
    0.0003
    Parameters used to control the optimization.
    Please leave them unchanged presently.
    11 performPolCorr true Controls if the polarisation correction should be included in the atmospheric correction procedure. This part is presently very experimental and has not been verified so far.
    12 tsmConversionFactor
    tsmConversionExponent
    1.73
    1.0
    Factors for converting particle scattering into total suspended matter dry weight.
    Ctsm (g m-3) = tsmConversionFactor * b443^tsmConversionExponent
    13 chlConversionFactor
    chlConversionExponent
    21.0
    1.04
    Factors for converting absorption of phytoplankton pigment at 443 into chlorophyll concentration.
    Chlorophyll (mg m-3) = chlConversionFactor a_pig443^chlConversionExponent
    14 maxWaterToaRadRefl14
    maxLandToaRadRefl14
    0.02
    0.2
    The maximum toa radiance reflectance for water and land pixels.
    15 spectrumOutOfScopeThreshold 4.0 The out of scope (= out of training range) flag will be set if the chi2 value is above the given threshold.
    16 outputPathRadianceReflAll
    outputPathRadianceRefl.[1 - 9]
    false
    true
    outputPathRadianceReflAll sets the default value for all values of the outputPathRadianceRefl.
    outputPathRadianceRefl.# defines (separately for each band) if path radiance reflectance shall be included in output product.
    17 switchToIrradianceReflectance false Controls if the water leaving reflectances shall be written out as irradiance reflectances.
    18 outputWaterLeavingReflAll
    outputWaterLeavingRefl.[1 - 9]
    false
    true
    outputWaterLeavingReflAll sets the default value for all values of outputWaterLeavingRefl.
    outputWaterLeavingRefl.# defines (separately for each band) if path radiance reflectance shall be included in output product.
    19 outputTransmittanceAll
    outputTransmittance.[1 - 9]
    false
    true
    outputTransmittanceAll sets the default value for all values of outputTransmittance.
    outputTransmittance.# defines (separately for each band) if path radiance reflectance shall be included in output product.
    20 outputToaReflAll outputToaRefl.[1 - 10,12,13] outputToaRefl.[11,14,15] false
    true
    false
    outputToaReflAll sets the default value for all values of outputToaRefl.
    outputToaRefl.# defines (separately for each band) if path radiance reflectance shall be included in output product.
    21 outputTosaReflAll outputTosaRefl.[1 - 15] false
    false
    outputTosaReflAll sets the default value for all values of outputTosaRefl.
    outputTosaRefl.# defines (separately for each band) if path radiance reflectance shall be included in output product.

    The Processing Request File

    The following table describes the Meris Case-2 Regional processor specific processing request file contents. For a detailed description of the processing request file concept and file specification please look at chapter Data Processors - Introduction.

    Parameter name Description Type Valueset
    type Request type. Mandatory attribute of the Request element String "MERISC2R"
    property_file Path or URL to the parameter file String