Skip to content

Latest commit

 

History

History
110 lines (78 loc) · 5.34 KB

BRAMS_6.0_-_INSTALL_MODEL.md

File metadata and controls

110 lines (78 loc) · 5.34 KB
Raw

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. Even You believe the system are ready, please, read the prerequisites document.

  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} . Pay attention in correct compiler You are using!!!!

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

    If You have doubt please, read the prerequisites' doc and use the alias You build (see 9. in prerequisites)

    echo $PATH
echo $LD_LIBRARY_PATH

    Please check if Fortran and C version is the correct. (The example is only for Gnu. You must change if use another compiler)

    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={your_ortran_compiler} --with-ccomp={your_C_compiler} --with-netcdff={YOUR_DIR} --with-netcdfc={YOUR_DIR} --with-wgrib2={YOUR_DIR}

Bellow an example of use using Gnu, 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

    The output of BRAMS's model is presented with colors in terminal. If You save the output log (by ">&" use) may be a problem if You want to edit the file. Is possibles to make a filter to extract all special symbols used to color the output. To make the filter just

    make filter
make install-filter

    BRAM's models needs a lot of input files. One of them is the Initial and boundary conditions (IC). This files is created from a global model data. Two diferents data input must be created, from NCEP model GFS or from ERA5 data. To create the IC data You must create the PRE-BRAMS utility.

    make pre-brams
make install-pre-brams

  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. 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.