debugging
[wrffire.git] / doc / README_wps.txt
blobec033008bcd8e889ebb2ca857985bd8b5ca50d1b
1 #!/bin/csh -f
2 #This is doc/README_wps.txt
3 #Running the default case for wrffire with real landfire data.
4 #You can run this file also as wps.csh from the top level wrf directory
6 #!!! This data case only starts a fire somewhere in the mountains
7 #!!! of Colorado on the date of August 28, 2005. I make no claim
8 #!!! that it makes any sense physically, only that it runs
10 #!!! run ./configure in the WPS and in the wrfv2_fire directories
11 #!!! this is interactive so it is not a part of this script
13 # get a copy of data: in the parent of the wrf directory
14 # note: this is about 11GB
15 ##(cd ..; rsync -arvzuP math.cudenver.edu:/home/faculty/jmandel/wrfdata .)
16 #!!! THE PREVIOUS LINE IS FOR LOCAL DEVELOPERS WITH ACCOUNT ON MATH ONLY
17 #!!! ALL OTHERS SEE "SET UP A NEW CASE" BELOW
19 #in wrfv2_fire compile wrf em_real
20 (cd wrfv2_fire; ./compile em_real)
22 # next few commands run in WPS
23 cd WPS
25 #in WPS compile wps
26 ./compile wps
28 #in WPS link the atmospheric data
29 ./link_grib.csh ../../wrfdata/Katrina/*
31 #in WPS link the atmospheric data descriptor
32 ln -sf ungrib/Variable_Tables/Vtable.AWIP Vtable
34 #in WPS run geogrid to set up static geographical data, including landfire
35 #This command will run a series of python scripts that grab data specific
36 #to your domain and convert it to geogrid format. If everything goes well,
37 #it will run geogrid.exe with the new data.
38 #!!! REQUIRES a number of external utilities:
39 #!!! Python 2.5+ (www.python.org)
40 #!!! GDAL library and python bindings (www.gdal.org)
41 #!!! (See the binary distributions in the downloads section.)
42 #!!! twill (http://twill.idyll.org)
43 #!!! (Install with python's easy_install or simply extract the source somewhere
44 #!!! and add that path to PYTHONPATH.)
46 #If you can't satisfy these dependencies, you must generate fuel category and
47 #highres topological data on your own. The datasets are simply too big to distribute
48 #in one package like the rest of geogrid.
49 ./geogrid_wrapper.sh
51 #run ungrid to set up atmospheric data
52 ./ungrib.exe
54 #run metgrid to interpolate fields to the model grid
55 ./metgrid.exe
57 #go to wrf run directory
58 cd ../wrfv2_fire/test/em_real
60 #link metgrid output here
61 ln -sf ../../../WPS/met_em.d01.2005-08-28_1* .
63 #run wrf preprocessor
64 ./real.exe
66 #run wrf.exe in wrf/wrfv2_fire/test/em_real
67 #./wrf.exe
69 #*****************************************************************************
71 # SET UP A NEW CASE
73 #To set up a new case for a real data fire simulation, the procedure is similar
74 #to the standard documentation for WPS. First you must edit the namelist.wps
75 #for the domain you wish to simulate. (The namelist variables sr_x/sr_y
76 #describe the subgrid scaling as in wrffire.) Then you must download
77 #atmospheric boundary conditions for the day you want, for instance from here:
78 #http://dss.ucar.edu/datasets/ds083.2/data/
80 #This data and variable table must be linked into the WPS directory as above.
81 #If you use ucar/ncep data the variable table is Vtable.AWIP.
83 #Finally, run the wps programs geogrid, ungrib, and metgrid. Then go to the
84 #wrf real test directory, link in the metgrid output, and set up the namelist
85 #for the new domain. (If the domain description differs from the wps namelist,
86 #real.exe will not run successfully.) Run real.exe and wrf.exe.