• The -extract/... argument must be accessible: lowercase -e
• beware that the adequate -extract... argument must be read first, so that 4SM
  • either reads the proper textfile for calibration data
  • or extracts a proper textfile
• If no -extract... argument has been read, then 4SM shall stop!

-Calibrate/voAIN/BdsNpzG/bDh_12_13  
-Calibrate/voAIN/BdSNpZG/BC_8_5_3_2/BDh_12_13_34 

• -Calibrate/voAIN/BdSNpZg/BDh_12_13
  • abridged version for a GRN image like SPOT 1, 
  • all other parameters are read from textfile 4sm.def
• -Calibrate/voAIN/BdSNpZg/BDh_12_13_34
  • abridged version for a BGRN image like Landsat TM, Quickbird, 
  • all other parameters are read from textfile 4sm.def
• -Calibrate/voAIN/BdSNpZG/BC_8_5_3_2/BDh_12_13_34
  • ?when more than 4 bands must be calibrated

• V...............Verbose mode                   v.................silent mode
• O...............Optimizerflag=1                o.................Optimizerflag=0
• A...............CalibrateAll=1                    a................CalibrateAll=0
• I................plot Isobath lines               i.................IsoB=0
• N.......plot normalized_linearized data   n................natural_linearized data

• B(b).........to plot (or not) the Brightest_Pixels_Line with stars
• D(d).........to plot (or not) the Darkest_Pixels_Line with crosses
• S(s)..........to plot (or not) the Soil_Line with circles
  • if above S is enabled: any one of the following four options
    • M.........to select SOIL_Line using mSOIL
    • D.........to select SOIL_Line using average DPL
    • N.........to select SOIL_Line using Red/Nir and CSL
    • 1...........to select SOIL_Line using Z=0.1 in imageZ
• P(p)................to plot (or not) all mSOIL_Pixel_Soil with points (obsolete)
• Z(z)................to plot (or not) Z inserts
• G(g)...............to plot (or not) ghost pixels

• 3 or 4 bands images (SPOT, Landsat TM and ETM)
  • not needed for a GRN or BGRN image
• All images with more than 4 bands:
  • four wavebands at most may be specified
    • for a N-bands image, four wavebands MUST be specified,
    • like   ..../16_12_9_1/....     in order of decreasing wavelength please

• B(b)..............bidim histograms to be plotted (or not)
  • B............to.......plot bidim histograms
  • b............to NOT plot bidim histograms
• D(d)
  • D............to plot Bidim histogram as a backdrop of model lines
  • d.............to plot ONLY a bare bidim histogram
• H(h)...............a choice of Brighter or Darker BiDim rendering
  • H.........for a brighter BiDim rendering
  • h.........for a darker    BiDim rendering
• for Choice of 2 or 3 pairs of bands
  • for a 3-bands image: 
    • either .../BDh_12_13
    • or ......../BDh_12_23
  • for a 4 bands image: add either _14 or_ 24 or_34
  • for a N-bands image,  the number of combinations is more plentyfull

• for a 3  bands image, all 3 bands are processed: -Calibrate/.../BDh_12_23
• for a 4  bands image, all 4 bands are processed: -Calibrate/.../BDH_12_23_34
• for a N bands image, only 4 bands are processed at once,
  • like -Calibrate/..../16_12_9_1/BDH12_23_34, 
  • and the practitioner shall iterate on band combinations until all wavebands are correctly calibrated.

• After alterations in the command line, and upon termination of the display,
  • the calibration command line is automatically executed again, etc,
  • until the practitioner is eventually satisfied
    • and kills the process manually on the session screen: "CTRL C".
  • Loop: by closing the display, the calibration.sh  script goes on to run the command line again
    •  see at the end of this script: you may disable the last line "#./tarawa-subset.sh"
• This requires though that the shell script be named by the name of the PCI database with a .sh suffix, like tarawa-subset.sh here for database tarawa-subset.pix
• Beware though that this automatic restart procedure causes several 4SM process to remain sleeping:
  • see System Monitor
  • 4SM now kills them automatically before modeling, in order to free resources

• V(v)................to display full details on screen
• O(o)................to optimize the calibration

• A(a)................to specify which pair is to be displayed
  • A......display all pairs at once, superposed
  • a......display one pair only, specified in ..../BDh_12_13_34  bidim argument
    • 13 or 23                             
    • 14 or 24 or 34

• I(i).................to display isobath lines
  • by steps of 2.5 meter with      BDH backdrop
  • by steps of 1.0 meter without BDH backdrop??

• N(n)...............plot linearized natural_or_normalized data
  • n.............to display linearized natural       data:
    • X=log(Ls-Lsw)
  • N.............to display linearized normalized data
    • X=log((Ls-Lsw)*(200/(LsM-Lsw))

CALIBRATION PLOT OPTIONS

 -Calibrate/.../BDSMPZG/...