updated top-level README and version_decl for V4.5 (#1847)
[WRF.git] / var / mri4dvar / README.MRI-4DVar
blob9ac858966df8638abd1bb1e3fc65503a32ac3e46
2 This directory contains offline programs needed for multi-resolution incremental 4DVar (MRI-4DVar)
3 --------------
5 Liu, Z., J. Ban, J.-S, Hong, and Y.-H. Kuo, 2020: Multi-resolution incremental 4D-Var for WRF: 
6 Implementation and application at convective scale, Q. J. R. Meteorol. Soc. , 1-14.
8 da_bdy.f90       : 
10 da_bilin.f90     : bilinearly interpolate analysis increment 
11                    from low-resolution to high-resolution
13 da_thin.f90      : thin wrfinput file
15 da_vp_bilin.f90  : bilinearly interpolate control variable
16                    from low-resolution to high-resolution
18 da_vp_split.f90  : scatter global hires. control variables to different PEs
20 1. To compile:
21 ----------------
22   (1) need to compile WRFDA first in 4DVAR mode,
23        cd your_WRFDA_dir
24        ./clean -a
25        ./configure 4dvar
26        ./compile all_wrfvar
27   (2) cd your_WRFDA_dir/var/mri4dvar
28       make
29   (3) make clean (to remove *.exe *.o files)
31 da_bdy.exe
32 da_bilin.exe
33 da_thin.exe
34 da_vp_bilin.exe
35 da_vp_split.exe
37 2. Domain size requirment
38 ---------------------------
40 Only WRF input files at high resolution are required to run MRI-4DVAR. 
41 WRF input files at low resolution are thinned from those at high resolution.
42 This requires that grid number at high/low resolutions to satify:
43     ( n - 1 ) mod m = 0
44 where n is the grid number of high resolution in x or y direction, m is the
45 grid number of low resolution in x or y direction. 
47 The ratio of the high/low resolution must be odd, the default ration is 1:3.
49 3. First guess files
50 -----------------------
52 MRI-4DVAR run needs 2 time-level first guess files (fg & fg02), 
54 fg   is at the analysis time
56 fg02 is at the end of the analysis time window, or the 2nd time level of boundary
57 if boundary interval is less then analysis time window 
59 4. BE
60 --------
61 MRI-4DVAR run only needs be.dat files at different inner loop resolutions.
63 5. sample script for running 3-stage MRI-4DVar
64 ----------------------------------------------
65 wraper_mri3d4dvar.csh  : wrapper script to configure MRI-4DVar
66 run_mri3d4dvar.csh_pbs : run 3-step MRI-4DVar with PBS job scheduler
67 run_mri3d4dvar.csh_lsf : run 3-step MRI-4DVar with LSF job scheduler
68 *.ncl: NCL scripts only for debugging purposes.
70 No support can be provided for MRI-4DVar.