12 CAPÍTULO 12 – Ferramentas Adicionais
O EPA SWMM é capaz de ativar aplicações externas a partir de sua interface gráfica, podendo, assim, ampliar as suas capacidades de simulação. Este capítulo descreve como tais ferramentas podem ser gravadas e compartilhadas com o SWMM 5.
12.1 O que são as Ferramentas Adicionais
As ferramentas adicionais são aplicações diversas que os usuários podem adicionar ao Submenu de ferramentas da barra de Menu Principal e serem ativadas enquanto o SWMM ainda estiver efetuando simulações. O SWMM pode interagir com estas aplicações, até um certo limite, trocando dados via arquivos pré-definidos (ver capítulo 11) ou por meio da área de transferência do Windows. As ferramentas adicionais podem então prover algumas capacidades, além daquelas já oferecidas pelo SWMM. São exemplos úteis:
> Uma ferramenta que realize análises estatísticas de séries longas de chuva antes
que sejam alocadas a um pluviômetro.
> Um programa externo de edição para facilitar o manuseio de um conjunto de
dados do SWMM.
> Um programa de estimação do hidrograma unitário que poderia derivar o
conjunto de parâmetros R-T-K para um grupo de hidrogramas unitários do RDII, que poderiam ser copiados e colados diretamente no editor de hidrogramas unitários.
> Um programa de pós-processamento que, utilizando os cálculos hidráulicos do
SWMM, poderia calcular a remoção de sólidos em suspensão em uma unidade de armazenamento.
> Um modelo de propagação de fluxo, além daqueles já existentes no SWMM.
A Figura 12.1 mostra como se apresenta o menu ferramentas após ter incorporadas diversas ferramentas adicionais. A opção Configuração de Ferramentas é utilizada para adicionar, excluir ou editar uma ferramenta adicional. As opções listadas a seguir são as ferramentas adicionadas pelo usuário e que podem ser executadas selecionando-as a partir do submenu correspondente.
Ferrame n ta s A d ic ion a is 164
Figura 12.1 - Menu Ferramentas do SWMM 12.2 Configurando Ferramentas Adicionais
Para configurar a sua coleção pessoal de ferramentas adicionais, selecionar a opção Configurar Ferramentas da aba ferramentas do menu principal. Isto ativará a caixa de diálogo Opções de Ferramenta como mostrado na Figura 12.2. A caixa de diálogo apresenta a lista das ferramentas já disponibilizadas e possui botões de comando para adicionar uma nova ferramenta ou excluir e editar uma ferramenta disponibilizada. Os botões seta para cima ou seta para baixo são utilizados para permutar a ordem das ferramentas na lista apresentada.
Figura 12.2 - Caixa de diálogo Opções de Ferramenta
Ao se clicar sobre o botão adicionar ou editar, uma nova caixa de diálogo Propriedades da Ferramenta será ativada como mostrado na Figura 12.3. Esta caixa de dialogo é utilizada para descrever as propriedades da nova ferramenta a ser adicionada ou editar as propriedades de uma ferramenta já disponibilizada.
Os campos de dados a serem inseridos na caixa de diálogo Propriedades da Ferramenta são:
Nome da ferramenta
Indica o nome dado à ferramenta tal como aparecerá no menu Ferramentas. Programa
Indica o caminho completo da ferramenta que será ativada ao clicar no seu nome, no menu Ferramentas. Pode também se clicar no botão para selecionar o programa executável da ferramenta adicional, a partir da caixa de seleção de arquivos do Windows.
Ferrame n ta s A d ici o na is 165 Pasta de trabalho
Este campo contém o nome do diretório que será utilizado como diretório de trabalho, enquanto a ferramenta estiver sendo utilizada. Pode também se clicar no botão para procurar e selecionar a pasta correta, a partir da caixa de seleção de diretórios do Windows. Pode-se também digitar a Macro $PROJDIR para utilizar diretamente o diretório do projeto atual ou a Macro $SWMMDIR para utilizar o diretório onde se encontra o programa executável do SWMM 5. Essas Macros podem também ser inseridas no campo da pasta de trabalho, selecionando o seu nome na lista de Macros disponíveis na caixa de diálogo e pressionando o botão . Pode-se, também, deixar este campo em branco; neste caso o diretório atual do sistema será utilizado.
Figura 12.3 - A caixa de diálogo Propriedades da Ferramenta Parâmetros
Este campo contém a lista dos argumentos da linha de comando que o programa executável precisa ao ser acionado. Vários parâmetros podem ser fornecidos ao mesmo tempo, desde que separados por espaços. Certas Macros pré-definidas são disponibilizadas e representadas por símbolos na lista de Macros da caixa de diálogo, de forma a simplificar o processo de listagem dos parâmetros de execução. Quando se insere uma dessas Macros na linha de comando, esta será ativada, ou seja, o seu símbolo será convertido nos argumentos correspondentes na linha de comando, assim que se acionar a ferramenta adicional. Um símbolo específico de Macro pode ser digitado no campo dos parâmetros ou selecionado da lista de Macros (clicando em cima) e adicionado à lista de Parâmetros clicando no botão . As Macros pré-definidas e seus símbolos são descritos no Quadro 12.1.
Exemplificando como a Macro trabalha, considere os campos preenchidos na caixa de diálogo de propriedades mostrada na Figura 12.3. Essa ferramenta Adicional – o Editor de Planilhas - busca ativar o Excel, da Microsoft, e abrir um arquivo de dados do SWMM cujo nome deve ser especificado. Para tanto, o SWMM emitirá a seguinte linha de comando: C:\Arquivos de programas\Microsoft Office\Office10\EXCEL.EXE $INPFILE
Ferrame n ta s A d ic ion a is 166
onde a concatenação de caracteres $INPFILE é substituída pelo nome de um arquivo temporário que o SWMM cria internamente e que conterá os dados do projeto.
Quadro 12.1 - Macros utilizadas como parâmetros de linha de comando para ferramentas externas adicionais
Símbolo da
Macro Substituído na linha de comando por
$PROJDIR O diretório onde os arquivos do projeto SWMM atual são armazenados.
$SWMMDIR O diretório onde o programa executável do SWMM se localiza.
$INPFILE O nome de um arquivo temporário contendo os dados do projeto atual.
$RPTFILE O nome de um arquivo temporário criado logo após a ferramenta adicional ser ativada e que pode ser visualizado após fechamento da ferramenta, utilizando o
comando Relatório do Estado do Menu principal do SWMM.
$OUTFILE O nome de um arquivo temporário onde a ferramenta escreve os resultados da simulação. O arquivo pode ser visualizado após fechar a ferramenta da mesma
maneira que seria feito para os resultados de uma simulação com o SWMM. $RIFFILE
O nome do arquivo da interface de escoamento superficial, tal como especificado na página relativa aos arquivos de interface na caixa de diálogo de Simulação. Nele, foram gravados os resultados de escoamento superficial de uma simulação anterior do SWMM.
Desativar o SWMM enquanto estiver executando
Marcar esta opção para minimizar e desativar o SWMM enquanto a ferramenta adicional está sendo executada. Normalmente, precisa-se utilizar esta opção se a ferramenta produz um arquivo de entrada ou de saída do SWMM, tal como ocorre quando as Macros $INFILE ou $OUTFILE são inseridas como parâmetros da linha de comando. Quando esta opção for habilitada, a janela principal do SWMM será minimizada e não responderá a qualquer comando do utilizador até que termine a execução da ferramenta adicional.
Atualizar o SWMM após fechamento
Habilitando esta opção o SWMM será atualizado após o término da execução da ferramenta adicional. Esta opção só pode ser marcada se a opção Desativar SWMM enquanto estiver executando for selecionada. A atualização pode ser feita de duas maneiras. 1) Se a Macro $INPFILE foi introduzida na lista de parâmetros da linha de comando e o arquivo temporário correspondente produzido pelo SWMM for atualizado pela ferramenta, então os dados do projeto atual serão substituídos pelos dados contidos no arquivo temporário. 2) Se a Macro $OUTFILE foi introduzida na lista de parâmetros da linha de comando, e se o arquivo correspondente contém um conjunto de dados corretos após a execução da ferramenta adicional, então o conteúdo deste arquivo será utilizado pelo SWMM para mostrar os resultados da simulação.
De forma geral, os fornecedores de ferramentas externas deverão disponibilizar instruções a respeito das configurações a serem introduzidas na caixa de diálogo de propriedades das ferramentas adicionais para que estas sejam corretamente associadas a um projeto SWMM.