FASCODE

MATLAB

ExtCoeff = FASCODE(Atm,FileName,[FieldName1,FieldValue1],...
                           [FieldName2,FieldValue2],...)

Description

This function runs FASCODE and return a structure that has the output. The output includes the trans. and extinction coefficient. FASCODE is not distributed with ATMTools. The user must obtain a version of FASCODE and install in ATMTools/OTT/FASCODE.

Parameters

Parameters	Description
Atm [struct]	Atmospheric modeling parameters for a discrete atmosphere. Can be a structure from AtmStruct with fields hp, ht, L, h, z.
FileName [string]	(Optional, defaults to 'FAS_NORM2') The file name to be used in FASCODE. Users can input one of their files or use one from the library (Input_library) directory. Must be passed in (can be empty) if using optional arguments that follow.
FieldName [string]	The name of a parameter to be modified from the value in FileName. Available parameters are: 'LAMBDA'--Wavelength (m), 'MODEL'--Atmospheric model (1-6), 'IHAZE'--Aerosols model to be used (1-10), 'IVULCN'--Extinction type for stratospheric aerosols (1-8), 'ICLD'--inclusion of clouds (1-20), 'IAERSL' --Aerosols (0 or 1) 'ITYPE'--Type of path (1,2 (default)), 'HRANGE'--Horizontal path length, ITYPE=1 (m) 'VIS'--Surface meteorological range (km) 'FAS_EXE'--Filename of the FASCODE executable file. Must be in the ATMToolsPath/OTT/FASCODE folder. Defaults to FASCD3P.EXE 'LNFL_EXE'--Filename of the FASCODE executable file. Must be in the ATMToolsPath/OTT/HITRAN folder. Defaults to LNFL.exe
FieldValue [scalar]	The value of specified FieldName with units depending on FieldName as above.

Return Values

Return Values	Description
ExtCoeff [struct]	Structure containing the extinction coefficients and information about the run parameters
ExtCoeff.ver [string]	Version of FASCODE run
ExtCoeff.Name [struct]	The name of each parameter included in the structure
ExtCoeff.Value [struct]	In which the values of the parameters are stored.
ExtCoeff.Units [struct]	The units of this parameter

References

FASCODE Users Manual

Examples

>> ExtCoeff = FASCODE(AtmStruct,'FAS_NORM2','lambda',1.064e-6,'ihaze',2)

Run FASCODE for extinction coefficients at the altitudes in the input Atm structure and return data

>> ExtCoeff = FASCODE(AtmStruct,[],'FAS_EXE','fas90.exe', ...

'LNFL_EXE','lnfl_v2.5_OS_X_g95_sgl')

Run FASCODE for extinction coefficients at the altitudes in the input Atm structure specifying the names of the executables to run