VLIDORT User's Guide

More documents

Recommendations

Info

the use of a toggle (OMEGA_SMALLNUM) to avoid the conservative scattering case when thetotal single scattering albedo is exactly unity.The following five indices are also used to indicate error status for the package or any part of it:• VLIDORT_SUCCESS = 0 (status index for a successful execution; no log-output).• VLIDORT_DEBUG = 1 (status index for a debug execution; debug log-output).• VLIDORT_INFO = 2 (status index for a successful execution; informational log-output).• VLIDORT_WARNING = 3 (status index for a successful execution; warning log-output).• VLIDORT_SERIOUS = 4 (status index for an aborted execution; failure log-output).If the output is not completely successful in any way (status not equal to VLIDORT_SUCCESS),then the model's exception handling system will generate a number of error messages, dividedinto two types: (1) messages from the checking of input optical properties and control variables,and (2) messages and subroutine traces arising from a failed execution. The “Warning” statuswas introduced in Version 2.4 to deal with incorrect user-defined input values that can be re-setinternally to allow the program to complete.There is an additional set of indices for the BRDF kernels. Thus for a polarized Co-x Munk oceanglitter reflection, the index name is GISSCOXMUNK_IDX and has the value 10. These indicesapply only to the BRDF supplement software; more details are found in section 6.4.2.1.2. Definition files – I/O type structuresIn this section, we list the Fortran f90 type structures used to classify the input and outputvariables to the Fortran 90 code. An overview list of all structures is presented in Table 4.2below. Each type structure variable is specified by its type and assigned I/O intent, and thecomponent variables are listed in the individual tables to be found in Appendix 6.1. For the mostpart, the structures are based on the FORTRAN 77 "Include" files featured in older versions ofVLIDORT. Note the structure levels cited in the second column of Table 4.2. Primary structures(level 1) are seen in a VLIDORT call statement, whereas structures with a level > 1 areembedded within their associated parent structures.For the main VLIDORT program vlidort_masters.f90, the I/O variables are divided intofour level-1 type structures: three input and one output. The three main input structure variablesand their component structures are specified in Tables A1-A8, B1-B7 and C1-C4 in Appendix6.1. The main output structure and its components (which return intensities and fluxes) are listedin tables D1-D4. For calls to vlidort_l_masters.f90, we require these four structures plusfour additional linearized ones: again, three input and one output. The three main linearized inputstructure variables and their component structures are specified in tables E1-E3, F1-F2 and G1-G4. The main linearized output structure and its components (which return the columnatmospheric, profile atmospheric, and surface property Jacobians) are listed in tables H1-H4.Most inputs are "Intent(in)", but a few may be modified internally during a VLIDORT call as theresult of a check, which is followed by a warning message that a particular input has been given adefault value in order to proceed with code execution - these inputs are "Intent(inout)". The typestructures which contain input variables which can be internally modified carry a “Modified”label in their name. All outputs are "Intent(out)".56
Table 4.2 Summary of VLIDORT I/O Type structuresVLIDORT I/O Type StructureStructureLevelIntent Table #VLIDORT_Fixed_Inputs 1 Input A1VLIDORT_Fixed_Boolean 2 Input A2VLIDORT_Fixed_Control 2 Input A3VLIDORT_Fixed_Sunrays 2 Input A4VLIDORT_Fixed_UserValues 2 Input A5VLIDORT_Fixed_Chapman 2 Input A6VLIDORT_Fixed_Optical 2 Input A7VLIDORT_Fixed_Write 2 Input A8VLIDORT_Modified_Inputs 1 Input/Output B1VLIDORT_Modified_Boolean 2 Input/Output B2VLIDORT_Modified_Control 2 Input/Output B3VLIDORT_Modified_Sunrays 2 Input/Output B4VLIDORT_Modified_UserValues 2 Input/Output B5VLIDORT_Modified_Chapman 2 Input/Output B6VLIDORT_Modified_Optical 2 Input/Output B7VLIDORT_Sup_InOut 1 Input/Output C1VLIDORT_Sup_BRDF 2 Input C2VLIDORT_Sup_SS 2 Input/Output C3VLIDORT_Sup_SLEAVE 2 Input C4VLIDORT_Outputs 1 Output D1VLIDORT_Main_Outputs 2 Output D2VLIDORT_Exception_Handling 2 Output D3VLIDORT_Input_Exception_Handling 2 Output D4VLIDORT_Fixed_LinInputs 1 Input E1VLIDORT_Fixed_LinControl 2 Input E2VLIDORT_Fixed_LinOptical 2 Input E3VLIDORT_Modified_LinInputs 1 Input/Output F1VLIDORT_Modified_LinControl 2 Input/Output F2VLIDORT_LinSup_InOut 1 Input/Output G1VLIDORT_LinSup_BRDF 2 Input G2VLIDORT_LinSup_SS_InOut 2 Input/Output G3VLIDORT_LinSup_SS_Col 3 Input/Output G3-1VLIDORT_LinSup_SS_Prof 3 Input/Output G3-2VLIDORT_LinSup_SS_Surf 3 Input/Output G3-3VLIDORT_LinSup_SLEAVE 2 Input G4VLIDORT_LinOutputs 1 Output H1VLIDORT_LinCol 2 Output H2VLIDORT_LinProf 2 Output H3VLIDORT_LinSurf 2 Output H4Many input variables may be set by either writing explicitly coded statements in the callingprogram or reading entries from an ASCII-type input configuration file. In the latter case, one canuse dedicated VLIDORT software to read this file. This file-read software looks for characterstrings which indicate the input variable or variables to be assigned. We discuss this in more57
Page 1:
User’s GuideVLIDORTVersion 2.6Rob
Page 5 and 6: Table of Contents1H1. Introduction
Page 7 and 8: 1. Introduction to VLIDORT1.1. Hist
Page 9 and 10: Table 1.1 Major features of LIDORT
Page 11 and 12: In 2006, R. Spurr was invited to co
Page 13: corrections, and sphericity correct
Page 16 and 17: Matrix Π relates scattering and in
Page 18 and 19: m⎛ P⎞l( μ)0 0 0⎜⎟mmm ⎜ 0
Page 20 and 21: In the following sections, we suppr
Page 22 and 23: of the single scatter albedo ω and
Page 24 and 25: Here T n−1 is the solar beam tran
Page 26 and 27: ~ + ~ ~ (1)~ ~ + ~ ~ (2)~ ~ − ~ 1
Page 28 and 29: The solution proceeds first by the
Page 30 and 31: Linearizations. Derivatives of all
Page 32 and 33: For the plane-parallel case, we hav
Page 34 and 35: One of the features of the above ou
Page 36 and 37: L↑↑ ↑k (cot n −cotn −1)[
Page 38 and 39: Note the use of the profile-column
Page 40 and 41: βl,aer(1)(2)fz1e1βl+ ( 1−f ) z2
Page 42 and 43: For BRDF input, it is necessary for
Page 44 and 45: streams were used in the half space
Page 46 and 47: anded tri-diagonal matrix A contain
Page 48 and 49: in place to aid with the LU-decompo
Page 50 and 51: In earlier versions of LIDORT and V
Page 53 and 54: 4. The VLIDORT 2.6 package4.1. Over
Page 55: (discrete ordinates), so that dimen
Page 59 and 60: Table 4.3. Module files in VLIDORT
Page 61 and 62: Finally, modules vlidort_ls_correct
Page 63 and 64: end program main_VLIDORT4.3.2. Conf
Page 65 and 66: $(VLID_DEF_PATH)/vlidort_sup_brdf_d
Page 67 and 68: Finally, the command to build the d
Page 69 and 70: Here, “s” indicates you want to
Page 71 and 72: The main difference between “vlid
Page 73 and 74: to both VLIDORT and the given VSLEA
Page 75 and 76: STATUS_INPUTREAD is equal to 4 (VLI
Page 77 and 78: 5. ReferencesAnderson, E., Z. Bai,
Page 79 and 80: Mishchenko, M.I., and L.D. Travis,
Page 81: Stamnes K., S-C. Tsay, W. Wiscombe,
Page 84 and 85: Table A2: Type Structure VLIDORT_Fi
Page 86 and 87: DO_WRITE_FOURIER Logical (I) Flag f
Page 88 and 89: USER_LEVELS (o) Real*8 (IO) Array o
Page 90 and 91: angle s, Stokes parameter S, and di
Page 92 and 93: DO_SLEAVE_WFS Logical (IO) Flag for
Page 94 and 95: 6.1.1.8. VLIDORT linearized outputs
Page 96 and 97: NFINELAYERS Integer Number of fine
Page 98 and 99: 6.1.2.4. VLIDORT linearized modifie
Page 100 and 101: The output file contains (for all 3
Page 102 and 103: The first call is the baseline calc
Page 104 and 105: for a 2-parameter Gamma-function si
Page 106 and 107:
Remark. In VLIDORT, the BRDF is a 4
Page 108 and 109:
6.3.3.1. Input and output type stru
Page 110 and 111:
Table C: Type Structure VBRDF_LinSu
Page 112 and 113:
Special note regarding Cox-Munk typ
Page 114 and 115:
squared parameter, so that Jacobian
Page 116 and 117:
6.4. SLEAVE SupplementHere, the sur
Page 118 and 119:
is possible to define Jacobians wit
Page 120 and 121:
etween 0 and 90 degrees.N_USER_OBSG
Page 122:
6.4.4.2 SLEAVE configuration file c
show all

VLIDORT User's Guide

Create successful ePaper yourself

Delete template?

Save as template?