HOW TO RUN THE BRAMS 5.5
After download, compile and install the model:
Install the data files:
The BRAMS 5.5 needs some fixed files:
a) Tables (some tables for parametrizations)
cd bin wget http://ftp.cptec.inpe.br/pesquisa/bramsrd/BRAMS/files/tables_2118.tar.xz xz -d tables_2118.tar.xz tar -xvf tables_2118.tar
b) Fixed data (vegetation, NDVI, sst, topography, etc)
wget http://ftp.cptec.inpe.br/pesquisa/bramsrd/BRAMS/files/datafix.tar tar -xvf datafix.tar cd datafix xz -d *.xz cd ..
Create some auxiliary directories for datain and dataout (to/from model):
mkdir datain mkdir datain/GRADS mkdir datain/GFS mkdir datain/QUEIMA mkdir dataout mkdir dataout/ANL mkdir dataout/HIS mkdir dataout/IVAR mkdir dataout/IC mkdir dataout/LOG mkdir dataout/SFC mkdir datout/UMD mkdir dataout/POST
Datain Initial conditions (IC/CC):
To obtain datain please see the PRE-BRAMS install. The data will be generate from GFS model and the IC/CC will de write in bin format (grads). Then the data must be moved to datain/GRADS (or the output from pre-brams set to that directory).
Geting the BRAMS Namelist (RAMSIN):
wget http://ftp.cptec.inpe.br/pesquisa/bramsrd/BRAMS/files/RAMSIN_base.xz
Edit the RAMSIN acordingly your preferences:
a) Data, domain, grid position, resolution and delta:
****Please, is important to know that the model does not implement grid nesting yet. You must only use one grid.
Adjust the parameters (bellow) to your preferences:
TIMEUNIT = 'h', ! 'h','m','s' - Time units of TIMMAX, TIMSTR TIMMAX = 24., !48., ! Final time of simulation IMONTH1 =02, ! Month IDATE1 =03, ! Day IYEAR1 =2021, ! Year ITIME1 = 0000, ! GMT of model TIME = 0. ! Grid specifications NNXP = 30, ! Number of x gridpoints NNYP = 30, ! Number of y gridpoints NNZP = 45, ! Number of z gridpoints ... DELTAX = 20000., DELTAY = 20000., ! X and Y grid spacing [m] DELTAZ = 80., ! Z grid spacing (set to 0. to use ZZ) DZRAT = 1.08, ! Vertical grid stretch ratio ... DTLONG = 120., ! Coarse grid long timestep [~4 x DELTAX/1000] ... POLELAT = -22.6, ! Latitude of pole point POLELON = -45.2, ! Longitude of pole point CENTLAT = -22.6, CENTLON = -45.2,
b) Type and frequency of output:
IPOS = 2, ! 0-no files, 2-grads files, 1-hdf5(not available yet) IOUTPUT = 0, ! 0-no files, 1-save ASCII, 2-save binary HFILOUT = './HIS/hOPQUE', ! History file prefix AFILOUT = './ANL/OPQUE', ! Analysis file prefix ... FRQANL = 10800., ! Analysis file frequency in seconds
Use IPOS=2 and IOUTPUT = 0 for output in GRADS. In this case You don't need to postprocess with RAMSPOST code.
c) Setup for INITIAL conditions (IC/CC):
The model can get IC/CC data right from GRADS files generated by PRE-BRAMS. IN this case You must set some parameter as show bellow.
!-----------------------------------
! Makevfile information IC = Initial Conditions
!-----------------------------------
ICFILETYPE=4, !0- ISAN using dprep, 1- do ISAN using NCEP GFS GRIB2,
!2- ISAN using netCDF 4-Get from grads
INITIAL_LATITUDE = -70., !Initial latitude for domain of model (-90 to 90)
FINAL_LATITUDE = 29., !Final latitude for domain of model(-90 to 90)
INITIAL_LONGITUDE = 250., !Initial longitude for domain of model (0 to 360)
FINAL_LONGITUDE = 358., !Final longitude for domain of model (0 to 360)
Adjust the initial and final latitude and longitude acordingly You generate data on pre-brams. For the domain of interest with some lateral boundaries.
*d) Setup for the output *
The postprocess phase of the model, when IPOS=2 is made during the run time of BRAMS. The set of variables to be write ans geographic information are set in RAMSIN.
$POST
NVP = 40,
VP ='topo',
'land',
'sea_press',
'precip',
'acccon',
'tveg',
't2mj',
'le',
'h',
'rshort',
'rlong',
'albedt',
'rlongup',
'cape',
'cine',
'zi',
'sst',
'pwt',
'slp_metar',
'td2mj',
'u10mj',
'v10mj',
'smoist',
'tempc',
'ue_avg',
've_avg',
'rh',
'geo',
'cloud',
'omeg',
'ndvi',
'lai' ,
'rv' ,
!fim variaveis scamtec
'sfc_press' ,
'albedt' ,
'tempk' ,
'cucldp' ,
'curtdp' ,
'cuthdp' ,
GPREFIX = './dataout/POST/brams',
CSVFILE = './variables.csv',
ANL2GRA = 'ONE',
PROJ='YES',
MEAN_TYPE ='BAV',
LATI = -90.,-90., -90., -90.,
LATF = +90.,+90., +90., +90.,
LONI = -180.,-180., -180.,-180.,
LONF = 180.,180., 180., 180.,
ZLEVMAX = 32,32,32,32,
IPRESSLEV = 1,
INPLEVS = 19,
IPLEVS = 1000, 925, 900, 850, 800, 750, 700, 650, 600, 550, 500, 450, 400, 350, 300, 250, 200, 150, 100,
ASCII_DATA ='NO',
SITE_LAT =-10.76,
SITE_LON =-62.36,
$END
Set the number of variables to output adjusting NVP. The name of variables are defined in VP separated by commas. All the variables You can use ar describe in file variables.csv
Runing the model:
The model must be run in 3 phases: MAKESFC, MAKEVFILE and INITIAL. The MAKESFC phase build the surface files, vegetantion, topography, etc setting it for user preferences (domain, resolution, etc). The MAKEVFILE phase get the data from IC/CC and interpolate they for model resolution and grid. The INITAIL makes the time integration of model and produces the output.
For MAKESFC phase set RUNTYPE in RAMSIN:
RUNTYPE = 'MAKESFC',
And than, run the model using mpirun bu with only one processor:
/opt/apps/bin/mpirun -np 1 brams-5.5 -f RAMSIN
For MAKEVFILE phase set RUNTYPE in RAMSIN:
RUNTYPE = 'MAKEVFILE',
And than, run the model using mpirun bu with only one processor:
/opt/apps/bin/mpirun -np 1 brams-5.5 -f RAMSIN
For INITIAL phase set RUNTYPE in RAMSIN:
RUNTYPE = 'INITIAL',
And than, run the model using mpirun bu with only one processor:
/opt/apps/bin/mpirun -np 16 brams-5.5 -f RAMSIN
The phase INITIAL can be run with N processors. The number max of processors depends of number of columns (NNXP x NNYP). The minimum of columns per processor must be 25.