Utilização do Inicializador ATP

1. Introdução
O inicializador ATP que está contido no instalador fácil pode tornar mais fácil a tarefa
de rodar tpbig e alguns programas relacionados com o ATP. Voce pode modificar as
opções de ajuste para tpbig e GTPPLOT com o Inicializador ATP. Se voce em adição
instalar o conjunto de biblioteca "InstATPxxx_lib.exe", voce pode também modificar
facilmente as dimensões de tpbig e construir uma versão TACS/Models do tpbig definida
pelo usuário.

Conteúdo:

1. Introdução
2. Para rodar o ATP
3. Ajustes
4. Para construir tpbig
4-1. Para modificar "Listsize"
4-2. Para utilizar TACS Compilada.
4-3. Para utilizar MODELS Compilada.
4-4. MODELS Compilada com DLL

2. Para rodar o ATP

O inicializador do ATP nos permite rodar o comando do ATP, editar um arquivo de
dados, e mostrar uma forma de onda calculada. Primeiro voce deve ajustar o [ATP DATA
NAME](3). Se ele não estiver ajustado, abra os dados do ATP com [File]-[Set ATP data
file](1) ou [Open] (2). E voce pode arrastar e soltar o arquivo no Inicializador ATP.

(4) [Edit ATP-file] (F4)

Edita os dados do ATP com o editor de texto.
(5) [Run ATP] (F2)
Roda o tpbig.
 (6) [Edit Lis-file] (F5)
Mostra o arquivo lis com o editor de texto.
(7) [PlotXY] (F3)
Executa o PlotXY para desenhar gráficos.
(8) [GTPPLOT] (F6)
Executa o GTPPLOT para desenhar gráficos.
(9) [PL4=>CSV]
Converte os dados de saída do formato PL4 para o formato CSV (texto).

A conversão é realizada utilizando o comando “relay” do GTPPLOT.

Coloque o nome do arquivo salvo na caixa “File Name”. O comando
“Choice” do GTPPLOT na caixa “Choice”. Os dados de #1 a #2 são escritos
para este exemplo. O número máximo de dados é restrito a 20 devido às
especificações do GTPPLOT. Os números dos dados podem ser verificados
com o PlotXY e assim por diante.

Outra funções para apagar os arquivos de saída do ATP, mostrar a pasta "work", e
limpar a pasta de trabalho "work", estão disponíveis a partir do menu [Tools],

(10) [Delete ATP outputs]

Apaga os arquivos de saída do ATP ".dbg", ".bin", and etc.
(11) [Open work directory]
Abre o diretório de trabalho com o "explorer".
(12) [Clear work directory]
Apaga todos os arquivos no diretório de trabalho.
3. Ajustes

Os ajustes básicos para runATP32.exe são modificados em Options no menu principal.

(1) [Output to disk & screen]

Marcando aqui, a saída será mostrada na tela e também escrita no disco.

(2) [Close window at end]

Marcando esta opção, a janela DOS será fechada imediatamente após o cálculo.
Desmarcando-se esta opção, ela será fechada após se pressionar qualquer tecla.

(3) [Use work directory]

Marcando-se esta opção, tpbig é executado após copiar o arquivo de dados do
ATP para o diretório de trabalho "work". Os arquivos de saída serão construídos no
diretório de trabalho "work".

(4) [Delete temporary files]

Marcando-se esta opção, arquivos temporários tais como ".dbg" e ".bin" serão
apagados após o cálculo.

Os outros ajustes no detalhe são modificados no botão "Options" diponível a partir do menu
[Tools]-[Options].
 (5) [Associate "Open" to editor]
Marcando esta opção, os arquivos ".atp" serão abertos com o editor de texto
como "default". Desmarcando-se esta opção, ATPLnch.exe será utilizado para abrir
os arquivos ".atp".
(6) [Allow duplication of ATPlnch]
Marcando este quadro, você pode executar vários inicializadores do ATP.
(7) [Use user compiled tpbig.exe]
Marcando esta opção, tpbig designado em (7) será utilizado. Se voce quiser
usar o tpbig compilado com ATPLnch, desmarque esta opção.
(8) tpbig:[Ref]
Designa o tpbig compilado pelo usuário.
(9) [Use mytpbig.exe]
Marcando esta opção, se o tpbig (mytpbig.exe) que é criado com ATPLnch
existe na pasta atpmingw, ele será executado em primeiro lugar. Desmarcando-se esta
opção, o tpbig normal será usado.
(10) [Use Watcom ATP]
Se você deseja usar a versão Watcom do ATP, marque aqui.
(11) [Use compiled TACS]
Para utilizar TACS Compilada, desmarque esta opção.
(12) [Use user defined editor]
Marcando esta opção, o editor designado em (10) será utilizado.
Desmarcando-se esta opção, o editor de texto designado no ATPDraw é utilizado para
abrir os dados do ATP em primeiro lugar. Se nenhum editor for definido no ATPDraw, o
Notepad.exe é usado.
(13) Editor:[Ref]
 Designa o editor de texto.
(14) Work: [Ref]
Muda o diretório de trabalho.
(15) [Directories]
Muda o diretório “default”, por exemplo ATPDraw.

Para mudar os ajustes para o tpbig e GTPPLOT, os botões a partir do menu [Tools]-
[Settings] são utilizados.

(16) [STARTUP]
Modifica os ajustes em STARTUP para tpbig.
(17) [GRAPHICS]
Modifica os ajustes em GRAPHICS e GRAPHICS.AUX para tpbig.
(18) [GTPPLOT]
Modifica os ajustes em GTPPLOT.INI para GTPPLOT.

4. Para construir tpbig

Se voce em adição instalar o Conjunto Biblioteca (InstATPxxx_lib.exe), torna-se
possivel modificar as dimensões em "listsize", para construir uma Versão Compilada
TACS do tpbig e para conectar o código fonte suprido pelo usuário da MODELS para
tpbig.
 (1) [Change Listsize]
Possibilita a modificação das dimensões em "listsize". Os valores escritos
em atpmingw\make\listsize.txt são utilizados para construir um novo tpbig.
(2) [Open]
Abre o arquivo "listsize".
(3) [Save As]
Grava o arquivo "listsize".
(4) [Load Default]
Ajusta os valores "default" em "listsize".
(5) [Make compiled TACS]
Possibilita a construção da Versão Compilada TACS do tpbig.
(6) Usa o “Makefile” “default”.
Utiliza um “Makefile” criado automaticamente.
(7) Makefile:[ref]
Designa o "Makefile" utilizado para construir tpbig.
(8) MinGW Directory:[ref]
Designa o caminho da pasta "bin" do MinGW. Os arquivos MinGW
armazenados em InstATPxxx.lib.exe são restritos como um conjunto mínimo para se
construir exemplos. Se voce quiser utilizar o conjunto completo insira o caminho nesta
opção.
(9) [DEL mytpbig]
Remove o tpbig (mytpbig.exe) criado com o Inicializador ATP.
(10) [DEL objects]
Remove os arquivos objeto (*.o) na pasta de trabalho "work".
(11) [MAKE]
Prossiga para criar o tpbig.
(12) [SAVE]
Grava os valores do "listsize" em atpmingw\make\listsize.txt.
(13) [CANCEL]
 Se voce não pode conectar a biblioteca com erro, tente usar “Makefile_err” na
pasta “\atpmingw\make”. Ela pode ser ajustada a partir de (7) Makefile:[ref].

4-1. Para modificar o "Listsize"

Explica-se aqui como modificar as dimensões no "listsize" do tpbig. O caso teste de

bobina 400 desenvolvido pelo Sr. Matsuo e pelo Dr. Arita é utilizado abaixo como
exemplo.
Copie o arquivo de dados do ATP hit6-3.zip a partir do servidor JAUG e separe o
arquivo hit6-3.dat descompactando e extraindo-o de hit6-3.zip. Para detalhes, leia o
documento "TrBnch01.pdf" e "ICEE2000-JAUG.pdf (seção 4.3)" em
atpmingw\make\sample.

(1) A partir do menu [Tools]-[Make Tpbig.exe], abra a janela "make tpbig".

(2) Marque a caixa (1) [Change Listsize] para possibilitar a modificação das
dimensões em "listsize".
(3) Com a janela (2) [Open], abra o arquivo "listsize",
"atpmingw\make\sample\listsize.hit6"
(4) Desmarque a caixa (5) [Make Compiled TACS].
(5) Acione o botão (10) [MAKE] para construir o tpbig.
(6) Após criar o seu tpbig, abra a opção "options" [Tools]-[Options] e confirme se a
caixa [Use mytpbig.exe] está marcada.
(7) No menu principal abra o arquivo hit6-3.dat para ajustar o nome do arquivo de
dados do ATP.
(8) Abra a opção de "setup" para STARTUP a partir de [Tools]-[Settings]-
[STARTUP], mude o valor de LIMCRD para 50000 como mostrado abaixo. Este
procedimento é necessário para ler o arquivo hit-6.dat.
(9) Execute o ATP com o botão [Run ATP]. Ele deve levar alguns minutos para
terminar o cálculo.
 4-2. Para usar TACS Compilada

Explica-se aqui como construir uma versão Compilada TACS do tpbig. Os dados
exemplo são baseados no "benchmark" de DC43.

(1) Abra DC43CT.adp em project\sample pelo ATPDraw.

(2) Construa DC43CT.atp a partir de [Make File As...].
(3) Feche o ATPDraw e abra o DC43CT.atp em atp\work pelo Inicializador ATP.
(4) A partir do menu [Tools]-[Make Tpbig.exe], abra a janela para construir tpbig.
(5) Desmarque a caixa (1) [Change Listsize].
(6) Marque a caixa (5) [Make Compiled TACS].
(7) Pressione o botão (10) [MAKE] para construir tpbig.
(8) Após criar o seu tpbig, abra a janela "options" [Tools]-[Options] e confirme que
as caixas [Use mytpbig.exe] e [Use compiled TACS] estejam marcadas.
(9) Execute o ATP com o botão [Run ATP].

4-3. Para anexar um código fonte de MODELS fornecida pelo usuário.

Voce pode utilizar uma função externa escrita em Fortran/C/C++ na MODELS. Detalha-
se nesta seção como conectar o código fonte suprido pelo usuário de MODELS para tpbig
com os arquivos fonte exemplo e "Makefile" na pasta atpmingw\make\sample.

(1) Execute o Inicializador ATP.

(2) A partir do menu [Tools]-[Make Tpbig.exe], abra a janela para construir tpbig.
(3) Desmarque a caixa (1) [Change Listsize] e a caixa (5) [Make compiled TACS].
 (4) Pressione o botão (7) [ref] para modificar "Makefile" e abrir
atpmingw\make\sample\Makefile_c++.
(5) Pressione o botão (11) [MAKE] para construir tpbig.
(6) Após criar o seu tpbig, abra a janela "options" em [Tools]-[Options] e confirme
se a caixa [Use mytpbig.exe] está assinalada.
(7) Abra Open Ex_mod_c.adp na pasta project\sample pelo ATPDraw.
(8) Execute o ATP a partir do menu [ATP]-[run ATP].

Nota) Quando voce muda as dimensões "listsize" e faz uma versão TACS Compilada
do tpbig, utilize o "Makefile" normal na pasta "atpmingw\make".

4-4. Versão DLL do código fonte de MODELS fornecida pelo usuário.

A função externa MODELS pode ser carregada a partir de Windows DLL (Dynamic
Link Library). O exemplo para construir tpbig e DLL para as funções MODELS carregáveis
está localizado na pasta atpmingw\make\sample. Os arquivos fonte exemplo são usedll.c,
DLLfunc.c, e sample.f. Voce pode fazer mytpbig.exe e Dllfunc.dll com Makefile_dll.

(1) Execute o Inicializador ATP.

(2) A partir do menu [Tools]-[Make Tpbig.exe], abra a janela para fazer tpbig.
(3) Desmarque a caixa (1) [Change Listsize] e a caixa (5) [Make compiled TACS].
(4) Pressione o botão (6) [ref] para modificar "Makefile" e abra
atpmingw\make\sample\Makefile_dll.
(5) Pressione o botão (10) [MAKE] para fazer o tpbig.
(6) Após criar o seu tpbig, abra a janela "options" a partir de [Tools]-[Options] e
confirme se a caixa [Use mytpbig.exe] está assinalada.
(7) Abra Ex_DLL.adp em project\sample pelo ATPDraw.
(8) Execute o ATP a partir do menu [ATP]-[run ATP].

Nota1) Quando voce modifica as dimensões do "listsize" e faz a versão TACS

compilada do tpbig, utilize o "Makefile" normal na pasta "atpmingw\make".
Nota2) A Dllfunc.dll é criada na pasta "atpmingw", apague este arquivo
manualmente após a sua verificação deste exemplo.

Se voce tiver qualquer questão e/ou solicitação, envie um e.mail em inglês ao Dr. Hajime
Urai (hurai@ieee.org).

Copyright(c) Hitachi, Ltd. Power and Industrial Systems R&D Laboratory

Japanese ATP User Group (JAUG)
All rights reserved.
Original version written by Hajime Urai
HTML version written by Shinichi Kondo
Supervision by JAUG Chairman Hiroshi Arita
Status: Last Update: November 07, 2004.
 Traduzido por: José Roberto Camacho
Comitê Brasileiro de Usuários do ATP-EMTP - Membro no 008
Universidade Federal de Uberlândia - Faculdade de Engenharia Elétrica
NERFAE - Núcleo de Eletricidade Rural e Fontes Alternativas de Energia
Caixa Postal: 593 - CEP: 38400.902 - Uberlândia - MG
Fone:+55.34.3239.4165/Ext.:250 - Fax:+55.34.3239.4166
e-mail: jrcamacho@ieee.org
Traduzido em 16 de Novembro de 2004.
Última atualização em 07 de Novembro de 2004.