BRAMS 6.0 - INSTALL GUIDE

Before You install the model BRAMS-6.0 You must have the prerequisites installed. See the document BRAMS_6.0_-_INSTALL_PREREQUISITES (extension md or html) to see how to install the requisites.

  1. Building PATHS and linking compilers.

    In order to compiler the BRAMS code using the compilers and libraries You install in prerequisites make the commands bellow.

    export PATH={YOUR_DIR}/bin:$PATH
export LD_LIBRARY_PATH={YOUR_DIR}/lib:$LD_LIBRARY_PATH
sudo ln -s /usr/bin/gfortran {YOUR_DIR}/bin/gfortran
sudo ln -s /usr/bin/gcc {YOUR_DIR}/bin/gcc

    Notice: See the prerequisites document to use the correct {YOUR_DIR} .

    Please, check if Your path have in first part {YOUR_DIR} and if the correct library is in first part of LD_LIBRARY_PATH. 

    echo $PATH
echo $LD_LIBRARY_PATH

    Please check if Fortran and gcc version is the correct. 

    gfortran --version
gcc --version

    The results must be something like. See that in this case we use 8.4.0.

    $ gfortran --version
GNU Fortran (Ubuntu 8.4.0-4ubuntu1) 8.4.0
Copyright (C) 2018 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
$ gcc --version
gcc (Ubuntu 8.4.0-4ubuntu1) 8.4.0
Copyright (C) 2018 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

  2. Configure the model

    Now You must configure the model passing all libreries You will be use. The {YOUR_BIN_AREA} is the folder you want to put the binary and namelists of model. 

    ./configure --program-prefix=BRAMS_6.0 --prefix={YOUR_BIN_AREA} --enable-jules    --with-chem=RELACS_TUV --with-aer=SIMPLE --with-fpcomp={YOUR_DIR}/bin/mpif90    --with-cpcomp={YOUR_DIR}/bin/mpicc --with-fcomp=gfortran --with-ccomp=gcc --with-netcdff={YOUR_DIR} --with-netcdfc={YOUR_DIR} --with-wgrib2={YOUR_DIR}

Bellow an example of use, where {YOUR_BIN_AREA} is /home/oscar.

./configure --program-prefix=BRAMS_6.0 --prefix=/home/oscar --enable-jules    --with-chem=RELACS_TUV --with-aer=SIMPLE --with-fpcomp=/opt/gnu8/bin/mpif90    --with-cpcomp=/opt/gnu8/bin/mpicc --with-fcomp=gfortran --with-ccomp=gcc --with-netcdff=/opt/gnu8 --with-netcdfc=/opt/gnu8 --with-wgrib2=/opt/gnu8

  1. Make and Make install

    The make command will create the brams-6.0 executable. After creation it is necessary to run the make install command so that the basic files for the run are copied to the area set in {YOUR_BIN_AREA}

    make
make install

  2. Download tables, fixed files an a test case

    A series of fixed files and tables are required to run the model. You can get them by downloading the compressed file available in the ftp area. This file has 16GB and may take a while to download. It depends on your network speed. We advise you to check the checksum of the file to make sure that the download has not broken it.

    cd {YOUR_BIN_AREA}
cd ..
wget http://ftp.cptec.inpe.br/pesquisa/bramsrd/BRAMS-6.0/test_set_data/MD5SUM
wget http://ftp.cptec.inpe.br/pesquisa/bramsrd/BRAMS-6.0/test_set_data/brams6.0_test_bin.tar.xz
md5sum brams6.0_test_bin.tar.xz
cat MD5SUM
tar -xvf brams6.0_test_bin.tar.xz

  3. Running a small meteorological case

    The BRAMS Model is a limited area model and therefore requires input data from outputs from a global model. In the test case presented here, these data are already ready and available. For "expert" cases a new document shows how to get this data and generate it. The BRAMS model runs in 3 distinct phases:

    i) MAKESFC - Creates the surface files using the input files that contain global them and adjusts them to the specifications chosen by the user and arranged in the input namelist. The BRAMS namelist is called RAMSIN.

datafix_model/NDVI_MODIS_GRADS
datafix_model/topo1km
datafix_model/sst_week
datafix_model/GL_OGE_INPE
datafix_model/GL_FAO_INPE
dataout/SFC
dataout/SFC
dataout/SFC
dataout/SFC
ndvi
BRAMS
topography
sst
vegetation
soil
RAMSIN_SFC
top_OQ3g
sfc_OQ3g
sst_OQ3g
ndv_OQ3g

ii) MAKEVFILE - From the global data the phase creates the files with the boundary conditions and initial conditions interpolating them to the specifications chosen by the user and arranged in THE RAMSIN.

datain/GRADS
dataout/IVAR
IC
BRAMS
RAMSIN_VFL
ivar

iii) INITIAL - This is the phase of model time integration where prediction data will be produced as specified in RAMSIN.

tables
dataout/SFC
dataout/SFC
dataout/SFC
dataout/SFC
dataout/IVAR
datain/UMID
dataout/POST
dataout/HIS
dataout/ANL
RAMSIN_INI
BRAMS
tables...
top_OQ3g
sfc_OQ3g
sst_OQ3g
ndv_OQ3g
ivar
GL_SM.GPNR
variables.csv
brams-meteo...grads
history
analisys

WARNING: The first two phases (i and ii) should only be rotated with 1 processor!

The test case is small enough to run on a laptop or desktop with 3 processors and with 8GB memory. It covers an area as shown in the figure below.

This area is configured in RAMSIN with 60x60x45 points (x,y,z), 20 km of horizontal resolution (surface) and is centered at 22.6S, 45.2W. The test only allows it to run for 24 hours of forecast. After the end of the round, one can verify the behavior of the model by comparing the results that were produced and are in {YOUR_BIN_AREA}/dataout/POST with those stored in the {YOUR_BIN_AREA}/dataout/POST_COMPARE area. To look at the outputs (GRADS/CTL format) you need to know how to use grads software

WARNING: Make sure your environment is tuned to use the packages installed in the pre-requirements (PATH and LD_LIBRARY_PATH) To look at the outputs (GRADS/CTL format) you need to know how to use grads software..

cd {YOUR_BIN_AREA}
mpirun -np 1 brams-6.0 -f RAMSIN_SFC_MID
mpirun -np 1 brams-6.0 -f RAMSIN_VFL_MID
mpirun -np 3 brams-6.0 -f RAMSIN_INI_MID

A series of logs will be shown on the screen in each of the 3 phases. Be aware of errors reported in these logs. Often there are non-existent files that have not been properly downloaded in the download or the system has some limitation. In the INITIAL phase you can follow the integrations by looking at the screen. It shows each timestep performed and other important information. See for example the figure below that shows part of these messages.

  1. How to see the data outputs

    The output of model as You read above is in GRADS file. May be used another formats but we will show how in expert users guide. If You are using Ubuntu Linux or some Debia derivated Linux You can install grads in a simple way, using apt-get command

    sudo apt-get install grads

    To install grads right from source, please, see the information on site GrADS Downloads. Pay attention on the necessary libraries explained on GrADS Supplibs

    To learn about grads we recommend to read the document Grads Manual from NCEP.

Have Fun with BRAMS-6.0!