limb
index
/users/schrei_f/src/py4CAtS/art/limb.py

od2limb
 
vertical optical depth to effective height
 
usage:
od2limb   [options]  opticalDepthFile
 
-h              help
-c    char      comment character(s) used in input,output file (default '#')
-o    string    output file for saving of radiances (if not given: write to StdOut)
 
-C              flag indicating that input optical depth is cumulative (default: difference/delta/layer od)
-R              planetary radius (default Earth 6371.23e5cm)
-s              flag: include surface limb path (i.e. zero tangent point altitude) with zero transmission
-v              flag: verbose
-x   Interval   lower,upper wavenumbers (comma separated pair of floats [no blanks!],
                                         default set according to range of optical depth in datafiles)
 
WARNING:
od2limb  does not know the type of optical depth (delta or accumulated ...) given in the input file!
         ===> use the -C flag if you have (ac)cumulated optical depth

 
Modules
       
numpy

 
Functions
       
dod2eh(dodList, rEarth=637123000.0, surface=False, ehOnly=True, kilometer=False, srf=None, hwhm=1.0)
Given vertical optical depths, compute effective height spectrum.
 
 ARGUMENTS:
 ----------
 
 dodList:       delta (layer) vertical optical depths (a list of odArray's)
 rEarth:        radius of Earth (default 6371.23e5cm) or planet
 surface:       flag (default False):  add limb path with zero transmission hitting surface
 ehOnly:        flag (default True): return only effective height (if False: wavenumber grid and effective height)
 kilometer:     flag (default False):  return effective height in km (instead of cm)
 srf:           spectral response function, default None, choices: B[ox], T[riangle], G[auss]
 hwhm:          half width (at half maximum) of srf
 
 RETURNS:
 --------
[vGrid:          optional, only when `wavenumbers' flag is set]
 effHgt:         a numpy array of effective heights
dod2limb(dodList, zTangent=None, rEarth=637123000.0)
Given vertical optical depths, compute limb optical depth.
 
ARGUMENTS:
----------
 
dodList:       delta (layer) optical depths (a list of odArray's)
zTangent:      tangent altitude
               Default: None ===> compute od for all tangent points = levels
               NOTE:  values <=200 are interpreted as kilometer
rEarth:        radius [cm] of Earth (default 6371.23e5cm) or planet
 
RETURNS:
--------
odArray:       a subclassed numpy array with optical depth along with some attributes
               or a list of odArrays (for a list of tangents)
 
NOTE:
-----
* dod2limb assumes a symmetric path space-tangent-space
* tangent points inside layers, i.e. different from levels, not supported (no interpolation etc.)

 
Data
        radiusEarth = 637123000.0