RSM/CVS System - Center for Ocean
Contents
1. After setting the parameters in expscr script name in Type configure scr script name to recreate the main run script A utility prmap in lib etc is useful for checking the domain definition e prmap script name takes the model resolution from rsm define h and model domain parameters from the main run script script name and create prmap ctl and prmap data e Open prmap ctl in GrADS and plot the domain 17 1 Mercator projection RCENLON RCENLAT RLFTGRD INT Lx RDELX RBTMGRD INT Ly RDELY 2 polar stereographic projection pole Ly Lx RORIENT RLFTGRD INT Lx RDELX RBTMGRD INT Ly RDELY 5 Understanding the Model Structure 5 1 RSM CVS model code tree libs gt con lib etc makefiles opt_libs RSM CVS sres gt sre Tree def Structure opt bin evs docs makefiles run gt runscr expscr evs docs output Each directory has CVS and CVSROOT directories src gt albaer chgdates chgr cldtune cnvaer cnvalb cnvrt co2 fest include mpi mtn pgb rbln rchgdates rfcst rfcst par rgsm rgsm par rinpg rinpr rloc rmpi rmrgsfc rmtn rpgb rpgb par rsfc rsgb rsml rsml par sfc sfc0 sfcl sfcl par sgb share 19 5 2 File name conventions Source and library related files F source codes with C processor di2. to complete the compilation for the program runs directory configure scr run scripts configuration script expscr directory contain templates for main run scripts runscr directory contains various run scripts called by the main run scripts cvs docs directory contains help files 21 6 Model Integration Road Map rsm src directory has source codes rsmonly rfcst driving routine Blue directory Green subroutine Initialization e rgetcon rfcst e rsmini rsml e tread rgsm 2 Increment hour e g 6 hours of Time integration global boundary forcing e rsmsmf rsml Save output e rsmsav rsml 22 6 1 Initialization rgetcon rfcst e set model integration constants e set table for model physics rsmini rsml e set more constants beyond rgetcon e rsminp rsml read global base field gsm2bed rsml transform spectral global input field to regional grid Sread rsml read regional sigma field to obtain regional perturbation in wave coefficients e rfixio rsml read regional surface fields tread rgsm read next global base field 23 6 2 Time integration rsmsmf rmsl main routine e Intermediate outputs INTSIG Surface merge INTSFCX Post processing INTSIG Increment of model time step e g dt 360 sec 24 6 3 Save output swrite rmsl output regional sigma file r sig ftxx rloopz rm
3. RSM CVS System User s Manual Experimental Climate Prediction Center Scripps Institution of Oceanography La Jolla CA http ecpc ucsd edu projects RSM by Hideki Kanamaru hkanamaru ucsd edu Jongil Han and Masao Kanamitsu Version 2 1 Updated on August 25 2004 Contents Soi M EET 2 Tentou EO cs sci ci EN 3 2 Installation of CVS System and RSM sss nennen nennen nennen enne nen entere 4 2 1 CVS System Installation eeeeseeeeiesesesesee eee ee enne tn enne tn enn tn tete Eisai E trenes tren nein nennen 4 D Installatiofi oret EuE Un UU E LIU UM LEE 4 206 VS commands Sarre aa a M ML E DELE 5 2 2 Installation of RSM CVS system sese nre nre nene rte nre nre 6 3 Overview of Model System Structure sess entente nnns 8 2 Runiinsihe Modelo ieren eais VUE EE M UM ICI rd 10 4 1 Test run using rs script enne nnne ener nennen nnns 10 4 2 Reading the output files esses enne enne enne nennen enr nnne nnne nnns 12 4 3 choosing the model resolution sss nennen enne nnne nnne nnns 13 4 4 Changing other model options sss ener enne enne nnne nnns 15 4 5 choosing the model domain need eet ER eet E Het i Hd eae EEEE 17 1 Mercator projection ener e D Ee RR HE E Pe HEU Ee obe ER Te dd 18 2 polar stereographic projection ener enne enne nennen nnne nennen 18 5 Understanding the Model St
4. _inpg calls rinpg x and does interpolation for the regional model domain This script takes r smooth orogegd sig ft00 and sfc ft00 as input and will create r sig ft00 and r sfc ft00 The output message is in rinpg out e runscr sfcO calls sfcO0 x and renews r_sfc files using grib data input The script creates r sfci r sigit and r sigitdt The output message is in sfc0 out e A few libs etc scnvrt calls create base sig ft00 base sig ft06 base sig ft12 and base sig ft18 e The main forecast program rfcst x is called from runscr r fcst For the first 12 hours the output messages are in r fcstout ft12 and the model creates r_flx ftxx r sig ftxx and r sfc ftxx every 3 hours e rfcst x exits after 12 hours and runscr r_pgb calls post processing program rpgb x It will create r pgb ftxx every 3 hours from r sig ftxx and r flx ftxx as well as rpgbout ft0 12 e The integration continues till 48 hours running rfcst x and rpgb x alternately every12 hours 4 2 Reading the output files A successful model run will create r_pgb ftxx files as well as r_sig ftxx r sfc ftxx and r flx ftxx files Binary files e sigma file r sig contains prognostic fields on model o P P level e surface file r sfc contains fields besides the sigma file most of which are surface fields 12 flux file r flx contains diagnostic fields GRIB format files post processed file
5. bal base field resolution regional grid resolution INSTITUTION ecpc sdsc compas arsc esc navo nersc other Institution name MARCH single thread mpi hybrid Machine CPU usage type NCPUS number NPES number Number of CPUs threads PEs nodes both are 1 for single NCPUS gt 1 and NPES 1 for thread NCPUS 1 and NPES gt 1 for mpi and NCPUS gt 1 and NPES gt 1 for hybrid e Run scripts runs directory Runs the model and stores the model outputs When installer does not work cvs co scr_rsm will download the run scripts Edit configure scr as follows See the next section for the next steps configure scr variables SRCS DIR rsm directory rsm directory location UTION ecpc sdsc compas arsc esc navo nersc other Institution name Batch script templates are available in INSTIT NCPU P runscr directory for some of the listed institutions ER NODE number Number of CPUs per node for mpi run 4 Running the Model 4 1 Test run using rsm script Move to runs directory The installer created rsm script in the directory from expscr rsm in file as a template If you want to make changes to the main rsm run script you can either edit the rsm script directly or edit the template expscr rsm in and configure scr rsm configure scr takes script_name as a
6. ch Lab NOA1 maximum one vegetation type considered in each cell NOAL is available on RSM CVS define NOALSM1 in physics h e VIC Variable Infiltration Capacity Developed in the University of Washington Seattle and Princeton University VICI maximum one vegetation type considered in each cell VICI will be available on RSM CVS soon e CLM Common Land Model Developed in NCAR NASA GIT and Beijing Normal University Combined the best features as possible of NCAR LSM Bonan 1996 BATS Dickinson 1993 and IAP94 Dai and Zeng 1997 CLM will be available on RSM CVS soon 16 4 5 choosing the model domain If you want to change the model domain you need to edit the main run script or its template in runs expscr Mapping and domain parameters in the main run script mapping projection index 0 for Mercater projection MP 1 for north polar stereographic projection NPSP 1 for south polar stereographic projection SPSP RTRUTH latitude where the map plane cuts through the earth s surface A north latitude for MP 60 for NPSP 60 for SPSP domain orientation longitude grid spacing in meter in x direction at TRUTH grid spacing in meter in y direction at TRUTH reference latitude domain center latitude for MP 90 for NPSP 90 for SPSP reference longitude domain center longitude for MP 0 for both NPSP and SPSP LFTGRD a grid number in x direction BTMGRD a grid number in y direction
7. do not edit define h in rsm def rsm rz e Instead edit define h in rsm directory e All the model options are set using define and undef e Type configure model again e Choose configure with modified define h e Type make Some model options in define h define NEWSFC if defined use new surface physics undef NEWGWD if defined use new gravity wave drag formulation undef CLDADJ if defined conduct cloud adjustment define SAS if defined simplified Arakawa Schubert cumulus cloud scheme ndef RAS if defined relaxed Arakawa Schubert cumulus cloud scheme if ncldg 0 undef ICE undef ICECLOUD else for consideration of the effect of ice define ICI and ice cloud on radiation define IC endif undef NI ifdef NI if NEWSFC is defined define NI use new albedo types endif define G2R if defined nesting from global to regional grid undef C2R if defined nesting from coarse to fine regional grid 15 Land surface schemes rsm def physics h e OSU Oregon State University land surface scheme OSUI the old version of OSU and used in NCAR NCEP Reanalysis study OSU2 the new version of OSU and the land surface vegetation and soil type properties obtained from grib files OSU2 is available on RSM CVS Zdefine OSULSM2 in physics h e NOAH NOAH land surface model Developed in NCEP OSU Air force Hydrologic Resear
8. e speedup is about 300 for 4 CPUs e Users can always access the latest version of the model through the CVS system 2 Installation of CVS System and RSM 2 1 CVS System Installation ECPC SIO Repository Develop and update the code Model Developers 1 Installation Copy and update the code e First check whether you already have CVS on your system Type cvs h e Ifyou do not have CVS get the source codes or binaries from the cvs home page https www cvshome org e On CVS site go to CVS downloads and go to CCVS archives for source codes and CCVS binaries for binaries and install them by following the README file e Prior to CVS installation the computer system should meet the following requirements C compiler is installed Fortran 90 compiler is installed There is adequate disk space e For example to install the source codes of CVS l gunzip cvs 1 11 16 tar gz 2 tar xvf cvs 1 11 16 tar 3 cd cvs 1 11 16 4 configur prefix directory to install cvs 5 make 6 make install e Set environmental variable and add the cvs executable directory to your path For example add the following line to the cshrc file set PATH path cvs executable directory e Set environmental variable CVSROOT to the CVS server at ECPC SIO setenv CVSROOT pserver anoncvs rokka ucsd edu rokkal kana cvs server root cpscvs 2 CVS commands login Type cvs login only o
9. l to the model resolution that is set above in RDELX and RDELY INTOUT 3 The model output files r sig r flx r sfc and r pgb interval in hours Passed to INTSIG later in the script NESTING HOUR 6 The nesting interval from the global file in hours SWHR REG 1 The shortwave radiation computation interval for regional model Usually 1 hour LWHR REG 1 The longwave radiation computation interval for regional model Usually 1 hour INTSFCX 24 Grib surface files merging interval It should be equal to or greater than 24 hours INCHOUR 12 Forecast hour per one execution of the main forecast program rfcst x 11 Before running the rsm script make sure that the stack size is set to unlimited ulimit s in bash should return unlimited Run the rsm script by typing rsm or submit rsm as a batch job The script will create r_000 directory and output files will be created in it Several run scripts will be called in rsm script e runscr r_mtn calls rmtn x and does orography for regional model resolution This script takes 4 files named top asc as input and will create r mtnvar r oroggd r orogrd r slmsk r smooth oroggd Look in rmtn out if there was an error e libs etc senvrt calls scnvrt x in the library and generates rsm initial conditions from global files sig ft00 and sfc ft00 This script leaves scnvrt out e runscr r
10. momentum terms of number of time steps arger number implies less diffusion mber of E W Gaussian grids in global input data mber of E W Gaussian grids in global input data u m tj Q 3 lsoil 2 lalbd 4 mtnres 8 ncldg 0 Ans nstype 9 nvtype 13 igrd 96 mM jgrd 69 WM levr 28 cigrdl 192 cjgrdl1 94 relx 5 U L2B BAAD A Pe BA Bae eae ROS FOr t TEE ncated wave number in global input data ber of vertical sigma levels in global input data Sad 355A SAB DO Go back to rsm directory and edit configure model to set MODEL DEFINE to the directory of your resolution The following steps are common procedure for recompiling the entire rsm directory after changing variables in configure model or compiler options in rsm opt directory make clean will delete all the files that the previous compilation created 14 Type configure model to recreate new Makefiles and define h machine h modisigs h and postplevs h Type make to recompile the source codes and create new executables 4 4 Changing other model options You can change model parameters and recompile the entire rsm directory e Type make clean e Type configure model e Ifyou want to save the default settings
11. n argument and creates main run scripts from the specified template The main run script template has to be in expscr directory as script_name in There are several run script templates available e rsim Performs rsm long integrations forced by global analysis or forecasts Various options are available for monthly average calculations and archives e rcases Performs many short rsm integrations forced by short global forecasts e rsm Performs test run explained below configure scr also creates other scripts in runscr directory from their templates The scripts in runscr directory are called by the main run scripts For the test purpose we use rsm script The rsm script runs from 1990 March 9 00 hours for 48 hours The initial and boundary conditions are pre made and stored in libs con directory The key parameters are explained below 10 RUNNAME r 000 The name of the directory where the output files are created rsm domain specifications see also 4 5 PROJ 1 RUTH 60 RIENT 100 ELX 60000 The model resolution in x direction in meters ELY 60000 The model resolution in y direction in meters AT 90 ON 0 LFTGRD 49 RBTMGRD 134 O H Q Q XMMdwwmxxo model parameters ENDHOUR 48 End of the forecast integration in hours DELTAT REG 360 The model time step in seconds It should be roughly proportiona
12. nce and just hit return at the password prompt to login the CVS server as a username anoncvs as specified in CVSROOT in cshre file The access is read only Some useful CVS commands cvs co module name Copy the directories and files registered under module name cvs diff file name Show the difference between your file and the file in the repository cvs status file name Show the status of the file name cvs log file name Show the detailed log of the file name 2 2 Installation of RSM CVS system After installing the CVS system go to the directory where you want to install RSM The installer will create three directories libs rsm and runs Make sure you add To your PATH in cshrc file Go to the directory where you want to install the model Type cvs co install This will download install script from the CVS server at ECPC SIO that you designated in your cshrc file Type insta11 Do not forget to put to make sure that the local script file install is called Type install help for various installer options Follow the instructions on the terminal 1 Introduction For detailed install options look at this install script Install G RSM library source and run scripts from cvs repository for available options exit and type install help press enter to proceed or type x to exit HIT ENTER 2 Choose the model to install gsm r
13. nfigure libs configure model configure scr are set automatically by the installer but it is useful to understand how the model is configured in case installer fails to work or you want to recompile the model e Library libs directory Contains model libraries utilities and constant fields e g climatological and orography data Independent of model resolution but machine dependent Made only once When installer does not work cvs co libs rsm will download the library Edit configure libs as follows Type configure libs Type make configure libs variables MACHINE linux ibmsp dec sgi nec es mac origin sun hp cray t90 t3e Machine type MARCH single thread mpi hybrid Machine CPU usage type e Source codes rsm directory Contains model source codes Generates model resolution dependent constants Defines model resolution and options Compiles the codes and creates run executables When installer does not work cvs co src_rsm will download the source codes Edit configure model as follows Type configure model Type make configure model variables LIBS DIR libs_ directory libs directory location MODEL gsm rsm crsm gdas Model type MODEL DEFINE rsm_directory def rsm Sr The directory where the model configuration files that specify model resolution constant parameters and model options are located glo
14. priately Each directory has three files define h modlsigs h and postplevs h You will only need to edit define h 13 e igrd should be a product of integer powers of 2 3 and 5 On IBM integer power for 3 cannot be more than 2 e jgrd should be an odd number define h model resolution and other parameters jcap truncated wave number levs ber of global vertical sigma levels lonf mber of global E W Gaussian grids latg mber of global N S Gaussian grids elationship between jcap and lonf and latg 3 jcap 1 latg 3 jcap 1 2 mber of soil layers mber of albedo types opography resolution in minute 8min 15km mber of prognostic cloud species loud water ice rain snow mber of soil types mber of vegetation types mber of regional x axis grids hould be a product of integer powers of 2 3 5 mber of regional y axis grids hould be an odd number mber of regional vertical sigma levels mber of coarse regional x axis grids mber of coarse regional y axis grids ateral boundary relaxation arameter in terms of number of time steps relx At 1800 3000 sec recommended larger number implies less relaxation interpolation order 3 cubic interpolation parameter bgf dx is a size of user defined base grid so called B grid to which the riginal driving base field is interpolated merical diffusion parameter for temperature and isture in terms of number of time steps arger number implies less diffusion merical diffusion parameter for
15. r_pgb GRIB files on pressure surface created from the sigma and flux binary files GRIB format files such as r_pgb ftxx can be easily read and displayed with the software GrADS Install GrADS graphic package from http grads iges org grads Set path to libs etc in cshrc Type grmap g0 r pgb ftxx which generates GrADS control file ctl For example grmap r_pgb ft03 will create two control files r pgb ft03 r pdlr ctl and r_pgb ft03 r_pprs ctl and corresponding index files r pgb ft03 r pdlr idx and r_pgb ft03 r_pprs idx pdlr files are for soil moisture and temperature pprs fiels are for all other variables If necessary edit control files To recreate index files type gribmap i control file name Start GrADS by typing grads In GrADS type open control file name Type q file 1 to see what variables are available Plot model output fields by typing d variable name 4 3 choosing the model resolution If you wan to change the model resolution you need to recompile the source codes in rsm directory It is not necessary to recompile the libraries in libs directory Go to rsm def directory Look for the model resolution you want to run If you cannot find the desired resolution users can always create a new directory for the resolution Copy the directory whose resolution is similar to your desired resolution and name it appro
16. rectives f source codes after C processing o object codes x executables a libraries h includes in file templates No suffix makefile scripts or constants sh scripts files are created after compilation Data and constant files Z compressed asc ascii file grib grib format file jeee ieee binary single precision file Source code naming and format dud One subroutine per file File name is the same as the subroutine name Lower case for Fortran variables Upper case for C processor variables Use variables ending with for parameter The definitions of the parameter variables appear in the include file paramodel h libs directory configure libs library compilation configuration script Makefile library make file makefiles directory Makefile templates for creating libraries and constants con directory contains constants and climatology files etc directory contains miscellaneous utility files lib directory contains library source codes opt_libs directory contains compilation options for various machine types make command generates the following 1 grib packing and unpacking library w3lib a model utility library modelib a near utility library ncaru a executables for various utilities x in etc directory Scripts to run the executables files without suffix in etc directory AR WN 5 4 r
17. ructure nennen eren nennen enne nns 19 5 I RSM CVS model code tree denso EU RM PR er ate 19 5 2 File name Conventions i e DERE ORE RERUM IPIE RPM IU ERE Ee PRSE 20 5 3 libs directory neen e Rt OE PDT RE EH TR ERE IER RH YE EUER EE ERE 20 5 4 rem directoty in curn eR ERR RENE EE ET TRUE EE EHE THE SERERE Te EOS 20 5 5 runs directory bine RO ER PER ERREUR CREER REA EERE 21 6 Model Integration Road Map esee eter tenerte e eei edens e esee dossier iiaea 22 6 1 Initialization i ooi IIO BEN HIUIDEIR REED TE EE peers ERREUR Hg HR 23 6 2 Time integration PP E 24 OS SAVE OUP UE EEE E E E E E E 25 1 Introduction e The Regional Spectral Model RSM CVS at Experimental Climate Prediction Center in Scripps Institution of Oceanography has been developed to work within ECPC SIO s GSM Global Spectral Model CVS e The RSM CVS system is managed by Concurrent Versions System CVS and controlled by configure files and Makefile system e The RSM CVS system is an efficient stable state of the art atmospheric model designed for regional climate research e The RSM CVS has the same structure as the GSM CVS so that updates of model physics in the GSM CVS system can be directly incorporated e The RSM CVS currently works on IBM SP Origin and Dec Alpha Linux Sun Mac Cray NEC SX 6 NEC Earth Simulator as of July 2004 and is being tested on other platforms e The RSM CVS has a parallel open MP capabilty and th
18. sl call rwrtsfc rsml output regional flux file r flx ftxx rfixio rmsl output regional surface file r sfc ftxx
19. sm directory 20 configure model source code compilation configuration script Makefile make file for executables makefiles directory Makefile templates for creating executables def directory defines parameters and constants depending on model resolution model options and machine types function h defines machine dependent statements There are directories with varying model resolutions that specify model options and resolution dependent parameters and constants opt directory contains files that specify compiler options for various machine types src directory contains model source codes bin directory contains model executables The bin directory is generated after compilation of the codes cvs docs directory contains help files make command creates libraries and executables The libraries are generated first and executables are made last since it links libraries In addition co2 program are executed co2 program interpolates co2 profile in vertical to the model levels Occasionally compilation fails due to various reasons On some machines even when there is an error in compilation make does not fail and keeps running to the end This results in missing executables when the program is executed When this occurs you need to go to the directory that the compilation failed and type make to see why the compilation failed Fix the error and type make
20. sm crsm gdas return gsm rsm 3 Choose the number of processors to use single thread mpi hybrid return single Single 4 Choose the institution the machine belongs to cannot identify the institution which institution the machine belongs to ecpc compas sdsc nersc alaska other return ecpc other 5 Choose the resolution to run the model with For example T62L28 is the global model resolution for the boundary conditions and r54x55 is the regional resolution east west and north south grid numbers respectively select resolution from below 1 T42L18 r54x55 2 T42L28 r54x55 3 T62L28 r54x55 4 T62L28 r81x67 5 T62L28 r81x87 6 T62L28 r108x69 7 T62L28 r128x85 8 T62L28 r128x199 9 T62L28 r162x105 10 T62L28 r512x335 11 T62L28 r768x501 12 T62L28 r864x651 13 T62L28 r1024x651 14 T62L28 r1024x669 return 7 7 6 Choose the script to run the model with rsm script is for test purpose Refer to 4 1 for other scripts which script do you want to run rsm rsim or rcases return rsm rsm 7 The script will download the model codes and other files from the CVS server and compile the codes Three directories will be created libs rsm and runs U con top4m avg 20i4 asc Z U con top4m max 20i4 asc Z U con top4m slm 80il asc Z 3 Overview of Model System Structure The model is made of 3 main components libs rsm and runs co
Download Pdf Manuals
Related Search