Mandatory sections | ||
---|---|---|
*HDR | 1. Comment record written to output file headers | |
*FLG | 2. Option flags | |
*SCN | 3. Nominal altitudes of spectra in full limb scan | |
*LEV | 4. Nominal retrieval levels | |
*RTV | 5. Target quantities to be retrieved | |
*MWL | 6. Microwindow list files | |
*MDB | 7. Microwindow Database files | |
*L1C | 8. Input spectra | |
*CLI | 9. Climatological profiles | |
*ILS | 10. Instrument Line Shape files | |
*FOV | 11. Field of View Shape | |
Optional sections | ||
*ACC | Accuracy settings | |
*ACV | A Priori Covariance | |
*ASD | A Priori Standard Deviation | |
*CLD | Cloud Detection Criteria | |
*CNV | Convergence Criteria | |
*FMZ | Forward Model Altitudes | |
*HIT | HITRAN Database | |
*L2P | Level 2 Input Profiles | |
*LUT | Directories for Look Up Tables | |
*NTE | Vibrational Temperatures for non-LTE forward model | |
*OUT | Rename Output Files | |
*SHP | Specify line shapes for line-by-line calculations | |
*XSC | Directories for Molecular Cross Sections | |
Termination Record | ||
*END |
*ABCwhere ABC is some code (case-insensitive) defining the contents of the section. These 4 characters have to occupy the first 4 positions in the record.
The driver table is terminated with
*END(remember to add a <CR> after the *END)
The first 11 sections (*HDR ... *FOV) are mandatory and the sequence is fixed. Thereafter sections are optional and in any order.
Only the first 4 characters of any record starting with * are read, so comments may be added to these records without any exclamation mark if you need to remind yourself what each does
The rest of this document describes the contents
of each section.
*HDR Section (#1)
*HDR
O3 Rtvl generated with morse.drv 14NOV04 ! [and this part won't be written]
*FLG Section (#2)
APR
Output A Priori information
(morse.apr)
CLD
Use cloud detection
COV
Output covariance matrix
(morse.cov)
CTM
Use molecular (eg H2O) continuum data
DIA
Output iteration diagnostics
(morse.dia)
FGD
Use full, as opposed to irregular, grid
(v19NOV04 onwards - see Note 2)
FVZ
Suppress FOV distortion due to refraction
GEO
Use geometric (ie non-refractive) ray paths
GRD
Use irregular spectral grid where available
(up to v18NOV04 - see Note 2)
HYD
Use hydrostatic constraint (PRE + TEM retrieval only)
LIN
Assume VMR varies linearly with altitude rather than logarithmically
LUT
Use Look-Up Tables for absorption coefficients where available
(up to v18NOV04 - see Note 2)
MWO
Write outputs for each microwindow
NOM
Use nominal sweep altitudes instead of actual
QAD
Use simple quadratic fit to line wings rather than
inverse quadratic
RES
Output residual spectra (v25NOV04
onwards )
(morse.res)
TRA
Use transmittance rather than radiance measurements
*FLG
CLD HYD FVZ
*SCN Section (#3)
*SCN
68 60 52 47 42 39 36 33 30 27 24 21 18 15 12 9 6 ! Nominal scan
*LEV Section (#4)
*LEV
12 15 18 21 24 27 30 33 36 39 42 47 52 60 68 76 ! Retrieve 12-76km
*RTV Section (#5)
TEM Temperature [K]
PRE Pressure [mb]
CTM Continuum [/km]
OFF Radiometric Offset
[nW/(cm2.sr.cm-1)]
[Molecule] Species VMR
[ppmv]
*RTV
TEM PRE CTM O3 H2O(1) H2O(2) ! Joint pT, O3, ctm and main two H2O isotopes
*MWL Section (#6)
*MWL
pt_000.lst ! pT microwindows
h2o_000.lst ! plus H2O microwindows for a joint retrieval with pT
*MDB Section (#7)
*MDB
MW_PT__103.DAT MW_H2O_103.DAT ! pT & H2O microwindows
*L1C Section (#8)
*L1C
L1C_02081_SCAN#02 ! Scan#2, orbit 2081
*CLI Section (#9)
*CLI
day.atm ! Mid-latitude dayime profiles
aerosol.atm ! zero extinction aerosol profile
h2o.atm ! H2O retrieved from previous scan (so different alt.grid)
*ILS Section (#10)
*ILS
mipas_a.ils ! MIPAS A band AILS
mipas_ab.ils ! MIPAS AB band AILS
nbstrong.ils ! Idealised Norton-Beer Strong ILS for other bands
*FOV Section (#11)
*FOV
rfm_1km5.fov ! 5 pt representation of MIPAS FOV @1.5km spacing
*ACC Section (Optional)
Setting Definition Default
NGJACC=[integer]
Number of gases for which Jacobians are computed
No. rtvd species
PGCACC=[real]
Fractional change in pressure requiring new C-G path calc
0.01
TGCACC=[real]
Change in temperature [K] requiring new C-G path calc
0.1
JCPACC=[real]
Fraction of Jacobian perturbation requiring additional path
0.01
JCCACC=[real]
Fraction of Jacobian perturbation requiring new C-G path calc
0.5
*ACC
NGJACC=4 TGCACC=0.2
*ACV Section (Optional)
SA' = SA*EXP(-R) + SC*(1-EXP(-R))
where SA' is the A Priori covariance actually used to
start of the retrieval,
SA is the covariance read from the file specified in this section,
and SC is the climatological covariance constructed in the same way as
the default a priori (including modifications in the
*ASD section). A value RELAX=0.0 (which is
the default) means that the specified A Priori covariance is used
exactly as supplied, a value RELAX=0.1 implies relaxing to
climatological covariance with a 1/e time constant equivalent to
10 scans, 0.01 is a hundred scans, etc.
*ACV
morse.cov ! Use previous output covariance
relax=0.05 ! Climiatological relaxation length: 20 profiles, or ~1/4 orbit
*ASD Section (Optional)
Setting Definition Units Valid Range Default
CORREL=[real]
Correlation length [km] 0:100 50km
TEM=[real]
Temperature SD [K] 0.1:1000 10K
PRE=[real]
Pressure SD [%] 0.1:1000 50%
[molecule]=[real]
VMR SD [%] 0.1:1000 100%
*ASD
CORREL=0 ! Uncorrelated A Priori
CH4=10 ! Change CH4 to 10% uncertainty
*CLD Section (Optional)
Setting Definition Default
IDXCLD=[real]
Maximum Cloud Index (-1 or positive) 1.8
RADCLD=[real]
Minimum Cloud Radiance (-1 or positive) 125.0 [nW/(cm2.sr.cm-1)]
TOPCLD=[real]
Maximum Cloud Altitude (-1 or positive) 30.0 [km]
*CLD
RADCLD=-1 ! Remove Cloud Radiance threshold test
CLDIDX=2.2 ! Set more stringent Cloud Index threshold
*CNV Section (Optional)
Setting Definition Default
MAXITR=[integer]
Maximum number of iterations (GE 1) 10
CHILIM=[real]
Minimum value of ChiSq for convergence 1.0
DELCHI=[real]
Minimum Change in ChiSq for convergence 0.1
*CNV
CHILIM=2.0 MAXITR=5
*FMZ Section (Optional)
*FMZ
3 4 5 6 7 8 9 10 11 12 13 14 15 18 21 24 27 30 33 36 39 42
47 52 60 68 76 85 100 120
*HIT Section (Optional)
*HIT
../morse_files/hitran_mipas.bin
*L2P Section (Optional)
*L2P
morse_pt.atm ! Input retrieved pT profile
morse_h2o.atm ! Input retrieved H2O profile
*LUT Section (Optional)
*LUT
../morse_files/CS/pt/ ! pT LUTs
../morse_files/CS/o3/ ! O3 LUTs
*NTE Section (Optional)
*NTE
co2_day_amil2da.nte ! Use mid-lat daytime vib.temps
h2o_day_amil2da.nte
o3_day_amil2da.nte
*OUT Section (Optional)
Setting Definition Default
DIR=[directory]
Output directory [local directory]
ACV=[filename]
A Priori Covariance morse.acv
APR=[filename]
A Priori Vector morse.apr
ATM=[filename]
Retrieved Atmosphere morse.atm
COV=[filename]
Retrieval Covariance morse.cov
DIA=[filename]
Diagnostics morse.dia
RES=[filename]
Residual Spectra morse.res
RTV=[filename]
Retrieval Vector morse.rtv
*OUT
APR=morse_pt.apr
cov=./cov/morse_pt.cov
dir=../Morse_Outputs/
*SHP Section (Optional)
[molecule]=VOI
Voigt line shape
[molecule]=CHI
Chi Factor
[molecule]=LOR
Lorentz line shape
[molecule]=DOP
Doppler line shape
*=[any of the above]
Set lineshape for remaining `line' molecules
*SHP
co2=chi ! Chi factor for CO2
o3=doppler h2o=dop ! Doppler for O3 and H2O
*=lorentz ! Lorentz for everything else
*XSC Section (Optional)
*XSC
./ ! just aerosol.xsc in current directory
../morse_files/ ! directory for all other .xsc files