Quick Start

To create meteo for TM5 from ERA40 data.

Think

1. Decide on the periode:
   • a start date, for example 01-01-1996;
     first fields are valid from 21:00 previous day to 21:00 ;
   • an end date, for example 01-01-1997;
     take one day extra to have fields for 24:00 .
2. Decide on a horizontal resolution:
   • size of a grid cell in degrees;
   • position of south and west boundary;
   • number of cells in lat/lon direction.
   • a simple key for your grid, for example including the project name and the resolution: proj_64, proj_32, proj_11, ...
   For fast generation of meteo, take a resolution in agreement with a global 3x2 (lon x lat) grid:
   • a coarse grid with cells combined from 3x2 cells, for example 6x4 global;
   • a subset of the global 3x2 grid, for example 3x2 south america;
   • a refinement of 3x2 cells, for example 1x1 over Suriname.
   Do this for all zoom grids.
3. Decide on the number of levels. A level is either a single ECMWF level or a number of them combined into a single layer.
4. Decide on the output format: grib or hdf.

Login

For runing at ECMWF, login to ecgate1:

$ telnet ecaccess.ecmwf.int

KNMI users could run the stuff at their local work station.

Copy TMPP code

Make a (recent) private copy of the TMPP code; see section 1.1 about installation.

Code level selection

Eventually code the level selection. For example, a subset of 44 levels from the original 60 ECMWF levels is specified in:

TMPP/SOURCE/tmpp_const_tm_v_60_44.f90

Copy this file to a different name and modify for your own level selection. Note that '44' is just an identification, so it could have been given a name like 'tm3dam' too.

Please send new level selection files to me.

Check make file

Host specific compiler and library options are included in the master makefile from files named:

SOURCE/Makefile.${HOST}.mk

You might overwrite this settings by creating a user-specific copy named:

SOURCE/Makefile.${USER}@${HOST}.mk

Please send new included makefiles to me if you think they are interesting for other users too (for example changes in libraries).

Run

1. Make a private copy of a job specification file:

   % cp TMPP/RCFILES/tm5.rc you.rc

2. Edit the specification file you.rc. See secion 1.3 about the format of rc files.

   Some important fields which probably need to be changed; see also section 4.3 for background and more examples:

   • specify start and end date:

     pp.time.offline.start : 19960101
     pp.time.offline.end : 19961231

   • specify meteo files to be produced in a space seperated list:

     pp.task.list : mflux temper pv humid cloud sub kzz surf

   • specify the number of levels:

     TMmeteo.resol.v : 44

   • specify the horizontal grids to be produced; SPACE SEPERATED LIST!

     TMmeteo.area.list : gl64 sam32 sur11
     
     ! global 3x2, processed offline for all layers:
     TMmeteo.area.glb3x2.lon : -180.0, 3.0, 120
     TMmeteo.area.glb3x2.lat : -90.0, 2.0, 90
     TMmeteo.area.glb3x2.action : new
     TMmeteo.area.glb3x2.parent : globe
     
     ! global 6x4, combine from 3x2 cells defined by 'glb3x2':
     TMmeteo.area.proj_64.lon : -180.0, 6.0, 60
     TMmeteo.area.proj_64.lat : -90.0, 4.0, 45
     TMmeteo.area.proj_64.action : combine
     TMmeteo.area.proj_64.parent : glb3x2
     
     ! South America, subset of 3x2 cells defined by 'glb3x2': TMmeteo.area.proj_32.lon : -90.0, 3.0, 20
     TMmeteo.area.proj_32.lat : -60.0, 2.0, 40
     TMmeteo.area.proj_32.action : subset
     TMmeteo.area.proj_32.parent : glb3x2
     
     ! Suriname, newly produced but matched with parent 'proj_32':
     TMmeteo.area.proj_11.lon : -60.0, 1.0, 12
     TMmeteo.area.proj_11.lat : 0.0, 1.0, 10
     TMmeteo.area.proj_11.action : new
     TMmeteo.area.proj_11.parent : glb3x2

   • select where to store the produced TM5 meteo:
     • move to a directory on ecgate1:

       TMmeteo.output.disk : 1
       TMmeteo.output.disk.dir : ${SCRATCH}/TM/meteo

     • store on ecfs:

       TMmeteo.output.mss : 1
       TMmeteo.output.mss.dir : /${USER}/TM/meteo

     • put it on the ftp server 'ftp-gw' in directory 'tm5meteo':

       TMmeteo.transfer : 1
       transfer.option : 2
       transfer.ftp.host : ftp-gw
       transfer.ftp.dir : tm5meteo

       Set username and password in your $HOME/.netrc file.
3. Run in verbose mode (write output to the screen):

   % TMPP/SCRIPTS/pprun -v you.rc

   See also section 1.2 about pprun.

Get files from ftp server

If the TM5 meteo files are put on an ftp-server, you might move them to your local workstation using the SCRIPTS/transfiles script. See section 1.5.2.