Running SMARTS User Interface
Contents
1. Dry soil c Grazing field unfertilized C Dune sand C Wet sandy soil Vegetation Green rye grass c Lawn grass generic bluegrass Lush meadow Pinon pinetree needles C Ponderosa pine trees C Rye grass perennial c Sagebrush canopy Yellowstone Tall green corn e Wetland vegetation canopy Yellowstone C Wheat crop Manmade Materials Clear fiberglass green house roofing C Concrete slab Galvanized corrugated sheet metal new Old runway asphalt C Old runway concrete r Plywood sheet new pine 4 ply Red construction brick r Terracotta roofing clay e Water All States Coastal seawater C Fresh dry snow C Fresh fine snow Granular snow C Melting snow slush Open ocean seawater C Atlantic medium chlorophyll C Sea water Snow mountain neve C Solid ice e Young Norway e White vinyl plastic spruce needles Green grass Fallowfield Wet silt Cc Denver sheet 0 15 mm Water or calm ocean User Defined Enter Cancel r User File ALBEDO DAT Lambertian c User File ALBEDO DAT non Lambertian Spectral Range and Solar Constant Card 11 Enter the range between which all spectral calculations will be performed the desired value for the solar constant and the distance correction factor The largest possible spectral range is 280 to 4000 nm The distance correction factor should be 1 0 for the average sun earth distance Not2. Running SMARTS User Interface 1 Running the model Start the User Interface from within Microsoft Excel Important The User Interface must always be started by opening it as a spreadsheet from within Microsoft Excel as described below Other methods of starting the Interface such as double clicking its file icon may result in improper operation e Using the Windows start menu or a desktop shortcut start Microsoft Excel e From the Excel File pulldown menu choose Open e Using the Open file browsing window navigate to the SMARTS2 folder e From the file list select the SMARTS2 Excel spreadsheet file Either double click the file or click the Open button The SMARTS295 spreadsheet contains macros If your Excel program is configured to issue warnings about macros you will see the following or similar warning screen You must click Enable Macros to run the interface security Warning D SMARTS 2295 smarts295 xls contains macros Macros may contain viruses It is usually safe to disable macros but if the macros are legitimate you might lose some functionality When the interface starts you will see the following startup window Start the User Interface by clicking on the Click Here to Start message SMARTS Version 2 9 5 Simple Model of Atmospheric Radiative Transfer of Sunshine Version 2 9 5 Configuration Interface GFS a l te NEL After the startup screen you are presented with an overview window that
3. T txt and SMARTS295_ SCN txt can be obtained depending on the options selected on Cards 12 and 14 The latter files contain only spectral results and are in a spreadsheet ready format Note that if more than one record is entered on Card 17 spectral results on files SMARTS295_EXT txt and SMARTS295_SCN txt will appear in succession along the same columns as if only one record was entered but with a separation header line between each block of result For further analysis it might become necessary to move these vertical blocks of results into new columns from within your spreadsheet program Important Before another run is attempted and you wish to save the current output you need to either rename these output files or move them out of the SMARTS2 folder Otherwise execution of the model will overwrite the files
4. _ OUT txt that recapitulates the input data and provides intermediate results as well as broadband irradiances Two optional spreadsheet ready spectral files SMARTS295 EXT txt and SMARTS295_SCN txt are also present if spectral results are requested An ASCII text editor such as the Windows utilities NotePad or WordPad may be used to view any of these three files Alternatively the two output spectral files may be imported into Microsoft Excel or other analytical statistical tool for plotting etc Quit This closes the User Interface but does not unload it from Excel A restart option appears in the upper left corner of the Excel spreadsheet Click the Restart button if you wish to the User Interface again Exit Excel in the usual manner Important When exiting Excel will ask if you want to save changes to SMARTS295 XLS It is not necessary to save the changes However you should be aware that electing to save the spreadsheet will save the current configuration as the default when the Interface is reloaded and run in the future 2 Input Configuration Clicking any of the card configuration buttons will present a window with appropriate input selections and options for that card In all cases you may press an Enter button when your configuration is complete or press a Cancel button to leave the configuration unchanged When the Enter button is pressed a validity check is performed on all input data Any invalid entries are presented i
5. e these interdependencies e The minimum and maximum Solar Constant Distance Correction Factor 1 0 wavelength values must include the range on Card 12 Enter Cancel e A choice of the fourth option on Card 17 Year Month Day etc will calculate an accurate distance correction factor that overrides the value on this card Spectral Range Spectral Range amp Solar Constant Card 11 Wavelength nm Minimum Maximum Spectral Range Solar Constant Wim 2 1388 1 Output Card 12 Select the desired output confi guration If spectral results are selected the interval printing step must be at least 0 5 nm Furthermore the output order will be in the same order as displayed in the window top to bottom then left to right You may select all configurations with the Select All button or deselect all of them with the Deselect All button Note this interdependency Output Card 12 C Create OUT file only with spectral results Create OUT and EXT files include spectral results in EXT file only C Create OUT and EXT files include spectral results in both files Spectral range to Minimum Maximum Interval step be printed nm 280 4000 5 Spectral Results Note Output order is as shown below and cannot be specified l Ozone transmittance Transmittance from all trace gases l Water vapor transmittance l Uniformly mixed gas transmittance Aerosol transmittance l Beam radiation transmittance Rayle
6. efault Atmosphere Card 3 Default Atmosphere You may either enter specific sie Atmosphere atmospheric conditions or select a Card 3 reference atmosphere Non refere _ 2 Reference Atmosphere Atmosphere US Standard Atmosphere 1976 C MidLatitude Summer C MidLatitude Winter SubArctic Summer SubArctic Winter Tropical C SubTropical Summer C SubTropical Winter Arctic Summer Arctic Winter Enter Cancel Water Vapor Card 4 Precipitable Water You may enter a specific value for water vapor or calculate it from other parameters Note these interdependencies Precipitable Water Data Source e If you choose the second option and you did not select a reference Water Vapor Card 4 atmosphere on Card 3 Calculate from Reference Atmosphere and Altitude precipitable water is calculated Calculate from Atmospheric Temperature and Relative Humidity using the U S Standard Atmosphere e Choosing the third option is aa Cancel possible but not recommended when you select a reference atmosphere on Card 3 Ozone Card 5 Ozone Abundance You may either use the ozone abundance from the reference atmosphere or enter a value If you enter a value you must specify whether it is a sea level or site level value The sea level ozone value is corrected at run time for the site s altitude No correction is done when selecting the site level option Note this interdependency e If you c
7. hoose the first option it is BLE eae recommended you select a reference atmosphere on Card 3 Otherwise the ozone value will be defaulted to that for the U S Standard Atmosphere Columnar Ozone Abundance Card 5 Use Default from Reference Atmosphere Gaseous Absorption and Gaseous Absorption and Pollution Pollution Card 6 You have a choice of using default tropospheric concentration values for pollution related gases corresponding to your specific atmospheric conditions or modifying these defaults If you choose the latter option you have the additional choices of four pre defined pollution characteristics or the possibility of entering concentration levels of ten specific pollutants These concentrations must correspond to an assumed 1 km homogeneous pollution layer above ground Gaseous Absorption and Pollution Card 6 Use Defaults from Selected Atmosphere Enter Carbon Dioxide Card 7 Carbon Dioxide Enter the carbon dioxide Petre Dokidie concentration It does not depend Card 7 appreciably on the altitude of the site but slightly rather on season Carbon Dioxide location and year greenhouse Concentration ppmv af0 Enter Cancel effect Aerosol Model Card 8 Aerosol Model Choose from among the eleven E reference models or reso mode choose the User Supplied model and enter the Reference Models required parameters eee User Model Urban C Maritime C Tropospher
8. ic User Supplied specify values below SRA IAMAP C Continental Urban Maritime Braslau amp Dave te C Minimum C Maximum Enter Cancel Atmospheric Turbidity Card 9 Emn Select the desired turbidity mae ae parameter and Atmospheric Turbidity Card 9 enter its value in the input field Turbidity Value 0 084 Specified as Aerosol Optical Depth at 500 nm C Aerosol Optical Depth at 550 nm Angstrom s Turbidity Coefficient f Sch epp s Turbidity Coefficient Meteorological Range km C Prevailing Airport Visibility km Enter Cancel Albedo Card 10 You may specify a fixed albedo or choose from predefined spectral albedo files Note that these files result from experimental measurements and rarely cover the whole shortwave spectrum Use of a user supplied spectral file ALBEDO DAT is another option Regional Albedo predominate within r 10 km Card 10 Or Select spectral albedo data file Soils and Rocks Gravel C Light clay C Light loam C Light sand C Light soil C Alfalfa C Alpine meadow Bare soil Basalt rock Black loam Birch leaves C Brown loam C Conifer trees c Deciduous oak tree leaves C Brown sand C Dark loam C Dark sand C Pale loam Sand amp gravel c Sand from White Sands NM C Deciduous trees C Dry grass sod C Dry clay soil C Dry long grass C Dry sand Wet clay soil C Wet red clay C Fir trees Colorado
9. igh optical thickness F Ozone optical thickness l Optical thickness from all trace gases l Water vapor optical thickness I Uniformly mixed gas optical thickness Aerosol optical thickness Aerosol single scattering albedo l Aerosol asymmetry factor l Zonal surface reflectance Extraterrestrial irradiance Direct normal irradiance l Diffuse horizontal irradiance Global horizontal irradiance l Local ground reflectance l Atmospheric reflectance l Global foreground on tilted surface l Upward hemispheric ground reflected Direct horizontal iradiance Global horiz photosynthetic photon flux I Direct tilted irradiance l Diffuse tilted irradiance I Global tilted irradiance V Experimental direct w circumsolar V Experimental diffuse irradiance l Circumsolar within radiometer l Global tilted photon flux l Diffuse horizontal photon flux I Direct normal photon flux I Rayleigh transmittance Direct normal photosynthetic photon flux Diffuse horiz photosynthetic photon flux I Global tilted photosynthetic photon flux l Spectral photonic energy l Global horiz photon flux per eV l Direct normal photon flux per eV l Diffuse horiz photon flux per eV Global tilted photon flux per eV Units Irradiance in W m 2 nm 1 Spectral Photon Flux in cm 2 s 1 nm 1 Photon Flux per eV in cm 2 s 1 eV 1 Select All Deselect All Enter Cancel e The min and max wavelengths must fall within those specified on Card 11 So
10. lar Position and Air Mass Solar Position Card 17 J ees You may choose from among five pated Position and Air Mass configurations for calculating solar a ae Input Zenith and Azimuth angles deq position and air mass We will only use Relative Air Mass however C Input Elevation and Azimuth angles deg Input relative Air Mass 1 38 2 C Input Year Month Day Hour Latitude Longitude and Time Zone Input Month Latitude and Time Interval DAILY CALCULATION Important When using the last option for a daily calculation the Record Number New Recard Time Step Interval value needs to 1 of 1 ae be carefully chosen It must be a lt eat divisor of 60 e g 5 6 7 9 Relative Air Mass 15 There is a trade off between ome choosing a lower number for accuracy and a larger number to decrease computation time A time step of 5 to 10 minutes is recommended as the best compromise casi Note that the fourth configuration calculates the sun s position with ee very high accuracy However if the values entered correspond to nighttime the User Interface cannot detect the problem An error message will be issued at run time and will appear in the SMARTS295 OUT txt file Output The minimum output consists of one file SMARTS295 OUT txt which groups an echo of the input file some intermediate results and broadband irradiance results Up to two additional output files SMARTS295_EX
11. n an error box and you must correct any errors before the card configuration is saved The User Interface is supplied with a default configuration that provides valid startup values for most fields In many cases during configuration you may find that data entry fields are locked out preventing data entry This occurs when those inputs are inappropriate for a given configuration Each card configuration window is described below Comments Card 1 You may enter text up to 64 Tasari characters long Pai e Comments card 1 Enter Title or Comments USSA_AOD 0 084_ASTM_G173 Enter Cancel Site Pressure Card 2 Site Pressure Parameters for either specifying e e ee or calculating site pressure are Card 2 entered on this card The site may be either at ground level or Enter site pressure altitude and height recommended elevated above the ground such Enter latitude altitude and height as on a tower or aircraft Altitude weep ss refers to ground level above mean o Altitude at ground km sea level and Height refers to the o Height above ground km distance above the ground Site Latitude decimal degrees N S Pressure gt always that of the site Note A site is a simulated target at a fixed Height above ground with the which is at a total elevation of ground at a fixed Altitude above sea level The total of Altitude and Height Altitude Height must be less than 100 km Enter Cancel D
12. provides access to all configuration parameters in the SMARTS input file SMARTS Configuration Each small button on the window l corresponds to a Main Card as SMARTS Configuration documented in the User s Manual The Optional Cards referenced in the User s Manual do not have a similar counterpart in the User Interface Tilt Albedo Card 10b Depending on your configuration the Spectral Range Card 11 Optional Cards are created as necessary by the User Interface and written to the configuration file Five action buttons are located at the Smoothing Filter Card 14 bottom of the configuration window Comments Card 1 Albedo Card 10 Site Pressure Card Atmosphere Card 3 Water Vapor Card 4 Output Card 12 Gaseous Absorption Card 6 Carbon Dioxide Card 7 luminance Card 15 Get Config This allows you to retrieve a previously configured input file by using a conventional Windows Turbidity Card 9 file browser The default folder for input files is the INPUTS folder located beneath the SMVARTS2 folder However input files may be retrieved from any location Check Config This option will perform fundamental validity checks of your configuration Many cards have interdependencies that if improperly configured could Cause erroneous results or model execution failure In addition this option will alert you to several conflicting configurations that force an input override which may create model input tha
13. t you had not intended Save Config This allows you to save a configuration with a unique file name The default folder for input files is the NVPUTS folder located beneath the SMARTS2 folder However input files may be saved in any location Important You should not save a configuration to the name SMARTS295_INP txt in the SMARTS2 folder as this is the file used by the interface to run the model If you do so your file may be overwritten by the interface Run Model This calls the executable model code and produces the output file s The output file s is named SMARTS2 with the appropriate extension s The interface opens a command window to display the model execution When the model completes execution you will see the following Extraterrestrial Spectrum Card Ta UV Card 16 zy E Z a Ozone Card 5 __ Circumsolar Card 13 jaa aa Aerosol Model Card 3 Solar Geometry Card 17 i A a Get Config Check Config Save Config Run Model H DASMARTSZ v29 smartsz9bat exe Frogram completed Press Enter to Continue To return to the Interface press the Enter key Important The model always creates files with the SMARTS295_xxx txt name You must rename them prior to any subsequent model runs and move them to an appropriately named user folder The current version of the User Interface does not have the capability of viewing the model output Output results are available from at least one file SMARTS295
Download Pdf Manuals
Related Search