Run a simple experiment on the machine where WRF4G is installed

Before starting this tutorial make sure you have correctly installed WRF4G on your machine following the Installation instructions

Start wrf4g_framework and list computing resources

Simply start the WRF4G Framework by running:

wrf4g_framework start

Doing this, we will start the services that manage the computing resources and keep track of the experiments. Note that if we don't start wrf4g_framework we won't be able to work with WRF4G.

WRF4G framework is configured by default to use a single computing resource (the computer where WRF4G has been installed). To list the computing resources where you can submit experiment (in this case only localhost) run the following:

valva@sipc18:~$ wrf4g_resources 
HID PRIO OS              ARCH  MHZ  %CPU    MEM(F/T)     DISK(F/T)      N(U/F/T) LRMS               HOSTNAME                      
0   1    GNU/Linux2.6.32 unkno 2000    0    439/3270     1143/8662         0/1/1 FORK               mycomputer   

Prepare and submit the test experiment

Go to the folder where the experiment configuration files are located:

cd $WRF4G_LOCATION/experiments/single/testc

Edit experiment.wrf4g and check its configuration.

Run wrf4g_prepare to prepare the experiment:

valva@sipc18:/tmp/WRF4G/experiments/single/testc$ wrf4g_prepare
Preparing namelist...
WRF Check Warning: radt is larger than dx (1.666667)

---> Single params run
---> Continuous run
	---> cycle_chunks: testc 1983-08-25_12:00:00 1983-08-27_00:00:00
		---> chunks 1: testc 1983-08-25_12:00:00 1983-08-26_00:00:00
		---> chunks 2: testc 1983-08-26_00:00:00 1983-08-26_12:00:00
		---> chunks 3: testc 1983-08-26_12:00:00 1983-08-27_00:00:00

Check the experiment status with WRF4GCommandLineTools. You will see the experiment is in P (Prepared status).

valva@sipc18:/tmp/WRF4G/experiments/single/testc$ wrf4g_status 
Realization        GW  Stat Chunks Comp.Res   WN         Run.Sta       ext   %
testc              -     P  0/3    -          -          Prepared       - 0.00

Submit the experiment with WRF4GCommandLineTools. Check the status during one minute. You will see how, first, the job is submitted, then downloading input data,running ungrib, metgrid, real, wrf and finally will has finished.

valva@sipc18:/tmp/WRF4G/experiments/single/testc$ wrf4g_submit 
Submitting realization: "testc"
	Submitting Chunk 1:	1983-08-25_12:00:00	1983-08-26_00:00:00
	Submitting Chunk 2:	1983-08-26_00:00:00	1983-08-26_12:00:00
	Submitting Chunk 3:	1983-08-26_12:00:00	1983-08-27_00:00:00
valva@sipc18:/tmp/WRF4G/experiments/single/testc$ wrf4g_status 
Realization        GW  Stat Chunks Comp.Res   WN         Run.Sta       ext   %
testc              0     W  1/3    -          -          Submitted      - 0.00

valva@sipc18:/tmp/WRF4G/experiments/single/testc$ wrf4g_status 
Realization        GW  Stat Chunks Comp.Res   WN         Run.Sta       ext   %
testc              0     R  1/3    mycomputer sipc18     real            - 0.00

valva@sipc18:/tmp/WRF4G/experiments/single/testc$ wrf4g_status 
Realization        GW  Stat Chunks Comp.Res   WN         Run.Sta       ext   %
testc              0     R  1/3    mycomputer sipc18     real            - 0.00

Check the experiment output and log

The location where output and log files are stored is defined with the WRF4G_BASEPATH variable in resources.wrf4g. Check WRF4G_LOCATION/etc/resources.wrf4g to discover where WRF4G_BASEPATH is pointing. You'll see it is pointing to $WRF4G_LOCATION/repository/output. Go to $WRF4G_LOCATION/repository/output/testc/testc and see the folders structure and the output files.

valva@sipc18:/tmp/WRF4G/repository/output/testc/testc$ tree
.
├── log
│   ├── log_1_1.tar.gz
│   ├── log_2_2.tar.gz
│   └── log_3_3.tar.gz
├── namelist.input
├── output
│   ├── wrfout_d01_19830825T120000Z_19830825T233000Z.nc
│   ├── wrfout_d01_19830826T000000Z_19830826T000000Z.nc
│   ├── wrfout_d01_19830826T000000Z_19830826T113000Z.nc
│   ├── wrfout_d01_19830826T120000Z_19830826T120000Z.nc
│   ├── wrfout_d01_19830826T120000Z_19830826T233000Z.nc
│   ├── wrfout_d01_19830827T000000Z_19830827T000000Z.nc
│   ├── wrfrain_d01_19830826T000000Z_19830826T000000Z.nc
│   ├── wrfrain_d01_19830826T120000Z_19830826T120000Z.nc
│   ├── wrfrain_d01_19830827T000000Z_19830827T000000Z.nc
│   ├── wrfxtrm_d01_19830825T120000Z_19830825T233000Z.nc
│   ├── wrfxtrm_d01_19830826T000000Z_19830826T000000Z.nc
│   ├── wrfxtrm_d01_19830826T000000Z_19830826T113000Z.nc
│   ├── wrfxtrm_d01_19830826T120000Z_19830826T120000Z.nc
│   ├── wrfxtrm_d01_19830826T120000Z_19830826T233000Z.nc
│   └── wrfxtrm_d01_19830827T000000Z_19830827T000000Z.nc
├── realout
└── restart
    ├── wrfrst_d01_19830826T000000Z.nc
    ├── wrfrst_d01_19830826T120000Z.nc
    └── wrfrst_d01_19830827T000000Z.nc