Parameters 

Description 

Wavelength [vector] 

vector of wavelengths (m). 

G [struct] 

Geometry information, including dates/times (in UT) in TALO. OR: 

LatLong [vector] 

Boundaries of the generated cube in format [North Lat, South Lat, East Lon, West Lon]. 

grbFile [char] 

Full path to pre-downloaded NOMADS data file. Data can be downloaded from nomads.ncdc.noaa.gov/data/gfs4/. Filename must be formatted as follows:

• gfs_4_YYYYMMDD_HH00_CCC (NOAA downloads) OR
• YYYYMMDDHH00CCC (LEEDR downloads)

 

PValue [varies] 

(Optional) Value for parameter associated with PName. There must be a parameter value for each parameter name specified. 

'useCorrK' 

true/false - Flag for setting whether or not to use correlated-K for the molecular absorption which can be much faster when generating multiple wavelengths and is preferred if band absorption is desired - default is true. 

'Terrain' 

terrainValue - Description of the site terrain (case insensitive) or surface [albedo, evap const, surface roughness (m)]. See MzaSurfCn2 

'Cn2' 

cn2Model - identifier to indicate the LEEDR Cn2 model. see Turbulence.list for a list of available LEEDR Cn2 models. If set to 'Calculations - Tatarski', ground level values will be computed using MZAsurfCn2 for daytime hours unless the surfCn2Replace parameter is set to false. 

'surfCn2' 

surfCn2Replace - if set to false, the surface value is not replaced using the MZASurfCn2 model. Pass in a value (or matrix of values with size(wxCube_grid,1)) to use for ground level Cn2. Grid size determined by numel(floor(LatLong(2)*2)/2:.5:ceil(LatLong(1)*2)/2) X numel(floor(LatLong(4)*2)/2:.5:ceil(LatLong(3)*2)/2). Default true if cn2Model is 'Calculations - Tatarski'. 

'useCn2NN' 

true/false/Char - Flag for setting whether or not to use the machine learning neural network to adjust ground level Cn2. Can also pass in a file name containing the neural network data to be used. Defaults to true - using the NN data from Cn2WeatherNN_30N_2L_11I.mat unless useMZAsurfCn2 is false. 

'MinSolarIrr' 

Minimum value for ground level solar irradiance. Use to possibly override the NaN return from surface model when solar irradiance is low. May still get NaN under low wind conditions. Ignored if surfCn2 is false. NOTE: The model does not support Cn2 estimation under these conditions. 

'MaxAlt' 

maxAlt - altitude above which the atmosphere is considered a vacuum (m). Ignored if LatLong is passed in. Use this altitude to limit the extent of the cube lats and lons when passing in a GEOM structure. The cube will still be generated with the default altitudes (1001 divisions from 0 to 100km). Be sure to use the same MaxAlt in the ATM structure to prevent the ATM screens from going outside the limits of the cube. 

'nLayers' 

Number of layers (altitudes) between 100 m and MaxAlt to use when generating the weather cube - defaults to 1000. Actual numbers of layers will be nLayers + 8 (surface layers) 

'DTEDdir' 

directory holding the downloaded DTED data - data can be downloaded from http://earthexplorer.usgs.gov/. Set to false to prevent generation of DTED data. 

'writeMesh' 

true/false - Flag for setting whether or not mesh files are generated. This is the original binary storage format for LEEDR generated weather cubes. Default is false. 

Return Values 

Description 

wxCube [struct] 

Weather cube data 

location [char] 

Folder name with the location information from LatLong 

nomadsFile [char] 

Folder name for date/time in format YYYYMMDDHHHCCC where HHHH is the hour cycle (ZULU) and CCC is the forecast hour.