updated top-level README and version_decl for V4.5 (#1847)
[WRF.git] / var / README.radiance
blob1bad3b8ad2310f5a4bcccf34c65c0a7576bdcc74
1 =============================================================================
2 Before proceeding, please read README.basics first to get some basic ideas on 
3 running WRFDA with conventional data.
4 Then, if you are interested in radiance data assimilation, please read through
5 this README.radiance to learn more on the settings and extra input files 
6 required for radiance data assimilation.
7 Please see also Chapter 6 of WRF ARW User's Guide for more details.
9 RTM (Radiative Transfer Model) that can be used in WRFDA:
10   CRTM REL-2.3.0
11   RTTOV v12.1
12 =============================================================================
14 Setup and Run - with radiance data
16 1. Input files:
18 In addition to the basic input files (LANDUSE.TBL, fg, ob.ascii, be.dat) mentioned
19 in README.basics, the following extra files are required for radiance:
20   radiance data in NCEP BUFR format, radiance_info files, VARBC.in,
21   RTM (CRTM or RTTOV) coefficient files (see "Notes on coefficients" below).
23   ln -sf ${DAT_DIR}/gdas1.t00z.1bamua.tm00.bufr_d  ./amsua.bufr
24   ln -sf ${DAT_DIR}/gdas1.t00z.1bamub.tm00.bufr_d  ./amsub.bufr
25   ln -sf WRFDA/var/run/radiance_info    ./radiance_info  # radiance_info is a directory
26   ln -sf WRFDA/var/run/VARBC.in         ./VARBC.in
27   (CRTM only)
28      Either ln -sf WRFDA/var/run/crtm_coeffs_2.3.0 ./crtm_coeffs  # crtm_coeffs is a directory
29      or set namelist variable crtm_coef_path to the location of coef files
30         crtm_coef_path='/user/WRFDA/var/run/crtm_coeffs_2.3.0'
31   (RTTOV only) ln -sf rttov10/rtcoef_rttov10/rttov7pred51L ./rttov_coeffs  # rttov_coeffs is a directory
33 2. namelist.input
35 Pay special attention to &wrfvar4, &wrfvar14, &wrfvar21, and &wrfvar22
36 See WRFDA/var/README.namelist for namelist descriptions.
38 &wrfvar4
39  use_amsuaobs=true
40  use_amsubobs=true
42 &wrfvar14
43  rtminit_nsensor=6,
44  rtminit_platform=1,1,1,1,1,1,
45  rtminit_satid=15,16,18,15,16,17,
46  rtminit_sensor=3,3,3,4,4,4,
47  thinning_mesh=120.0,120.0,120.0,120.0,120.0,120.0,
48  thinning=true,
49  qc_rad=true,
50  write_iv_rad_ascii=false,
51  write_oa_rad_ascii=true,
52  rtm_option=2,
53  only_sea_rad=false,
54  use_varbc=true,
55  use_crtm_kmatrix=true,
56  use_rttov_kmatrix=true,
57  crtm_coef_path='./crtm_coeffs'
58  crtm_mwwater_coef='FASTEM5.MWwater.EmisCoeff.bin'
59  crtm_irwater_coef='Nalli.IRwater.EmisCoeff.bin'
60  crtm_irland_coef='USGS.IRland.EmisCoeff.bin'
61  rttov_emis_atlas_ir=0,
62  rttov_emis_atlas_mw=0,
64 &wrfvar21
65 time_window_min="2008-02-05_10:30:00.0000",
67 &wrfvar22
68 time_window_max="2008-02-05_13:30:00.0000",
71 3. Notes on coefficients
73 (1) for CRTM
75 Starting with V4.0, CRTM coefficient files are NOT included in any of the
76 WRF or WRFDA tar files. There are two ways to get this data.
77 1. Users need to download their required subset of CRTM coefficient files 
78 from this web page:
79 http://www2.mmm.ucar.edu/wrf/users/wrfda/download/crtm_coeffs.html
80 2. The full set of CRTM coefficients may be downloaded from:
81 ftp://ftp.emc.ncep.noaa.gov/jcsda/CRTM/REL-2.3.0/crtm_v2.3.0.tar.gz
83 Prior to  V4.0, the subset of CRTM coefficient files were included in the 
84 WRFDA tar file in the WRFDA/var/run/crtm_coeffs_2.2.3 directory (please see 
85 also WRFDA/var/run/README).
87 After unzip/untar crtm_v2.3.0.tar.gz, you will find all the coefficient files
88 under the directory fix. You will need to create another directory to copy or link 
89 the files that will be used in WRFDA. Please see also the CRTM user guide
90 ftp://ftp.emc.ncep.noaa.gov/jcsda/CRTM/CRTM_User_Guide.pdf
91 for the options of proper coefficient files for your applications.
93 (2) for RTTOV
95 Please visit http://research.metoffice.gov.uk/research/interproj/nwpsaf/rtm
96 for the RTTOV information.
97 The RTTOV coefficient files that come with the RTTOV source code or that are 
98 downloaded separately are placed in different sub-directories.
99 To run WRFDA, the coefficient files to be used should all be under the 
100 rttov_coeffs sub-directory in the WRFDA working directory.
101 For most basic applications, the coefficient files available in the RTTOV source 
102 code rttov11/rtcoef_rttov11/rttov7pred51L would be sufficient.