Passos para execuo do modelo BRAMS

Autor: William Voorsluys

Revisores: Jos Flvio, Marcelo Oliveira, 29/08/2005

Sumrio
1CriaodeumdiretrioexclusivoparaaexecuodoBRAMS.......................................2
2ConfiguraodoarquivodeentradaRAMSIN..................................................................2
2.1Tipodeexecuo......................................................................................................2
2.2Tempodesimulao.................................................................................................3
TIMEUNIT............................................................................................................3
TIMMAX...............................................................................................................3
IMONTH1.............................................................................................................3
IDATE1.................................................................................................................3
IYEAR1.................................................................................................................3
ITIME1..................................................................................................................3
2.3Resoluo..................................................................................................................3
NGRIDS.................................................................................................................3
2.4Localizaodearquivos............................................................................................3
VARFPFX.............................................................................................................4
AFILOUT..............................................................................................................4
ITOPTFN,ISSTFN,IVEGTFN.............................................................................4
COLTABFN..........................................................................................................4
IAPR......................................................................................................................4
VARPFX................................................................................................................5
3Prprocessamento.............................................................................................................5
4ExecutandooBRAMS.......................................................................................................5
5Psprocessamento.............................................................................................................6
5.1Parmetrosquedevemserdefinidospelousurio.....................................................6
NPV.......................................................................................................................6
VP..........................................................................................................................6
INPLEVS...............................................................................................................6
IPLEVS:.................................................................................................................6

Criao de um diretrio exclusivo para a execuo do BRAMS

O primeiro passo necessrio para se ter uma execuo tranquila criar um

diretrio exclusivo para este propsito. Essa uma boa prtica j que o BRAMS
gera muitos arquivos, que podem ficar desorganizados. O diretrio deve ter o
seguinte contedo:
1. O executvel do BRAMS ou um link simblico para ele;
2. Um arquivo de configurao RAMSIN.
O exemplo abaixo mostra a configurao inicial de um diretrio de execuo
do BRAMS.
bra m s @ e s c r i v a o : ~ / b r a m s _ d i r $
tot a l

ls

-l

36

- rw- r- - r- lrw x r w x r w x

1 br a m s
1

bra m s

ls d

30 8 5 0

ls d

Apr
46

18

Ap r

17 : 5 4
18

RAM S I N

17 : 5 2

bra m s

->

gri d / b r a m s / b r a m s 2 0 / b u i l d / 5 0 4 / r a m s - 5. 0 4 - op t . 2 0
drw x r - xr- x

2 br a m s

ls d

409 6

Apr

18

17 : 5 1

ivd a t a

Configurao do arquivo de entrada RAMSIN

O RAMSIN o arquivo de controle do modelo, atravs do qual diversos

parmetros podem ser ajustados. Aqui sero discutidos apenas os parmetros
que julgamos relevantes.
2.1 Tipo de execuo
A opo RUNTYPE define uma das 5 maneiras possveis que o modelo pode
ser executado. Cada tipo corresponde a uma fase de execuo, que tipicamente
so executadas sequencialmente. Em muitas situaes, os dados gerados em
algumas fases so os mesmos para vrias configuraes do modelo, permitindo
que sejam executadas apenas uma vez. As opes relevantes aqui so
MAKEVFILE e INITIAL.
Quando o modelo rodado com a opo MAKEVFILE o pacote ISAN
(ISentropic ANalysis ) executado com o objetivo de analisar o conjunto de
dados e criar os arquivos de inicializao de variveis (variable initialization files
ou varfiles).
O modo de execuo INITIAL define o incio da simulao propriamente dita.

Essa opo define que essa rodada ser a primeira da simulao. Nessa fase,
presume-se que todas as variveis atmosfricas j foram preparadas atravs da
execuo do ISAN.
possvel efetuar uma mesma simulao com mais de uma rodada do
modelo. A partir da segunda rodada, a simulao iniciada em um tempo
diferente de 0. Para esse caso usa-se a opo HISTORY, sendo possvel
continuar a partir do ponto que a simulao anterior parou. Isso possvel
porque um brams realiza uma espcie de checkpointing. No exemplo deste
documento esta opo no ser usada.
2.2 Tempo de simulao
As variveis necessrias para ajustar o tempo de durao da simulao so:

TIMEUNIT

A unidade em que a varivel TIMMAX ser expressa. Os valores

permitidos so: s (segundos), m (minutos), h (horas) e d (dias).

TIMMAX

Define o tempo da simulao em que a rodada atual ir parar. Como

estamos apenas considerando rodadas comeando no tempo 0 e sem
execues subsequentes, essa varivel define o tempo total de
simulao. No execuo com a opo MAKEVFILE ela serve para definir
o perodo que o ISAN ir gerar os varfiles.

IMONTH1

Ms de incio da simulao. um inteiro no formato MM.

IDATE1

Dia de incio da simulao. um inteiro no formato DD.

IYEAR1

Ano de incio da simulao. um inteiro no formato AAAA.

ITIME1

Hora e minuto do incio da simulao, no horrio de Greenwich (GMT)

2.3 Resoluo

NGRIDS

Especifica o nmero de grades aninhadas a serem ativadas na execuo

do modelo. Se o valor for 1 uma nica grade cobrindo todo o domnio
espacial ser ativada. Se o valor for 2, uma segunda grade aninhada
primeira ser ativada. Uma grade aninhada til para obter resolues
maiores em reas especficas do domnio da simulao.
2.4 Localizao de arquivos
Esta seo descreve as variveis que devem ser configuradas para que o
modelo encontre os arquivos de entrada necessrios e armazene os arquivos
de sada no local correto.

VARFPFX

Prefixo necessrio para encontrar os varfiles. definido pelo caminho

(absoluto ou relativo ao diretrio onde se encontra o executvel do
modelo) do diretrio onde os arquivos se encontram, seguido pelo incio
do nome dos arquivos que iro compor o conjunto.
Ex.: ./ivdata/iv

AFILOUT

Prefixo dos arquivos de anlise, que so o resultado da execuo do

modelo com a opo RUNTYPE=INITIAL.
Ex.: AFILOUT = './anal',

ITOPTFN, ISSTFN, IVEGTFN

Estas variveis so prefixos para arquivos de topografia terrestre,

temperatura da superfcie do mar e vegetao, respectivamente. As
variveis so dependentes dos grids, portanto devem conter valores
especficos para inicializar cada grid da simulao.
Ex.:
ITOPTFN = '/grid/brams/dprep/topo10km/H',
'/grid/brams/dprep/topo10km/H',
ISSTFN = '/grid/brams/dprep/sst/S',
'/grid/brams/dprep/sst/S',

IVEGTFN = '/grid/brams/dprep/veg_usgs/VEGET_',
'/grid/brams/dprep/veg_usgs/VEGET_',

COLTABFN

Arquivo contendo a tabela de micro fsica.

Ex.: COLTABFN = '/grid/brams/dprep/micro/ct2.0',

IAPR

Prefixo dos arquivos preparados (DP) que contm os dados de entrada

para o modelo.
Ex.: IAPR = '/grid/brams/dprep/DP/dp',
Alm de configurar esta varivel, deve-se certificar que os arquivos
necessrios para a execuo existem no diretrio. O nome do DP
formado seguindo o padro dpAAAA-MM-DD (p.ex. dp2005-04-22). O
BRAMS utiliza quatro arquivos DP para cada dia do tempo de simulao.
Aqui, presumimos que o valor do parmetro ISAN_INC igual a 0600;
esse valor informa ao ISAN o intervalo de tempo existente entre um
arquivo DP e outro. Com essa configurao, um DP necessrio para
cada 6 horas da simulao a partir da data de incio at TIMMAX
unidades de tempo no futuro. Por exemplo, se configurarmos a simulao
com
IMONTH1=04,
IDATE1=01,
IYEAR1=2005,
ITIME1=0000,
TIMEUNIT=d e TIMMAX=3, estamos definindo uma simulao de 3 dias
iniciando zero hora do dia 1o de abril de 2005, sendo necessrios 12
arquivos DP, que so:
1. dp2005-04-01-0000
2. dp2005-04-01-0600
3. dp2005-04-01-1200
4. dp2005-04-01-1800
5. dp2005-04-02-0000
6. dp2005-04-02-0600
7. dp2005-04-02-1200
8. dp2005-04-02-1800
9. dp2005-04-03-0000
10.dp2005-04-03-0600
11.dp2005-04-03-1200

12.dp2005-04-03-1800

VARPFX

Prefixo usado pelo ISAN para definir o nome usado para gerar os
arquivos de sada (varfiles).
Ex.: VARPFX
= './ivdata/iv-rams504-V', (o diretrio ivdata deve ser
criado previamente).

Pr-processamento
Preparao dos Arquivos GRBs
Para realizarmos o pre-processamento necessrio que os
arquivos DPs sejam gerados a partir dos arquivos GRBs. Logo, devemos
copiar os arquivos GRBS de interesse, referentes aos periodos
especificados no RAMSIM, para a pasta onde o BRAMS ser executado.
Para gerar os arquivos DPs tambm so necessrios os arquivos:
grib2dp, grbconv e o arquivo de configurao PREP_IN. Estes arquivos
esto na pasta de instalao do BRAMS e devem ser copiados para a
pasta onde o BRAMS ser executado.
O prximo passo executar o comando: grib2dp, dentro da pasta
onde esto os arquivos GRBs. Aps a execuo, sero gerados os
arquivos DPs com o seguinto formato: dp+ANO-MS-DIA-HORA (dp200504-01-0000). Tambm dever ser criada a pasta DP: mkdir DP, ento os
arquivos gerados devero ser copiados para esta pasta: mv dp* ./DP.
Execuo do BRAMS
A etapa de pr-processamento do BRAMS corresponde gerao
dos arquivos de inicializao de variveis (varfiles). Isso feito executando
o modelo utilizando o arquivo RAMSIN que tenha a opo RUNTYPE
configurada como MAKEVFILE.
Para a execuo do BRAMS necessrio a criao das pastas: A,
H, ivdata e data: mkdir A, mkdir H, mkdir ivdata e mkdir data; Essas
pastas sero utilizadas para o pre e pos processamento.

Aps configurar o RAMSIN, basta invocar o executvel do BRAMS

atravs do comando: ./brams
4

Executando o BRAMS

Aps a gerao dos varfiles, o modelo deve ser executado utilizando um

arquivo RAMSIN que tenha a opo RUNTYPE configurada como INITIAL. O
objetivo desta execuo a gerao dos arquivos de anlise.
Para executar o BRAMS basta invocar o executvel.
Obs.: O BRAMS aceita como parmetro de linha de comando a opo -f
seguida do nome do arquivo de controle. Isso til quando se deseja utilizar um
nome para o arquivo de controle diferente de RAMSIN. Por exemplo, pode-se
desejar criar dois arquivos com opes RUNTYPE diferentes e invocar o
BRAMS com um arquivo de cada vez:
./brams -f RAMSIN_MAKEVFILE
./brams -f RAMSIN_INITIAL
5

Ps-processamento

Essa etapa correponde definio das variveis e nveis de presso para

coordenar a extrao de informaes dos arquivos de anlise pelo programa
RAMSPOST. As configuraes necessrias so feitas no arquivo de controle
ramspost.inp. Este arquivo dever ser copiado da pasta de instalao para a
pasta de execuo do BRAMS.
5.1Parmetros que devem ser definidos pelo usurio

NPV

Quantidade de variveis desejadas. Extrai as X primeiras variveis

listadas no parmetro VP.
Ex.: NVP =3,

VP

Esta lista corresponde ao conjunto de variveis que ser extrado dos

arquivos de anlise.
Ex.: VP = 'tempc' ,
'precip'
,

'v'
'tsoil'
'smoist'
'vtype'
'veglai'
'vegfrac'

,
,
,
,
,
,

INPLEVS

Quantidade de nveis de presso.

Ex.: INPLEVS=4,

IPLEVS:

Nveis de presso
Ex.: IPLEVS =1000,
850,
700,
200,

Aps a configurao do arquivo ramspost.inp criar um link para o arquivo

ramspost_50, localizado na pasta newbrams/pos-proc dentro da pasta de
instalao do BRAMS:
ln -s pastaBrams/newbrans/pos-proc/ramspost_50 ramspost
O prximo passo executar o ramspost: ./ramspost
Aps a execuo do ramspost sero gerados arquivos de anlise dentro
da pasta A correspodentes ao perodo especificado no RAMSIN.