doc/README.test_cases

   1 WRFV3 (Weather Research and Forecast) model.
   2
   3 Contents:
   4
   5 A) Directions for running a test case.
   6 B) List of available test cases
   7
   8 ---------------------------------------
   9
  10 (A)  Directions for running a test case
  11
  12 A suite of tests for the WRF model ARW (Advanced Research WRF) core
  13 can be found in the directory "test".  Each subdirectory in /test
  14 contains the necessary data (except for the real data case) and
  15 input files to run the test specific to that directory.
  16 To run specific test, builld the WRF model
  17 and the necessary initialization routine by typing
  18
  19 -> compile "test_name"
  20
  21 in the top directory (the directory containing this README file).
  22 For example, to build the executables for the 2D (x,z) squall line
  23 example for Eulerian mass coordinate model, you would type the command
  24 "compile em_squall2d_x".
  25
  26 after a successful build, go the the specific test directory:
  27
  28 -> cd test/"test_name"
  29
  30 run the initialization code
  31
  32 -> ideal.exe
  33
  34 and then run the simulation
  35
  36 -> wrf.exe
  37
  38 ---------------------------------------
  39
  40 (B) Available Test Cases
  41
  42 The available test cases are
  43
  44 1) squall2d_x (test/em_squall2d_x)
  45
  46    2D squall line (x,z) using Kessler microphysics
  47    and a fixed 300 m^2/s viscosity.  periodicity
  48    condition used in y so that 3D model produces
  49    2D simulation.  v velocity  should be zero and there
  50    should be no variation in y in the results.
  51
  52 2) squall2d_y (test/em_squall2d_y)
  53
  54    Same as squall2d_x, except with (x) rotated to (y).
  55    u velocity  should be zero and there
  56    should be no variation in x in the results.
  57
  58 3) 3D quarter-circle shear supercell simulation
  59    (test/em_quarter_ss).
  60
  61    Left and right moving supercells are produced.
  62    See the README.quarter_ss file in the test directory
  63    for more information.
  64
  65 4) 2D flow over a bell-shaped hill (x,z) (test/em_hill2d_x)
  66
  67    10 km half-width, 2 km grid-length, 100 m high hill,
  68    10 m/s flow, N=0.01/s, 30 km high domain, 80 levels,
  69    open radiative boundaries, absorbing upper boundary.
  70    Case is in linear hydrostatic regime, so vertical tilted
  71    waves with ~6km vertical wavelength.
  72
  73 5) 3D baroclinic waves (test/em_b_wave)
  74
  75    Baroclinically unstable jet u(y,z) on an
  76    f-plane.  Symmetric north and south, periodic east and west
  77    boundaries.  100 km grid size 16 km top with 4 km damping layer.
  78    41x81 points in (x,y), 64 layers.
  79
  80 6) 2D gravity current (test/em_grav2d_x)
  81
  82    Test case is described in Straka et al,
  83    INT J NUMER METH FL 17 (1): 1-22 JUL 15 1993.
  84    See the README.grav2d_x file in the test directory.
  85
  86 7) 3D large-eddy simulation (test/em_les)
  87
  88    A large-eddy simulation (LES) of a free convective boundary
  89    layer (CBL) with 0 environmental wind at the initial time, and
  90    the turbulence of the free CBL driven/maintained by the
  91    specified surface heat flux.
  92
  93 8) 2D full physics seabreeze (test/em_seabreeze2d_x)
  94
  95    The case is more set up now to demonstrate how to set all land
  96    variables so that full physics options may be used. Tuning is
  97    needed to produce real sea-breeze simulation at this point.
  98
  99 9) 3D global case (test/em_heldsuarez)
 100
 101    A coarse-resolution global forecast case that is described in
 102    "A proposal for the intercomparison of the dynamical cores of
 103    atmospheric general circulation models" by Held and Suarez
 104    (Bulletin of the American Meteorological Society; 1994, Vol
 105    75, 1825-1830).  This test of the global solver is dry, and
 106    produces  midlatitude jets, breaking midlatitude baroclinic
 107    waves, etc.
 108
 109 10) Single column model (test/em_scm_xy)
 110
 111 11) 3D tropical cyclone (test/em_tropical_cyclone)
 112
 113    Idealized tropical cyclone on an f-plane with constant SST in a
 114    specified environment.  Uses capped Newtonian relaxation to mimic
 115    longwave radiation.  The default setup uses the Jordan (1958) mean
 116    hurricane sounding with 28 C SST and no background winds.  The
 117    analytic initial vortex is from Rotunno and Emanuel (1987).  This
 118    case is useful for testing the effects of new model code (e.g.,
 119    new physics options) on tropical cyclones in an idealized framework.
 120
 121 12) Convective-radiative equilibrium test (test/em_convrad)
 122
 123    Idealized 3d convective-radiative equilibrium test with constant SST
 124    and full physics at cloud-resolving 1 km grid size. Periodic b.c.s.
 125    Tropical conditions, small f and weak wind.
 126