updated top-level README and version_decl for V4.5 (#1847)
[WRF.git] / var / README.basics
blobbac73a671bcff8a516579bbf693a300e1897acd6
1 ======================================================================================
2  For a more complete and up-to-date guide to using WRFDA, see the User's Guide:
3  http://www2.mmm.ucar.edu/wrf/users/wrfda/usersguide.html
4 ======================================================================================
6 Setup and Run - with conventional data
8 1) To run WRFDA-3DVar, first create a working directory, 
9    for example, WRFDA/var/test, then follow the steps below:
11 cd WRFDA/var/test/tutorial (go to the working directory)
13 ln -sf WRFDA/run/LANDUSE.TBL ./LANDUSE.TBL
14 ln -sf $DAT_DIR/rc/2008020512/wrfinput_d01 ./fg (link first guess file as fg)
15 ln -sf WRFDA/var/obsproc/obs_gts_2008-02-05_12:00:00.3DVAR ./ob.ascii (link OBSPROC processed 
16                                                                        observation file as ob.ascii)
17 ln -sf $DAT_DIR/be/be.dat ./be.dat (link background error statistics as be.dat)
18 ln -sf WRFDA/var/build/da_wrfvar.exe ./da_wrfvar.exe (link executable)
20 vi namelist.input (a very basic namelist.input for running the tutorial test case is provided in
21                    WRFDA/var/test/tutorial/namelist.input.. 
22                    Only time and domain settings need to be specified for a certain case if 
23                    using default settings provided in WRFDA/Registry/registry.var. However,
24                    it is VERY IMPORTANT to make sure the settings in &physics and &dynamics record 
25                    are consistent with those in your WRF settings.)
26   *** Please see WRFDA/var/README.namelist for namelist descriptions. ***
28 da_wrfvar.exe >& wrfda.log
30 2) To run da_update_bc.exe, follow the steps below:
32 cd WRFDA/var/test/update_bc  (go to the working directory)
33 cp -p  $DAT_DIR/rc/2008020512/wrfbdy_d01 ./wrfbdy_d01 (IMPORTANT: make a copy of wrfbdy_d01
34                                                        as the wrf_bdy_file will be 
35                                                        overwritten by da_update_bc.exe)
36 vi parame.in
37 &control_param
38 da_file            = './wrfvar_output'
39 da_file_02         = './ana02' (use lateral boundary control in 4DVar, ignored in 3DVar)
40 wrf_bdy_file       = './wrfbdy_d01'
41 wrf_input          = './wrfinput_d01'
42 domain_id          = 1
43 debug              = .false.
44 update_lateral_bdy = .true.
45 update_low_bdy     = .true.
46 update_lsm = .false.  (.true.: the LSM predicted variables: 
47                                   TSLB, SMOIS, SNOW, SH2O, RHOSN, CANWAT, SNOWH
48                                   will be updated based on wrf_input file)
49 var4d_lbc = .false.   (.true.: use lateral boundary control in 4DVar)
51 ln -sf WRFDA/var/build/da_update_bc.exe ./da_update_bc.exe
52 ./da_update_bc.exe
54 Extra notes regarding to da_update_bc:
56 As of V3.2, some changes are made to da_update_bc and new settings in parame.in are
57 introduced as follows. (The above pre-V3.2 parame.in will still work with V3.2 da_update_bc)
59 &control_param
60  da_file            = '../tutorial/wrfvar_output'
61  wrf_bdy_file       = './wrfbdy_d01'
62  wrf_input          = '$DAT_DIR/rc/2008020512/wrfinput_d01'
63  domain_id          = 1
64  debug              = .true.
65  update_lateral_bdy = .true.
66  update_low_bdy     = .true.
67  update_lsm         = .false.
68  iswater            = 16
71 update_lateral_bdy is required only for domain 1.
72 update_low_bdy is needed for all domains if running in cycling mode.
73 iswater (water point index) is 16 for USGS LANDUSE and 17 for MODIS LANDUSE.
75 It is recommended to run da_update_bc.exe with
76  update_lateral_bdy = .false.
77  update_low_bdy     = .true.
78 before running WRFDA, if in cycling mode (especially if you are doing 
79 radiance data assimilation and there is SEA ICE and SNOW in your domain)
80 to get low-bdy updated first guess (da_file will be overwritten by da_update_bc).
82 Then run da_update_bc.exe with
83  update_lateral_bdy = .true.
84  update_low_bdy     = .false.
85 after WRFDA to get updated lateral boubdary conditions (wrf_bdy_file will be
86 overwritten by da_update_bc).