******************************************************* * DIFFERENCES BETWEEN STREAMER VERSIONS 2 AND 3 INPUT * ******************************************************* MAKE THESE CHANGES TO THE VERSION 2 INPUT FILE FORMAT ----------------------------------------------------- OPTIONS ($OPTIONS): - Remove $OPTIONS descriptive title line - Remove the IMTHD value (second value on the line after the number of streams line) - Add IWAVE (spectral range specification) to the units line (3 for Streamer bands, 4 for band weights, see User's Guide for 1 and 2). - Remove log file option - Remove the WEIGHTBND true/false flag - Add three lines after the band weights file specification (i.e., at the end of the options): USERCLOUD (.TRUE./.FALSE.), CLOUDFILE, BRDFFILE DATA ($CASE, $SETDATA): - Check your surface types as the order has been rearranged and another snow type has been added (snow type is no longer a function of month) - Cloud input line(s). This line has changed the most. Go through the documentation carefully! (a) If there is more than one cloud, each set of cloud properties MUST be on a separate line (you probably were doing this anyway). The first line must have the number of clouds and then the cloud properties for the first cloud. (b) Re and WC values are now required for two possible particle phases. Their variables names have changed (cldre1,cldre2,cldwc1,cldwc2, where the "1" and "2" refer to parts of a cloud, not different cloud "names"). (c) There is an 'nphases' variable that gives the number of particle types in the cloud (1=liquid or ice, 2=liquid and ice or ice and ice). (d) The new cloud phase values come before both of Re and WC pairs. Cloud phase has new numbering as it is also used to select various ice particle habits: 0=liquid, 1-8=ice. The cloud phase variable names are cldphase1 and cldphase2, corresponding to the different particle types in a given cloud. (e) Where the shortwave ice cloud model "mean effective size" in Streamer v2.x was more of a diameter than a radius, in Streamer 3.x it's more like a radius than a diameter. (f) Values for cloud thickness (mb or km) AND cloud optical thickness are required, though which is/are used depends on the cloud thickness "unit" specified in the options. $REPLACE, $CPRINT: - Change value assignments in $REPLACE for logical values to .true. and .false. - Change $PRINT to $CPRINT ($PRINT now has a new meaning for interactive mode) - Change the output variable names 'cldt' and 'cldp' to 'cldtemp' and 'cldpress', respectively. - Change the dimensions of 'averad' as they have been switched around. - Change cloud variable names (see the documentation). OTHER INPUT-RELATED CHANGES --------------------------- - Commands that have arguments must be followed by either a space or a comma. Previously only spaces were allowed. For example, "print zen" and "print,zen" are both acceptable; "printzen" is not. - Added the following variable types to $replace: descriptive and user output file names, unit variables (IPZ, ICTOP, etc.), brdftype, brdfparams, brdfscaler, ALBTYPE. - Added the 'cldwp' (cloud water path) variable for output (only). - The 'nclouds' variable for output now does NOT include the overlapping sets. - Added the smoke aerosol type - Added another cloud thickness "unit" for specifying that a cloud fills a profile layer. - The 'rsurf' line now has more functionality to handle BRDF options. - Removed the need for "$" in commands, though it's still acceptable. - Added the option of using a defaults data file. - Added a command line option that allows specifying a different defaults file. - Added the $ASSIGN and $RUN commands. Note that "$ASSIGN" isn't actually required in a line with variable assignments. - Added an interactive mode of operation (start it with "streamer -i") and the associated commands $ASSIGN, $PRINT, $RUN, $EXIT, and $HELP.