Home

User`s Guide

1. V 0 0 1 YVAR 1 F 8 8 1 XVAR 1 H 0 0 1 This means that this background will have X horizontally on the plots Do both will have the full domain of grid points for the grid specified by bove IGRID The Y direction will be fixed to the 8th grid point from the southern edge of the P time T will range from the 1st to the 5th file found after filtering with Or a series of horizontal X Y slabs of may be specified as TVAR 1 F 1 25 2 E Ze 2H y V 1 2 1 9 H 3 15 1 7 This means that this oe oa lag have X horizontally on the plots and Y vertical For the grid specified by will span from the 3rd to the 15th grid point from the western edge of the domain Y will span from the 2nd grid point from the southern edge of the domain to the 3rd grid point from the northern edge of the eae re T will range from the 1st to the 25th file found after filtering with gt Skipping every 2nd file so 13 plots will be drawn IGRID If not plotting the following settings may be appropriate noting that the F V and H values are ignored TVAR 1 F 1 25 1 ZVAR 1 F 2 O 1 YVAR 1 V 1 1 2 XVAR 1 H 1 1 2 Which will output all 25 times for a horizontal Garena that does not include the boundary grid points for the grid specified by I d skips every other grid point in between and includes all vertical levels other that the lowest which is below the terrain surface If Ckrame_ dFRAME B ahd
2. date time istat lat lon elev x y z grd var i i 1 nvars where date YYYYMMDD integer i10 time HHMMSS integer i10 stat station id number integer i10 lat latitude degrees real 15 6 lon longitude degrees real e15 6 elev height AGL m real e15 6 0 for itype 2 x RAMS x coordinate m real e15 6 y RAMS y coordinate m real e15 6 Zz RAMS z coordinate m AGL real e15 6 grd RAMS grid used o 110 var variable values real e15 6 up to 30 If the types of run defined by AINATYPE GRAB and GRABEMT 1 the selected FRAME _A 4 FRAME A dre output in a RALPH2 format ASCI file Page 40
3. tings All available variables are detailed below default is 2 A 1 or2 character string that defines the method of plotting first character and whether or not to include a color scale bar second character if the viable is to be plotted with a range of colors First character setting may be e c draw contour lines e f draw and fill contours e t fill tiles Second character settings may be e nor blank no color bar e b draw color bar For example CFRAME_A n tempc fb will result in a filled contour plot of temperature in degrees centigrade and include color bar default is fb Minimum contour level for the field named in component 1 A value of zero allows the code to choose its own minimum Maximum contour level for the field named in component 1 A value of zero allows the code to choose its own maximum Page 22 MRC ASTER REVU Version 2 3 1 User s Guide CFRAME A If positive this is the contour interval for the field named in component 1 If negative then it indicates about how many contour lines will be drawn between cont an the lowest and highest values If set to zero a value will be chosen in the code For example CFRAME_A n tempc fb 10 0 30 0 2 0 will set the contour levels for temperature from 10 0 to 30 0 degrees with a contouring interval of 2 0 degrees centigrade If values exist outside of this range they will not be contoured Options for plotting the field name
4. delimited components as illustrated below COLORS 1 axis yellow title0 rgb 0 0 0 4 0 0 In the first example of COLORS the color table element axis defined below is redefined from its default of white on a black background or back on a white background to the color table element yellow also defined below In the second example of COLORS 1 the color table element titleO defined below is redefined in red green blue RGB color space as a dark green a shade of green not previously defined in the color table COLORS 2 red rgb 0 8 0 0 0 0 dkred rgb 1 0 0 0 0 0 In the first example of COLORS 2 the color table element red defined below is redefined from its default RBG value to a slightly darker shade of red In the second example of COLORS 2 a new color table element dkred defined in RGB color space You can redefine up to around 8 colors the string has a maximum length of 128 characters in either RGB of HLS hue lightness saturation color space each as a slash delimited item Background independent colors Color RGB Values Color RGB Values white black grayblack darkgray gray lightgray darkred red midred lightred darkgreen green midgreen lightgreen darkblue blue midblue lightblue yellow yellowgreen bh purple 1 0 0 0 cyan 00 L0 tan 86 0 58 sienna 63 0 32 brown 65 0416 orangered 0 orange 25 gold 85 greenyellow 0 forestgreen 296 aqua 0 deepskybl
5. first specified color at the maximum slab value and component 8 second specified color at the minimum slab value Colors are blended between the maximum and minimum without going through either the foreground or background colors This can lead to some odd color ranges if the user is not careful with the bounding color selections Page 23 MRC ASTER CFRAME_A cont REVU Version 2 3 1 User s Guide Three color schemes m7 Three color blending scheme with component 7 first specified color at the maximum slab value component 8 second specified color at the minimum slab value and component 9 third specified color at the central slab value Colors are blended between the maximum and minimum and the center without going through either the foreground or background colors This can lead to some odd color ranges if the user is not careful with the bounding color selections Negative values for m switches the order of color graduation what appeared at the maximum values appear at the minimum values and vise versa b Graduated color bias real that gives a departure from linear the interpolation between colors since bias towards lighter colors is preferred as this gives more intervals in the human eyes sensitive range e g b1 linear b1 5 lighten and b 75 darken default is 1 5 c Central color value real for splitting colors and contour lines in the scheme described above default 0 i Major
6. slash delimited string with up to 10 components Order is important and although you can leave components at the end of the list unspecified you must specify each component at least with seman to the last component you wish to specify an example of this is in C Options that are left ee E sensible defaults The subscript on CFRAME_B is tied to those on C d CFRAME_C in that sets of these parameters with the same subscript appear on the same plots Describing each slash delimited component 1 Character value to denote how to depict the wind field none default draw streamlines draw wind barbs draw wind vectors draw turbulence with vectors draw relative vorticity vectors Variable indicating the number of horizontal grid points between adjacent wind vector or barb plots integer intindi default is 1 Variable indicating the number of vertical grid points between adjacent wind vector or barb plots integer intindj default is 1 Variable specifying the wind barb flags staff and half staff values integer default is not used for vectors but place holder still required 1 50 10 5 m s 2 20 4 2 m s 3 10 2 1 m s default 4 5 1 0 5 m s Wind marker color test Stem length for vector or barb scales the whole barb real default is intindi The default behavior for the size of the vectors and barbs is to double in size when intindi is doubled in which case they tend to dominate the picture
7. 2 3 1 mk contains all the dependencies within the REVU distribution This means that if a file such as vcomm2 h is updated all those modules that use this file will be recompiled noting that vcomm2 h is not itself compiled but included in whatever modules require it when they are compiled All include h and module mod files are treated in the same way e If you have multiple versions of RAMS REVU or the UTILS library the version built by default make command will be that indicated near the top of the include mk file The set of version numbers in the include mk file should match a set of version numbers in the versions file e All make commands will run the shell script check which outputs some advice if it finds a version mismatch it does not stop the make command from completing although you may then get compilation errors check compares the versions indicated in the include mk file with the list of compatible versions in the versions file and the versions installed under RAMSROOT on your machine If the check script fails on your machine you can remove the check dependency from the all target in each of the make files e Ifthe include command does not appear to work on your machine try replacing the include command line in each of the make files with the contents of the include file Alternatively you can download GNU make and use that instead of your platform version GNU make is available from the URL NUttp www gnu or
8. CFRAME_C ishiicate multiple backgrounds and TVAR ZVAR YVAR and XVAR are not specified for a background then the settings for the first background will be used for the unspecified background i e in most cases you only need to specify them for the first background Page 21 MRC ASTER REVU Version 2 3 1 User s Guide CFRAME Arq CFRAME A specific the variables to plot if ANATYPE is ket SPACE or extract N character array for other A none If not plotting only the variable is required For example a set of CFRAME_A settings for V5D might be CFRAME_A 1 u CFRAME_A 2 v CFRAME 3 w CFRAME 4 tempk CFRAME_A 5 dewptk If plotting a series of slash delimited components containing plotting options can follow the variable These control the way in which the variable is represented in the plot Order is important and although you can leave components at the end of the list unspecified you must specify each component at least with placeholders up to the last component you wish to specify an example of this is shown below Options that are left unspecified are given sensible defaults Note that the sad of CFRAME_A denotes the background number equals the frame prambe NEARE iN subscript on CFRAME_A is tied to those on CFRAME that sets of these parameters with the same subscript appear on the same plots Describing each slash delimited component following the variable
9. The format is specified in grabstat f90 module which may be modified by the user Do statistical comparisons between RAMS data and observations HEAD1 A 24 character long string used to title all plots character IGRID 0 A background dependant parameter that specifies which grid is to be processed integer array e If set to zero all grids will be processed on separate backgrounds if A is set to SPACE e If set to gt 0 only the specified grid will be processed e If set to lt 0 all A a v abs IGRID will be processed on separate backgrounds if ANATYPE s set to SPACE If PETET crkame C ishicate multiple backgrounds and IGRID is not specified for a background then the IGRID for the first background will be used for the unspecified background i e in most cases you only need to specify IGRID for the first background IZTRAN oO baal pen ameter that if plotting a horizontal cross section see integer array nd Y AR 4letermines the vertical coordinate If set to 1 fields are output on the model s terrain following coordinate surfaces If set to 2 fields are interpolated to horizontal Cartesian surfaces which have the same heights as the terrain following heights of a grid point at sea level If set to 3 fields are eae to pressure surfaces If plotting the surface output is determined by otherwise TA vertical extent of the field output is determined by Z ZY AR KVAR dnd Y VAR acting on the stan
10. You can prevent this by halving the stem length when intindi is doubled Maximum wind vector scale real default is 1 which get recomputed to the maximum wind speed Wind vector head length real default is 1 which get recomputed to 0 1 intindi 9 Wind vector head length for 0 wind speed real default is 1 which get recomputed to 0 2 intindi Wind vector head angle real default is 25 0 degrees Page 26 MRC ASTER REVU Version 2 3 1 User s Guide CFRAME_B The default setting for CPRAME_B is cont CFRAME_B 1 n 1 1 3 yellow 1 0 1 1 1 Examples CFRAME_B 1 b 2 2 4 green 5 will draw green wind barbs on every other grid point in both the horizontal and vertical with flag staff and half staff values of 5 1 and 0 5 m s respectively The size of the barbs will be maintained the same as for drawing them at every grid point with the 0 5 stem length setting CFRAME C If plotting CFRAME_C is a second variable that can be contoured or tiled It can character array also be used to color wind vectors with or without a color scale bar second Eoo ey oie ea The subscript on CFRAME_C is tied to those on that sets of these parameters with the same subscript appear on the same plots The default setting for CFRAME_C is CFRAME_C 1 none cn 0 0 0 m2 c0 b1 5 i15 d1 g30 tl 01 10 h0 s 01 xlightgray darkgreen purple t Each array may contain entries for each background In
11. contour line interval integer default is 5 g Graduated contour line color offset real gt 0 0 Graduate contour line colors gt the value is used for the lightness color offset default is 30 0 0 Use component 7 first specified color and component 8 second specified color for positive and negative contours respectively lt 0 0 Use contour and high low labels color parameter option x flor the contour line color t Contour line thickness real t1 0 is the standard line thickness Major contour lines are drawn at 1 5 t default is 1 0 d Dashed solid line control integer d0 Solid lines for all contours di1 Das lines for contours with values less that the central color values option chahd solid lines for all other contours default d2 Dashed lines for all contours o Overlay lines on top of any filled contours and tiles integer 00 Do not overlay contour lines ol Overlay contour lines default l Contour line label controls integer l 1 No labels 10 Draw labels with the color defined in x ae but without filling a background behind the label or outlining the Tabels with boxes default l1 Draw labels in box outlined with the foreground color 2 Draw labels in box filled with the background color 13 Draw labels in box outlined with the foreground color and led with the background color Page 24 MRC ASTER REVU Version 2 3 1 User s Guide CFRAME_A h H
12. for output to the lite files ensure that the lite tag is included in the ctables list Some of the model variables indicated are not directly listed in the VTABLE file Specifically selecting PP in VTABLE will output PI and VKM will output HKH The model variables indicated for the LEAF fields are relevant to the future RAMS version 4 4 If you wish to view any of these select all of TGP WGP SCHAR and GS SCHAR is also required to get the patch area that is used to obtain land percentages for most plots 3 D Atmospheric Variables The following variables are defined on the 3 D atmospheric grid and may be plotted in either horizontal or vertical cross section Obviously many of these variables are dependent on which options were activated for a particular run Field Name Description units Model Variables to T point m s point m s wo we JP VP z direction wind component m s WP WP WP Wb z direction wind component averaged to T point mis WP speed speed mph direction relvorty Page 30 MRC ASTER REVU Version 2 3 1 User s Guide Field Name Description units Model Variables potvortz z component of potential vorticity rad s UP VP TOPT THETA horiz_div horizontal divergence s 1 Exner function J kg K S press theta potential temperature K dnO reference state density kg m 3 0 reference state Exner function J kg K p th0 pert_pressure tempk tempe tempf thet
13. of the REVU User s Guide since it was redeveloped from VAN and split from the RAMS version 3b User s Guide It describes REVU as of August 2001 REVU version 2 3 1 is FORTRAN 90 compliant and includes several c modules several RAMS modules and the RAMS and Utilities libraries UNIX Linux make commands and a system of make files and makefile includes are used for compiling the code The make files are detailed in the section describing How to compile the REVU model is controlled by a set of namelist variables usually contained in a file named Revu PET VU the user should be acquainted with the two primary means of setting parameters that control its functions These are l The various epnfize epntained in vcomm2 h which define several array dimensions controlling tht eapaetty ofthe mode 2 The variables in the REVO Ev memes ie The following sections of this document describes the function and use of each of the parameters and namelist variables and how to set appropriate values for them New in REVU 2 3 1 New features since REVU version 2 3 0 include e GRIB file format output option works the same way as Vis5D and GrADS e The overlay filed may now be filled Filling does not go beyond the specified high low range This allows the user to see the map in the unfilled portions Map boundaries can be placed under or on top of the color fills There is also an option for enhanced map boundaries e Color options i
14. prefix gt A will give all standard RAMS analysis files lt prefix gt A 2000 10 000000 will give the analysis files for OZ each day REVU finds all files in the specified directory that have that match ANPREF it looks for the header files by listing ANPREF head txt and determines their chronological order from the time suffix encoded into the rl he user selects some or all of these files to be plotted in the namelist variable T REVPREF The UNIX path name and prefix for the REVU output files up to 128 characters charachter Note that the path is optional and can be either relative or absolute no path is equivalent to Page 15 MRC ASTER REVU Version 2 3 1 User s Guide ANATYPE Designates what type of REVU run to make Options are character e SPACE ooo FFA ial eal the fields specified in CFRAME A CF C No time axis plots are available in the current version Create Vis5D files of the fields specified in SLA Create GrADS files of the fields specified in CF Create GRIB files of the fields specified in Dump the fields specified in a user defined format The format is specified in dumpout f90 module which may be modified by the user The purpose of this option is to extract fields from analysis files that are written in FA format Output the fields specified in C the points specified by latitude longitude height locations or vertical profiles at latitude longitude locations in RALPH2 or a user defined format
15. resolved surface precipitation inches hr liquid PCPRR PCPRP PCPRS equivalent PCPRA PCPRH PCPRG q CONPRR precipr resolved plus convective surface precipitation mm hr PCPRR PCPRP PCPRS liqui d equivalen t PCPRA PCPRH PCPRG CONPRR precipr_in resolved plus convective surface precipitation PCPRR PCPRP PCPRS j PCPRA PCPRH PCPRG inches hr liquid equivalent CONPRR conpcp cumulus parameterization precipitation rate mm hr CONPRR precipitation mm vertint_rt vertically integrated total water mixing ratio mm TOPT RCP RRP RPP tfz surface sensible heat flux K m s F gt Z Z surface water vapor flux kg kg m s Gi T F surface x component momentum flux m7 s UW VW r z sens_flux surface sensible heat flux W m TFZ TOPT etrans evapotranspiration rate mm hr QFZ TOPT j E surface y component momentum flux m s YW z umom_fix vmom_ fis reps bowen rshort rlong 2AT albed a ropo fi sfc_div horizontal divergence at surface s 1 a ctprof 2 sst TER Q 4 vertint_cond vertically integrated total condensate mixing ratio mm_ TOPT RCP RRP RPP liquid equivalent RSP RAE ROR RHE Q a i 1 lat_flux surface latent heat flux W m etrans_in evapotranspiration rate in hr 1 Page 34 MRC ASTER REVU Version 2 3 1 User s Guide LEAF Variables These variables are from the LEAF2 parameterization and comprise all the soil and vegetati
16. source code make files and configuration files in the src bin and run directories in RAMSROOT RAMSROOT bin README_REVU 2 3 1 build and install files Make revu 2 3 1 dep_revu 2 3 1 mk Makefile std include mk std check versions Copyright RAMSROOT run REVU_IN configuration files ad RAMSROOT src post 2 3 1 revu source source code common source common modules modules include includes Downloading the Latest Patch for HYPACT 1 Obtain the latest version of the software by either downloading the UNIX gzipped tar file revu 2 3 1 patch tar gz from the web address www aster com revu e Make a temporary directory and move the tar file in to that directory mkdir tmp mv revu 2 3 1 patch tar gz tmp e Unpack the contents of the patch tar file either gunzip c revu 2 3 1 patch tar gz tar xf e or if you are on a Linux machine tar zxf revu 2 3 1 patch tar gz or download patched modules individually from nttp Www aster com revu z2 3 1 paten shtm 4 Replace the modules in your distribution with those new versions contained in the patch noting that since the source comes with read only permissions you will need to modify the permissions of the module in your RAMSROOT src directory before replacing it with the patch version For example chmod u w RAMSROOT src post 2 3 1 common vplt f 90 mv src post 2 3 1 common vplt 90 RAMSROOT src po
17. upper air observations only Prefix for the surface observational file names file must be in RALPH2 format Prefix for the upper air observational file names file must be in RALPH2 format Quality control suffix for the file names NOQ is tagged to the original data file if quality control has been run on it Switches for plotting statistical results not fully functional e If set to 0 switch is off e If set to 1 switch is on IPDIFF specifies whether to plot predicted observed difference values IPVALS specifies whether to plot actual predicted and observed values IPWIND specifies whether to plot winds comparison IPHIST specifies whether to plot histograms of predicted observed IPCONT specifies whether to plot contours of predicted observed differences Page 29 MRC ASTER REVU Version 2 3 1 User s Guide REVU Variables for Plotting or Output The list of variables that are currently configured in REVU version 2 3 1 for RAMS version 4 3 0 is described below These may be selected for plotting or output into the GrADS GRIB or VisSD files except for the LEAF patch variables The field name is what you may use in T mri your REVU_IN file The model variables indicate what you need to have our ile when you run RAMS to ensure that you can look at field or extract the data with REVU To select a VTABLE field for output to the analysis files ensure that the anal tag is included in the ctables list Likewise
18. 0 1 3 41 07305556 71 92333333 O 2 profile data 4 40 77916667 73 88000000 500 1 point data at 500m AGL 5 41 62555556 73 88194444 10 1 Page 39 MRC ASTER REVU Version 2 3 1 User s Guide REVU Output Files If the type of run defined by A p SPACE an NCAR Graphics NCGM file named gmeta will be output in the current directo directory specified by KEVPREF For all other run types the file format REVPREF lt dnalpref gt SCP lt date gt g lt grid gt lt format gt where e lt analpref gt is the file prefix given by AFILOUT or HYPPREF the RAMS and HYPACT output filename prefixes respectively without the path component e SCP is determined by r4rran ji e S for 1 output on sigma surfaces C for ERBRANS2 output on Cartesian surfaces P for PZTRAN 3 output on pressure surfaces e lt date gt is the standard date string of the analysis files for the beginning of the RAMS simulation e lt grid gt is the RAMS grid number of the data A grid number of 0 indicates that the file contains information on all grids e lt format gt is the tye of output file as determined by ANATYPE below i e v5d for 5D Vis5d files gra for GRADS GrADS files grb for RIB GRIB files gbr for RAB grabber files dmp for UMP dumped files If the types of run defined by AANNATYPE is GRAB and GRABFMT ik 0 the selected variables are output in an ASCI file with the following format
19. ERP A snow _diam mre pay ia graupel internal energy parameter J kg aS N rain_temp rain temperature deg C graup_temp graupel temperature deg C rain_air_tempdif rain air temperature difference K Q2 THETA PI graup_air_tempdf graupel air temperature difference K Q6 THETA PI hail_air_tempdif hail air temperature difference K Q7 THETA PI i i hail_diam hail mean mass diameter mm rain internal energy parameter J kg Oe hail internal energy parameter J kg i i i 2 C hail_temp hail temperature deg C 7 graup_fracliq liquid fraction in graupel C hail_fracliq liquid fraction in hail vo k aN turbulent kinetic energy m 2 s 2 TKEP scalarl_mixrat scalar 1 mixing ratio units kg SCLP1 scalar2_mixrat scalar 2 mixing ratio units kg SCLP2 cuparm_thetasrc cumulus parameterization heating rate K s THSRC cuparm_rtsrc cumulus parameterization moistening rate kg kg s RTSRC rad_thetasrc radiative transfer heating rate K s FTHRD khh horizontal scalar mixing coefficient m 2 s eo geopotential height m i K khv vertical scalar mixing coefficient m 2 s Page 32 MRC ASTER REVU Version 2 3 1 User s Guide 2 D Variables The following variables are defined as a function of horizontal coordinates only and may only be plotted in horizontal cross section Field Name Description units Model Variables tempf2m 2 meter height air tem
20. REVU RAMS HYPACT Evaluation and Visualization Utilities Version 2 3 1 User s Guide August 20 2001 by Craig J Tremback Robert L Walko Martin J Bell ASTER Division Mission Research Corporation P O Box 466 Fort Collins CO 80525 0466 MRC ASTER REVU Version 2 3 1 User s Guide Copyright C 2000 All Rights Reserved ASTER Division Mission Research Corporation MRC ASTER REVU Version 2 3 1 User s Guide REVU User s Guide Contents PBOUT REV scasicclaccecnccauceeecta uate adiasdaseutaavaectanacsaneusaraantdenaa saves 1 INSTALLING AND RUNNING REVU Page i MRC ASTER REVU Version 2 3 1 User s Guide About REVU This chapter describes the RAMS HYPACT Evaluation and Visualization Utilities REVU which is the standard supported package for generating graphical representations and reformatting RAMS model output VAN the old RAMS Visualization and ANalysis Package is no longer supported REVU s function is to read analysis files written from a RAMS or HYPACT simulation select user specified fields and cross sections from the file data and plot the field cross sections or output the selected data in one of several available formats e g VissD GrADS GRIB REVU utilizes NCAR Graphics to perform most of the plotting functions REVU can also pluck interpolated point data from the analysis files Similar to RAMS REVU is in a state of continual evolution This document is the third edition
21. a_e theta_v vapor 1 pristine pristine ice mixing ratio g kg RPP O O O snow snow mixing ratio g kg aggregates aggregates mixing ratio g kg graupel graupel mixing ratio g kg Ss hail hail mixing ratio g kg liquid liquid water mixing ratio g k RCP RRP RGP Q6 total_cond total condensate mixing ratio g kg RPP RSP RAP RGP Q6 RHP Q7 r_total total water mixing ratio g kg RV RCP RRP RPP RSP RAP RGP RHP dewptk dewpif dewpte relhum gt gt gt gt gt gt gt gt gt relhum_frac relative humidity fraction RV PI THETA C pris_concen ke cP smowconcen_kg agg concen kg graup_concen kg hail_concen_ke cloud _concen_em3 cloud cloud water mixing ratio g kg C P P rain rain mixing ratio g kg P P o aa r i l P cloud_concen_mg cloud droplet number concentration mg P oe P P P P ice ice mixing ratio g kg RPP RSP RAP RGP Q6 RHP Q7 rtotal_orig total water mixing ratio original method g kg rain_concen_kg rain number concentration kg Page 31 MRC ASTER REVU Version 2 3 1 User s Guide Field Name Description units Model Variables Fone wa age concen_3 graup_concen_m3 hail_concen_m3 ifn_conc IFN number concentration kg cloud_diam cloud droplet mean mass diameter microns RCP CCP ccn_concen CCN number concentration mg CCCNP rain_diam RRI
22. and output listings created here on our SGI Origin 200 are posted at ps www aSt r com revu 4 o5 es Dumping 2 and 3 D Fields Extracting data from the analysis file with the BeBe Le DUMP option writes full 2 and 3 D analysis file fields to an ASCI file Run REVU for the example input namelist files RAMSROOT bin revu f REVU_IN dump sigma RAMSROOT bin revu f REVU_IN dump cartesian RAMSROOT bin revu f REVU_IN dump pressur This should produce the dumped file from the standard analysis files AS 2000 07 30 120000 g1 AS 2000 07 30 120000 g2 AC 2000 07 30 120000 g1 AC 2000 07 30 120000 g2 AP 2000 07 30 120000 g1 AP 2000 07 30 120000 g2 m m m oaoa P E a goo tie maS O10 m m m If you wish to compare your output with ours the dump files and output listings created here on our SGI Origin 200 are posted at http www aster com revu 2 3 1 test Note that the user can modify the format of the output by modifying the code in src post 2 3 1 common dumpout f90 Page 11 MRC ASTER REVU Version 2 3 1 User s Guide Grabbing Point Data Extracting data from the analysis file with the ANATYPE GRAP option interpolates the analysis file data to the locations indicated by the frab_in file Run REVU for the example input namelist files RAMSROOT bin revu f REVU_IN grab RAMSROOT bin revu f REVU_IN ralph The GRAB run obtains the locations to get data
23. at http www aster com revu 2 3 1 test Page 9 MRC ASTER REVU Version 2 3 1 User s Guide Viewing with Vis5D Run REVU for the example input namelist files RAMSROOT bin revu f REVU_IN v5d sigma RAMSROOT bin revu f REVU_IN v5d cartesian RAMSROOT bin revu f REVU_IN v5d pressur This should produce the Vis5D files from the standard analysis files AS 2000 07 30 120000 g1 v5d AS 2000 07 30 120000 g2 v5d AC 2000 07 30 120000 g1 v5d AC 2000 07 30 120000 g2 v5d AP 2000 07 30 120000 g1 v5d AP 2000 07 30 120000 g2 v5d ovoeoo om Note the following filename conventions a A is the file name prefix of the analysis files excluding path S indicates that the file is on sigma surfaces C indicates that the file is on Cartesian surfaces P indicates that the file is on pressure surfaces and the date indicates the beginning of the RAMS simulation To view the Vis5D files run for example lt Vis5D path gt vis5d lt options gt v5d c_2000 07 30 1200 g1 To do this you need to download and install Vis5D free http www ssec wisc edu billh vis5d html If you wish to compare your output with ours the Vis5D files and output listings created here on our SGI Origin 200 are posted at http www aster com revu 2 3 1 test Viewing with GrADS Run REVU for the example input namelist files RAMSROOT bin revu f REVU_IN grads sigma RAMSROOT bin revu f REVU_IN grads cartesian RAMSROOT bin re
24. ce not all the locations specified in the LANDMARKS filelare plotted when doing so will cause label text to overlap or the plot to be cluttered controlled by the LANDMARK b component setting those locations that appear nearer the beginning of the file may get plotted at the expense of those later in the file Thus to ensure you see the locations you wish to see ensure those locations are at the top of the file in order of drawing priority Page 38 MRC ASTER REVU Version 2 3 1 User s Guide grab_in ib rai aramete by default ponie to the file gial This file specifies the nt to gra for an ANATYPE GRAB titude longitude location can be specified as either a point in space requires a heig R AC AGL to be given or a profile of the model levels The first line contains the file format version number integer The remaining lines are either comments or space delimited station location data one station per line stat lat lon elev type where stat station id number integer lat latitude degrees real lon longitud degrees real elev height AGL in m real 0 for itype 2 type 1 get point data at lat lon elev integer 2 get profile data at lat lon RAMS levels Noting that anything after a or is ignored For example 1 some test data and indicate comments st id lat lon elev itype 1 40 79388889 73 10166667 10 1 point data at 10m AGL 2 41 07305556 71 92333333 1
25. d in component 1 This is a string of colon delimited options Only those options you wish to specify need be included An array of examples follow the definitions e m Graduated color method integer There are a variety of ways to specify the color increments with contour or tile values all methods interpolate between colors in HLS space m0 Default color table mixture of predefined and easily distinguished colors Single color schemes m1 Single color scheme with component 7 first specified color at the maximum slab value fading to the background color at the minimum slab value m2 Single color scheme that is the same as mT but fades to the foreground color m3 Single color scheme with component 7 first specified color at the middle value lightening above to white at the maximum slab value and darkening to black at the minimum slab value Two color schemes m4 Two color scheme with component 7 first specified color coverg slab values greater than the central color value specified in option c and component 8 second specified color covering slab values less than the central color value The maximum saturation for the specified colors occurs at the maximum and minimum slab values fading to the background color at the interface the central color value default m5 Two color scheme that is the same as m4 but fades to the foreground color m6 Two color blending scheme with component 7
26. dard pressure levels 1000 925 850 700 600 500 400 300 200 and 100 mb IfC FRAME A CEIRAME B aj d CFRAME C inkicate multiple backgrounds and IZTRAN is not specified for a background then the IZTRAN for the first background will be used for the unspecified background i e in most cases you only need to specify IZTRAN for the first background Page 16 MRC ASTER IPLEVEL integer array MAPFILL integer IBACKGND integer IPLTINFO integer REVU Version 2 3 1 User s Guide eee pend pele plotting a horizontal cross section see Vv nd Y dI set to 3 IPLEVEL denotes a pressure surface in mb on which to generate the plot Only standard pressure levels 1000 925 850 700 600 500 400 300 200 and 100 mb may be specified IfC FRAME A CRIRAME B aj d CERAME C inkicate multiple backgrounds and IPLEVEL is not specified for a background then the IPLEVEL for the first background will be used for the unspecified background i e in most cases you only need to specify IPLEVEL for the first background If plotting a horizontal cross section see Z nd Y pecifies whether a map projection will be plotted and if so whether it will be color filled If set to 0 no map will be drawn If set to 1 draw a map outline filled contours and tiles will be drawn on top on the map If set to 2 draw a map outline and fills the land in green and water in blue If set to 3 as with 2 except the map outline will be d
27. e Announce archive You can apply to join the rams users mailing list at Inttp www aster com lists index shtml As always we appreciate any bug reports and compilation options that are different or not offered in the distributed make files Please see the notes on prar oa Vet seeking help Installing REVU This section describes the installation of REVU version 2 3 1 This version is compatible with RAMS version 4 3 0 UTILS version 1 0 0 and HYPACT version 1 1 0 The reader should also check the release notes in the README_REVU 2 3 1 file Note that all MRC ASTER software should be installed under a common rams directory usually this directory is named rams but it can be anything you wish This directory is referred to as the RAMSROOT in this user manual Downloading the Latest Version of REVU 1 Obtain the latest version of the software Either download the UNIX gzipped tar file revu 2 3 1 tar gz from the web address or download mrc 4 3 0 tar gz which contains REVU version 2 3 1 and the current UTILS and RAMS distributions from the web address 2 Move the tar file into RAMSROOT mv revu 2 3 1 tar gz RAMSROOT Page 2 MRC ASTER REVU Version 2 3 1 User s Guide 3 Unpack the contents of the tar file either gunzip c revu 2 3 1 tar gz tar xf or if you are on a Linux machine tar zxf revu 2 3 1 tar gz Upon completion of this step you should find the latest versions of the README file
28. e been updated Installing REVU The Make revu 2 3 1 install target will install as a symbolic link the executable to the run and test directories mak f Make revu 2 3 1 install You can modify Make revu 2 3 1 if you wish to install to alternative locations You can also manually link to the executables does the same as above In s bin revu On some machines you may need to make a physical copy of the executable in your test directory cp bin revu 2 3 1 revu Don t forget to update copied executables when you remake in the bin directory otherwise your changes will not appear in your runs Page 6 MRC ASTER REVU Version 2 3 1 User s Guide Cleaning the REVU Installation Make revu 2 3 1 also has a clean target that will remove built components To clean out the compiled libraries and executable mak f Make revu 2 3 1 clean This should remove the REVU archive library revu 2 3 1 a the REVU executable revu 2 3 and the link from revu to revu 2 3 1 Makefile also contains a clean_all target Entering the following will result in all libraries and executables being removed not just the REVU components make clean_all Running REVU 1 Check the settings of the variables in the parameter statements in vcomm2 h and change if necessary If you change any of these setting you will need to recompile REVU 2 Run RAMS Copy and configure amu the simulation to your working directory 4 Run the REVU execu
29. es locations file for NCAR Graphics plots aes ia REVU IN fpr sigma level 2 surface NCAR Graphics plots from the standard analysis files REVU_IN space sigma L REVU_IN fpr sigma level 2 surface NCAR Graphics the lite analysis files REVU_IN space pressure A R or 700 mb pressure surface NCAR Graphics the standard analysis files REVU_IN space vert A or vertical slice NCAR Graphics plots from the standard analysis files REVU_IN space tile A REVU_IN flor land cover surface NCAR Graphics rom the standard analysis files REVU_IN v5d sigma Vis5D output of the sigma levels REVU_IN v5d cartesian Vis5D output of the Cartesian levels REVU_IN v5d pressur Vis5D output of the pressure levels REVU_IN grib sigma GRIB output of the sigma levels REVU_IN grib cartesian GRIB output of the Cartesian levels REVU_IN grib pressur GRIB output of the pressure levels REVU_IN grads sigma GrADS output of the sigma levels REVU_IN grads cartesian GrADS output of the Cartesian levels REVU_IN grads pressur GrADS output of the pressure levels REVU_IN dump sigma Sigma level data extraction REVU_IN dump cartesian REVI IN flor Cartesian level data extraction REVU_IN dump pressur are pressure level data extraction Or i locations file for data extraction grab R hrab REVU_IN pr point data extraction j Ocations file for data extraction ralph REVU_IN ralph eee Tr point extraction amar EVU test revu test containing the command for the R Page 8 MRC ASTER REVU Versi
30. for from the gfab_in file falph_in for the RALPH2 output option This should produce the grab files from the standard analysis files a AS 2000 07 30 120000 g0 gbr dp s a AS 2000 07 30 1200 RALPH2 If you wish to compare your output with ours the grab files and output listings created here on our SGI Origin 200 are posted at Page 12 MRC ASTER REVU Version 2 3 1 User s Guide Reporting Bugs in REVU Before you seek help 1 Ensure that you have the latest version of the software Check for patches at RAMS Q REVU http www aster com 2 ieat shtml Inttp www aster com utils 1 0 0 patch shtml UTILS Notification of new patches will be sent to the rams users mailing list and are available for viewing on the Announce archive http www aster com lists announce You can apply to join the rams users mailing list at http www aster com lists index shtml If you are still having problems e Note your machine type operating system and version and compiler and version if possible e Copy the screen output to a file Try using the script command script a lt file gt to start the script shell and direct the output revu 2 3 1 run programs exit exit script shell Or redirect both standard output and error to a file For example running rams revu 2 3 1 1 gt amp 2 lt file gt Korn and Bash shells revu 2 3 1 gt gt amp lt file gt C
31. g sortware make make nem e All readme make and dependency files are distributed with a version number appended You can optionally remove this from the make file names do not remove them from the dependency file names Page 5 MRC ASTER REVU Version 2 3 1 User s Guide Compiling REVU To compile the software use either Mak f Make revu 2 3 1 or to use the global make file Makefile enter make revu This should produce the REVU archive libraries revu 2 3 1 a the REVU executable revu 2 3 1 anda link from revu to revu 2 3 1 or to use the global make file Makefile to update all the executables in your bin directory make This will ensure that all the executables are up to date noting that there are a number of source code cross dependencies in the software system If you need the dummy NCAR Graphics routines also enter make ncargd This should produce the NCAR Graphics dummy archive library libncarg 1 0 0 a Note that you need to select an alternative NCAR Graphics library set if you do not wish to use the dummies library NCAR now distributes the NCAR Graphics libraries and utilities used by MRC ASTER free of charge under the GNU general public license from the URL To recompile REVU when any of the RAMS or UTILS library modules are updated repeat the make command If you do not os build this will update the executable recompiling only those codes that have been updated or that depend on codes that hav
32. general if array elements for a background are missing the first array element is used If nothing is specified the default value is used If nothing is specified in FRAME_A FRAME _B qnd QFRAME C for a background nothing is plotted on that background GRAB Namelist Required only for run types ANATYPEF GRAB and described the I O of the grabbed data GRABIN Specifies the filename that contains the locations where we want to grab the data character Each latitude longitude location can be specified as either a point in space requires a height AGL to be given or a profile of the model levels The output data for each latitude longitude height location is then interpolat 3 f grid points on the finest possible grid specified by I specified below IGRABFMT Specifies the output data format integer e If set to 1 output selected CYRAME_A variables in an ASCI file format is specified below e If setto 2 output the data in the RALPH2 ASCI format ale that rT eee set in order to the following fields u v tempe dewptc and press Page 27 MRC ASTER REVU Version 2 3 1 User s Guide S GLL Namelist Required only for run types TT GRIB V5D or GrADS and described the latitude longitude grid that the output rpolated to IGRIDLL For output that is interpolated to a latitude longitude grid e g GRIB GrADS and integer Vis5D this specifies the method by which the size a
33. gest patch in the grid cell qveg_class_bp q vegetation class of the biggest patch in the grid cell The following variables are defined in RAMS for subgrid patches and remain defined by patch here They may be plotted only in horizontal cross section and only with the tile plot function These variables cannot be output to GrADS GRIB or Vis5D Field Name Description units Model Variables i canopy_temp_p canopy temperature by patch deg C ustar by patch m s Page 36 MRC ASTER REVU Version 2 3 1 User s Guide The following variables are defined in RAMS for land subgrid patches only and as a function of depth They are averaged over land patches here and are expanded to cover the entire grid regardless of how little area of the grid cell is occupied by land In grid cells that contain no land these field values will retain their initial values in the RAMS simulation These fields may be plotted either in horizontal or vertical cross section These variables cannot be output to GrADS GRIB or Vis5D Field Name Description units Model Variables soil textural class of biggest patch in grid cell i The following variables are defined in RAMS for all subgrid patches and as a function of depth They remain defined in that way here They may be plotted either in horizontal or vertical cross section but only with the tile plot function These variables cannot be output to GrADS GRIB or Vis5D Field Na
34. igh and low label controls integer The options for h are identical to cont those for T x Color ie contour and high low labels character and contour lines if option g set to less that zero default is lightgray s Size of the contour and high low labels real default is 0 01 First specified color used olorrepntours and fills character Use of this color is determined by the and gleptions above default is red Second specified color us T seal contours and fills character Use of this color is determined by the mand gloptions above default is blue Third specified color used for color contours and fills character Use of this color is determined by the d gloptions above default is green The default setting for CFRAME_A is CFRAME_A 1 none fb 0 0 0 m4 c0 b1 5 i5 d1 g30 tl 01 10 h0 s 01 xlightgray red blue green Examples CFRAME_A 1 tempc fb 10 30 2 0 m5 c20 xgray red blue will fill contours of temperature from 10 to 20 degrees centigrade at 2 degree intervals with the 28 to 30 degree area filled in red and the 10 to 12 degree area in blue The color fill dividing line is set to 20 degrees so on a black background with color scheme 5 the two areas either side to 20 degrees 18 to 20 and 20 to 22 will be filled in white The colors will graduate from white to red above 20 and white to blue below The contour lines will follow the same color pattern but each line will have a lightness offse
35. me Description units Model Variables The following variables are made up from a combination of leaf2 variables defined by both patch and depth and those defined by patch only plus atmospheric variables from the lowest model level They remain defined in that way here They may be plotted only in vertical cross section and only with the tile plot function These variables cannot be output to GrADS GRIB or Vis5SD Field Name Description units Model Variables moisture of all leaf2 components SCHAR TGP WGP leaf2_temp temperature of all leaf2 components SCHAR Page 37 MRC ASTER REVU Version 2 3 1 User s Guide REVU Input Files The in rca a for all REVU runs is described in full above Two other input files are de LANDMARKS If plotting a horizontal cross section see TA E and and the LANDMARK parameter is set to draw landmarks the locations available for plotting are specified in the JANDMARKS file which must reside in the run directory Landmark locations are specified by a name up to 16 characters in length and its latitude longitude coordinates as either degree minute second integer qualities or degree real quantities noting that line beginning with are ignored For example NY ISP 40 47 38 073 06 06 MTP 41 04 23 071 55 24 LGA 40 46 45 073 52 48 POU 41 37 32 073 52 55 Is equivalent to NY ISP 40 7939 73 1017 MTP 41 0731 71 9233 LGA 40 7792 73 8800 POU 41 6256 73 8819 Sin
36. nclude an array of new color fill schemes for tiles and contours and line colors for contours and vectors They also include user defined color options control on axis and tile colors white background and grayscale color options and control on landmark plotting e Panels option draws up to 4 plots per frame e Accepts 1 argument f for pointing to non standard REVU_IN file names i e revu 2 3 1 f lt namelist file gt e Dump option and correct plotting of soil variables e In addition many of the routines now use implicit none statements and all c iralloc memory allocations are now done with FORTRAN 90 allocations This has allowed us to do bounds checking on arrays has which in turn has resulted in the cleaning up of a number of known and unknown bugs Page 1 MRC ASTER REVU Version 2 3 1 User s Guide Installing and Running REVU The REVU version 2 3 1 code is FORTRAN 90 compliant REVU has been compiled and run on SGI HP IBM SUN DEC Alpha and PC Linux workstations If you are compiling on other platforms we would like to know what compiler options you use To convey this information please contact Keeping Up To Date with REVU The latest version of REVU is available from Inttp www aster com revu shtml Patches will be made available at http www aster com revu 2 3 1 patch shtml as they are made Notification of new patches will be sent to the rams users mailing list and are available for viewing on th
37. nd resolution of the output grid are determined e If setto 0 the remaining variables in this namelist specify the size and resolution of the latitude longitude grid e If set to 1 the max zed latitude longitude grid that fits within the RAMS grid specified by remap k determined in the code e If set to 2 the minimum sized latitude longitude grid that contains the RAMS grid specified by s determined in the code GLLDLLAT If IGRIDLL specifies the latitude grid spacing of the latitude longitude grid real GLLDLLON IfI dripLi specifies the longitude grid spacing of the latitude longitude grid real GLLWLON If 1dRIDLL b specifies the western edge of the latitude longitude grid real GLLELON If IGRIDLL specifies the eastern edge of the latitude longitude grid real GLLSLAT If IGRIDLL specifies the southern edge of the latitude longitude grid real GLLNLAT RLL b specifies the northern edge of the latitude longitude grid real Page 28 MRC ASTER REVU Version 2 3 1 User s Guide STATS Namelist Required only for run types A AEREE STATS and describes the run mode and T O CMODE character SFCPREF character RWNPREF character NOQ character IPDIFF IPVALS IPWIND IPHIST IPCONT integer Specifies the observations to process e If set to all process both surface and upper air observations e If set to sfc process surface only e If set to rawin process
38. o500 integer Page 14 MRC ASTER REVU Version 2 3 1 User s Guide REVU_IN Namelists The namelist file REVU_IN contains four namelists with the names eel cael The s required for all runs and specifi scenario and all plotting Sap ny e SPACE The remaining namelists all control some portion of the non plotting A ttings and are not always required CONTROL Namelist In the following documentation a background or frame refers to the plotting or output of each ne oe as a except in the case where multiple panels are plotted into a single frame as specified by ANPREF The UNIX path name and prefix of the names of RAMS or HYPACT analysis files to charachter be read and used to drive REVU up to 128 characters Note that the path name is optional and can be either relative or absolute no path is equivalent to Depending on what was output by RAMS or HYPACT ANPREF could be lt prefix gt A lt date gt Standard RAMS analysis files lt prefix gt L lt date gt Lite RAMS analysis files lt prefix gt M lt date gt Averaged RAMS analysis files lt prefix gt B lt date gt Lite averaged RAMS analysis files lt prefix gt C lt date gt HYPACT analysis files lt prefix gt is the directory location and file prefix given by AFILOUT or HYPPREF the RAMS and HYPACT output files name prefixes respectively lt date gt is the output filename date string in which UNIX wild cards can be used for example lt
39. ocation and size of the two ZVAR dimensional slab to be plotted or 3 dimensional field to be extracted Each is a slash delimited text string with two components the second of which has further colon YVAR arse delimiting XVAR The first component is a single character that describes how this direction will appear character array on the background and is only relevant if plotting The characters and their meanings are described as follows e H direction will be plotted horizontally e V direction will be plotted vertically e F fix the direction to the following value Note that the option of plotting variables with respect to time is not yet implemented The second component specifies the range information for the directions and time and is applicable to all types of REVU runs The syntax is left_value right_value increment where the values if positive are actual grid point values If the left or right values are negative or zero they are interpreted as an offset from the boundaries of the grid For the time ee to the filtering of A If C d CF dicate multiple backgrounds and TVAR indicate multiple times then the settings for each background apply to each time If plotting the increment is only applied to T in TVAR If the increment is not specified it defaults to 1 Page 20 MRC ASTER REVU Version 2 3 1 User s Guide For example and series of vertical Y Z slabs may be specified as TVAR 1 F 1 5 1 ZVAR 1
40. on parameters The following variables are defined in RAMS for land subgrid patches only They are averaged over all land patches and are defined for the entire grid cell regardless of how little area of the grid cell is occupied by land In grid cells that contain no land these field values will retain their initial values in the RAMS simulation These fields may be plotted only in horizontal cross section Field Name Description units Model Variables soil roughness height by grid cell m vegetation fractional area by grid cell T i g i ie i ground mixing ratio by grid cell g kg The following variables are defined in RAMS for all subgrid patches They are averaged over all patches here They may be plotted only in horizontal cross section Field Name Description units Model Variables net roughness height by grid cell mi canopy mixing ratio by grid cell g kg canopy_temp_ps canopy temperature by grid cell deg C grid cell deg C grid cell deg F ustar by grid cell mis Page 35 MRC ASTER REVU Version 2 3 1 User s Guide The following variables are defined in RAMS for all grid cells but they are not quantities that can be averaged A single value is taken here for the entire grid cell from the subgrid patch having the largest area in the cell They may be plotted only in horizontal cross section Field Name Description units Model Variables veg_class_bp vegetation class of the big
41. on 2 3 1 User s Guide If you have not put your RAMSROOT Ybin directory in your path go to your RAMSROOT Ybin directory and ifstall the executables in your test directory or use full or relative path references in the following commands Viewing with NCAR Graphics Run REVU for the example input namelist files RAMSROOT bin revu f REVU_IN space sigma A RAMSROOT bin revu f REVU_IN space sigma L RAMSROOT bin revu f REVU_IN space pressure A RAMSROOT bin revu f REVU_IN space vert A RAMSROOT bin revu f REVU_IN space tile A Each should produce the NCAR Graphics gmeta files gmeta space sigma A gmeta space sigma L gmeta space pressure A gmeta space vert A gmeta space tile A Each time you run REVU you will overwrite the gmeta file If you do not have NCAR Graphics or compiled without it the gmeta file would not be produced even though REVU appears to run to a normal completion To view a gmeta file run either idt gmeta or ctrans gmeta NCAR now distributes the NCAR Graphics libraries and utilities used by MRC ASTER free of charge under the GNU general public license from the URL Inttp ngwww ucar edu ng4 2 download ary SPACE runs will use the IUNDMARKSfleif you have one to chart The NCAR Graphics ANA locations on your horizontal slab plots If you wish to compare your output with ours the gmeta files and output listings created here on our SGI Origin 200 are posted
42. on between markers b 03 gives a spacious separation and b 01 gives a tight packing t component integer Controls the marker type t1 dot t2 plus t3 asterisk t4 circle t5 cross s component real Controls the scale of the markers s1 is a good setting x component character string The color of the marker THis can bd any in the color table below or any user defined color specified by COLORS The Label components L component integer Label control LO does not label the landmarks and L1 labels the landmarks s component real Controls the size of the label characters s 01 is a good setting x component character string The color of the label This Peai in the color table below or any user defined color specified by C For example a LANDMARK setting of LANDMARK 1 M1 b 03 t2 s1 xyellow L1 s 01 xred Draws yellow makers and red labels with sufficient buffer as to avoid a clutter of mar If Te eee CRRAME inllicate multiple backgrounds and LANDMARK is not specified for a background then the LANDMARK for the first background will be used for the unspecified background i e in most cases you only need to specify LANDMARK for the first background Page 18 MRC ASTER REVU Version 2 3 1 User s Guide COLORS p f plotting specifies the re mapping of colors in the color table COLORS is a slash character array delimited text string Each slash delimited component has a further two or four colon
43. ormation table If set to 2 draw the reduced plot information not in table Page 17 MRC ASTER IPANEL integer LANDMARK character array REVU Version 2 3 1 User s Guide If plotting specifies the number of plots drawn per frame 1 to 4 e If set to 1 one plot is drawn on the full Jena rea ky drawn rss of plots specified by nd If set to 2 3 or 4 that number of plots are drawn per fra et a frames drawn equals the number of plots specified by cel and CHBAME divided by the IPANEL setting The size of each plot is one quarter the size of the plots when IPANEL is set to 1 Also a reduced set of plot information is included for each plot and the axis appear without any labels You can use this setting to create classic four panel plots If set to 0 not plotting is done Instead a series of tables are output with the colors that are going to be used in the first frame i e taking into account the settings of CERAME AC MACKGND J If plotting a horizontal cross section see drawing of the landmarks specified in the string that has two slash delimited components the first controlling the drawing of the markers and the second controlling the labeling of the markers Each of these has further colon delimited components The maker component M component integer Marker control MO does not mark the landmarks and M1 marks the landmarks b component real Landmark separation or buffer min separati
44. perature deg F UP VP THETA TOPT TGP SCHAR GSF PI clear sky fraction fraction RV PI THETA speed10m 10 meter height wind speed m s UP VP THETA TOPT GSF SCHAR TGP cloud cover fraction fraction pbl_ht planetary boundary layer height m totpcp surface accumulated resolved precipitation mm liquid ACCPR ACCPP ACCPS er ic cen rca ST totpcp_in surface accumulated resolved precipitation inches ACCPR ACCPP ACCPS a a EEE precip_in surface accumulated resolved plus convective ACCPR ACCPP ACCPS one ACCPA ACCPG precipitation inches liquid equivalent ACCPH ACONPR peprr surface precipitation rate of rain mm hr liquid PCPRR equivalent equivalent equivalent equivalent equivalent kg m 2 timestep J m timestep m Page 33 precip surface accumulated resolved plus convective ACCPR ACCPP ACCPS s ox ACCPA ACCPG precipitation mm liquid equivalent ACCPH ACONPR surface accumulated aggregates kg m i surface accumulated rain kg m surface accumulated graupel kg m f i surface accumulated pristine ice kg m ACCPP surface accumulated snow kg m ACCPS pcprp surface precipitation rate of pristine ice mm hr liquid PCPRP equivalent MRC ASTER REVU Version 2 3 1 User s Guide Field Name Description units Model Variables pcprate resolved surface precipitation mm hr liquid PCPRR PCPRP PCPRS equivalent PCPRA PCPRH PCPRG a CONPRR pcprate_in
45. rawn on top of all filled contours and tiles If set to lt 0 as with any setting of MAPFILL gt 0 but with the map outline drawn in a highlighted shadow enhances the geographic boundaries Users can modify the mkmap f90 module to draw other geographic and demographic information the user will also need to supply the data If plotting specifies the plot background color If set to 1 the plot background is set to black and the foreground to white This setting is intended for display on electronic media If set to 2 the plot background is set to white and the foreground to black This setting is intended for display on electronic media If set to 3 the plot background is set to white and the foreground to black This setting is intended for display on white paper If set to lt 0 as with any setting of IBACKGND gt 0 but all colors are set to the foreground color titles plot scales etc and grayscale map fills filled contours and tiles Users can modify the rcolors f90 module to specify their own color schemes especially relevant to setting up the color tables for printing on specific printers noting that some user color customization is available with CDLORS without any modifications to the code If plotting specifies whether to draw the plot information table that appears at the bottom of each plot If set to 0 do not draw the information table this maximizes the plot space for the actual plot If set to 1 draw the inf
46. shell e Note what configuration or make files were used e Send to all of this plus any other supporting information to rams support aster com Future Developments in REVU Future upgrades may include Splitting of REVU into its two main components graphics and data reformatting extraction Ability to open and operate on more that one list of files e g view different runs or compute difference fields Reorganization of the memory structure and addition of a buffer that that within the buffer size the analysis files are not reread for information that has already been read Color for HYPACT particles by age source and species elevation or any other input parameter Inclusion of a HYPACT concentration grid for more detailed viewing of inferred Lagrangian particle concentrations Completion and distribution of the REVU GUI RINGI Further development ideas and collaborative development are welcome and can be directed to rams support aster com Page 13 MRC ASTER REVU Version 2 3 1 User s Guide REVU Configuration Parameters Most REVU specific parameters are set in vcomm2 h MAXFORE The maximum number of variables to plot or output default set to 30 integer MAXFILS The maximum number of input files default set to 200 integer MAXLOC The maximum number of observation locations default set to 1000 integer MAXLEV The maximum number of levels in a profile default set t
47. st 2 3 1 common 5 You may then wish to remove read permissions from the new module chmod u w RAMSROOT src post 2 3 1 common vplt 90 Page 3 MRC ASTER REVU Version 2 3 1 User s Guide Preparing to Compile REVU Before you compile the software 1 Go to the bin directory cd RAMSROOT bin 2 If you have not done so already move the Makefile std to Makefile unless you are already using a non standard version of this file i e Makefile hypact mv Makefile std Makefile Page 4 MRC ASTER REVU Version 2 3 1 User s Guide 3 Either if this is your first time using include mk move the include mk std to include mk and modify it with vi for example to suit your system mv include mk std include mk vi include mk include mk contains all the make environment variables that a user might need to change in order to compile the code on their machine It is included in all of the make files using the include command FIRST TIME USERS MUST CUSTOMIZE THIS FILE BEFORE THEY ATTEMPING TO MAKE By default include mk std does not have the NCAR Graphics libraries or the compiler flags for any machine type switched on Or if you already have a copy of include mk that you have modified to suit your system check your include mk with the new include mk std for software system changes in include mk std and make those changes to your include mk with vi for example diff include mk include mk std vi include mk e dep_revu
48. t of 30 from the fill color Contour line and high low labels will be drawn in gray without boxes or fill A color scale bar will also be drawn CFRAME_A 2 relhum f 50 100 5 m1 g20 h 1 xblue midblue will fill contours of relative humidity from 50 to 100 at 5 intervals The 95 to 100 interval will be filled with midblue From there the fill colors will fade to the background color in the 50 to 55 interval Contour lines will be drawn with a 20 lightness offset from the adjacent fill color and contour line labels will be drawn in blue No high low labels or color scale bar will be drawn CFRAME_A 3 relhum c c50 g 1 h 1 yellow purple will draw contours of relative humidity from the minimum value in the plotted slab to the maximum value with some convenient interval still centered around a central color value of 50 With the central color set at 50 yellow contour lines of the same color will be drawn above 50 and purple below Not high low labels or color fill scale bar will be drawn Note that the s after the c are placeholders for the contour range and interval settings They will take on the default values The placeholders are required as order and occurrence of each component in the slash delimited string is important Page 25 MRC ASTER REVU Version 2 3 1 User s Guide CFRAME _B m If plotting CFRAME B specifies what wind information should be plotted It is a character array
49. table in your working directory using either revu 1 3 1 or if using a REVU_IN file with a non standard name revu 2 3 1 f REVU_IN non standard 6 To view or inspect the REVU output files refer to the examples set out in the Page 7 MRC ASTER REVU Version 2 3 1 User s Guide REVU Test Runs This section describes the running of REVU version 2 3 1 for the test run posted at the URL The U gzipped tar file contains those files required to run the simulation view the results with NCAR Graphics Vis5D or GrADS and extract data from the analysis files The results of each of these and the list files containing the run time screen output are post on our web site at Inttp www aster com revu 2 3 1 test Because of their size these have not been made available for downloading in a single archive file If you wish to compare you output with the output created here on our SGI Origin 200 you can download the specific files Preparing the Test Run 1 Download the UNIX gzipped tar file from the above URL revu test 2 3 1 tar gz 2 Unpack the contents of the tar file in your rams root directory gunzip c revu test 2 3 1l tar gz tar xf 3 Go to the test directory and check its contents cd test ls l This should produce the following README _REVU_TEST Latest test release not
50. ue lt 19 skyblue 56 royalblue 245 slateblue 235 bluemagenta 0 darkviolet magenta lavender Oo Oo Oo ol ol ol Oo ol ol ORODWVDOVODVDVOVOOVOFRRFRFOOO DOVDVDVGVGOVOFRFODORFODOGVC0O0O PROFRPDOWDDOFODDODVGVOOOOFF 0 0 8 Or OCC OC OC ORPFF OOOO C CF AODHDDDODAHDDDDDWDOUAUAWOO PRODDOFRPFRFPWODOVODVDDVOOOOCO DWODHDDDVODWDUNADHDWOOMOWAWO OGOGrPrePeRBPRPOGOGOGOOOOGOOOOGOH DWODVDWDUAHDDDAHDWDDAUNAWOO Page 19 MRC ASTER REVU Version 2 3 1 User s Guide COLORS Background dependent colors cont Name Black Backgnd White Backgnd Description titled 0 titlel eal title2 295 axis roads0O 1 information box 1 0 1 0 roadsl 0 0 0 0 0 0 first info line second info line axis and labels roads filled roads outline land water map lines filled bound1 map lines outline shadow0 map shadow filled If C d CF icate multiple backgrounds and COLORS is not specified for a background then the COLORS for the first background will be used for the unspecified background i e in most cases you only need to specify COLORS for the first background ol ol ol ol ol land water boundo U Oo DOVVWARDOOO FPODWDDOOOFOOF ODWOOCVDVCOCOFROCOF DOONWDAHDDOOA IO ODF OADAAODOOFO OrRrFOFRFGCGOWGOOCOCO DOWVOWWDAVDOWNOO eT HT gt He PE G OGOGOOPOG GOOGOOGO DODKRODADHDON WO TVAR Character strings that specify the orientation l
51. vu f REVU_IN grads pressur This should produce the GrADS files from the standard analysis files AS 2000 07 30 120000 g1 AS 2000 07 30 120000 g1 AS 2000 07 30 120000 g2 AS 2000 07 30 120000 g2 AC 2000 07 30 120000 g1 AC 2000 07 30 120000 g1 AC 2000 07 30 120000 g2 AC 2000 07 30 120000 g2 AP 2000 07 30 120000 g1 AP 2000 07 30 120000 g1 AP 2000 07 30 120000 g2 AP 2000 07 30 120000 g2 tl K w tl 6K w t K w t C K w qa ea aeaweaaeawaea K w t cToa oaoonDHOAHM YM WM H Q K w To view the files you need to download and install GrADS free RECE Grads i1des org qrads Page 10 MRC ASTER REVU Version 2 3 1 User s Guide If you wish to compare your output with ours the GrADS files and output listings created here on our SGI Origin 200 are posted at Inttp www aster com revu 2 3 1 test Output to GRIB Run REVU for the example input namelist files RAMSROOT bin revu f REVU_IN grib sigma RAMSROOT bin revu f REVU_IN grib cartesian RAMSROOT bin revu f REVU_IN grib pressur This should produce the GRIB files from the standard analysis files AC 2000 07 30 120000 g1 grb AC 2000 07 30 120000 g2 grb AP 2000 07 30 120000 g1 grb AP 2000 07 30 120000 g2 grb AS 2000 07 30 120000 g1 grb AS 2000 07 30 120000 g2 grb oo oo mw If you wish to compare your output with ours the GRIB files

User`s Guide

Contents

Download Pdf Manuals

Related Search

Related Contents