!-----------------------------------------------------------------------------!
!             Modeling and Development Division - DMD/CPTEC/INPE              !
!-----------------------------------------------------------------------------!
!BOI
! !TITLE: 
!      minFcos: Ferramenta de diagnostico e impacto na minimizacao da funcao custo na assimilacao de dados usando o GSI
!
! !DESCRIPTION:
!
-Conteudo:
Este pacote minFcos trata-se de um dos protocolo de avaliacao e diagnostico do impacto de modificacoes nos sistemas que empregam o GSI em comparacao com as revisoes anteriores. Ele junto com outros protocolos compoem um sistema integrado de avaliacao do GSI em suas diversas versoes usadas no CPTEC (global, regional, ensemble, outras). Esse pacote 'minFcos' contem scripts que chamam o ncl e gnuplot para processar, organizar e gerar figuras que sintetizam os resultados e facilitam a avaliacao. Para executar os scripts do pacote basta seguir o passo-a-passo apresentado nesse arquivo README.

-Aplicacao
Ajustes nos parâmetros e monitoramento do processo de minimização da função custo no sistema de assimilação em função da base de dados utilizados: Com o acoplamento do modelo BAM ou outros com o sistema de assimilação de dados GSI, a minimização e o condicionamento da função custo variacional é a parte do sistema de assimilação de dados que irá permitir que a análise possa ser determinada. Diversos parâmetros deverão ser definidos, os quais são correlacionados com a base de dados usada e a interação dessas frentes deve ser monitorada. Esse protocolo tem a principal aplicacao avaliar o impacto na minimizacao da funcao custo com a base de dados usada em cada revisao realizada no repositorio dos sistemas que empregam o GSI, no CPTEC. 

-Dinamica do processo:
Os dados usados como entrada podem ser encontrados no diretorio publico que contem as saidas no periodo do testcase:
gsidataout=/scratchin/grupos/assim_dados/home/gdad/public/eval/diag/minFcos/testcase
Para gerar as saidas, os arquivos fort.220 sao filtrados para que o programa em fortran cost.f90 possa gerar a media e desvio padrao no arquivo fort.2. Um script em ncl gera duas figuras de saida correpondentes as medias nos horarios 00-12 e 06-18. Dos arquivos fort.220 tambem sao extraídos os valores minimos da funcao custo em funcao dos ciclos em forma de tabela. O gnuplot gera uma figura com esses dados.
As 3 figuras geradas sao movidas para a pasta figure e as 2 tabelas para a pasta tabela.

-Observacao:
Antes de executar o pacote, o mesmo deve ser configurado e compilado atraves do script config_eval.sh definindo o sistema de modelagem em avaliacao, sendo esse um pre requisito. Um label do experimento usado para armazenar os dados de saida e também necessário mas não é requerido usando como padrão TESTCASE. Isso deve ser colocado como argumento de entrada do ./config_eval.ksh e depois no ./run_minFcos.ksh

- Passo-a-passo
Execute o script de configuracao com o argumento configurar e o nome do sistema e label do experimento. Para o testcase digite
> cd ${SUBMIT_HOME}/SMG/eval
> ./config_eval.ksh configurar SMG 
Compile o processo executando o script de configuracao com o argumento compilar 
> ./config_eval.ksh compilar SMG 
Ele criara o executavel cost.x. 
Execute o script de realizacao do sistema
> cd diag/minFcos
> ./run_minFcos.ksh
Observe os resultados nos diretorios de saida do experimento TESTCASE
${minFcos_work}/
Sendo as tabelas em 
${minFcos_work}/tabela
as figuras em
${minFcos_work}/figure

-Sinopse do pacote:
Esta rotina faz as seguintes etapas em sequencia:
* Cria arquivos de figuras e tabelas com resultados da avaliacao.

-Melhorias futuras:
*