Instalación del “Paquete Básico” ATP/ATPDraw

Germán Gustavo Lorenzón

glorenzon@frsf.utn.edu.ar

2

Índice de Temas

• Introducción.

• Organización Básica.

• Instalación del ATP.

– Modificación o Creación de una Variable de Entorno en Windows.

– Verificación de la Correcta Instalación del ATP.

• Instalación del ATPDraw.

• Instalación del PlotXY.

• Personalizando el ATPDraw.

– Asociar un Post-Procesador Gráfico al Comando run Plot.

– Crear el Nuevo Comando Correr Archivo.

• Actualización.

• Recomendaciones Adicionales.

3

El ATP es un programa versátil que permite al usuario organizarse de múltiples formas; pero es quizás esta versatilidad el primer obstáculo para quién da sus primeros pasos con el programa.

Así, para orientar al usuario inexperto en su inicio con el ATP, más precisamente en lo que respecta a la instalación del mismo, se elaboró la presente guía; pues, ha pesar de no presentar grandes dificultades, representa el primer escollo a sortear.

“El ATP es un programa GRATUITO pero NO ES DE LIBRE DIFUSIÓN, por lo que se requiere tener una LICENCIA para utilizarlo. Si usted ya ha obtenido su licencia, puede proceder con la instalación del programa.”

Introducción

4

• Como se advirtió más arriba, el ATP es un programa muy versátil y admite muchas formas de organización, siendo, la que se da a continuación, una de las tantas posibles y, la que a nuestro humilde entender, resulta más conveniente para un usuario con poca experiencia.

• Para la organización básica de las carpetas donde se instalarán los distintos programas se deben seguir los siguientes pasos:

1. Seguramente, la PC donde se instalará en paquete básico de ATP posee un disco y/o partición C:\, y eventualmente otro disco y/o partición D:\. Se deberá seleccionar uno de estos discos y/o particiones para instalar el programa.

2. Ahora, suponiendo que se optó por instalar el programa en el disco C:\, en el mismo, se deberán crear las siguientes carpetas (subdirectorios):

NOTA: a) Cerciórese de que el disco posea un espacio libre de, al menos, unos 200 MB; aunque el “Paquete Básico” ocupe aproximadamente unos 50 MB.

b) Los programas que se instalarán son los siguientes: EMTP (en su versión ATP), ATPDraw y PlotXY.

Organización Básica

5

a. C:\ATP\EMTP\ – carpeta en la que se instalará el programa principal del ATP y los archivos auxiliares que lo deben acompañar (contenido del archivo ATPMinGW.zip).

b. C:\ATP\ATPDr58\ – carpeta en la que se instalará el pre-procesador gráfico ATPDraw. En este caso se instalará la versión 5.8p1 del ATPDraw.

c. C:\ATP\PlotXY\ – carpeta en la que se instalará el post-procesador gráfico PlotXY (programa que permite manipular los archivos PL4 y graficar los oscilogramas que resultan de la simulación).

d. C:\ATP\ARMAFit\ – carpeta en la que se instalará la subrutina ARMAFit (AutoRegressive–Moving-Average Fitting program) utilizado para la construcción de modelos con parámetros variables con la frecuencia.

e. C:\ATP\Data\ – carpeta en la que se guardarán algunos archivos de datos que acompañan el programa, como es el caso de los archivos benchmark, u otros archivos generados por el usuario.

f. C:\ATP\TEMP\ – carpeta en la que se descomprimirán de manera temporaria algunos archivos compactados (luego de la instalación puede ser eliminada).

NOTA: Los nombres de los directorios utilizados no es excluyente para la instalación del programa, el usuario podrá nombrarlos a su gusto. Ahora, es altamente recomendable que los nombres de los directorios no posean, ni espacios en blanco, ni más de ocho caracteres. Aunque en la actualidad la cantidad de caracteres no reviste mayores inconvenientes, si debe evitarse el uso de espacios en blanco en los nombres de archivos y directorios.

Organización Básica

6

• Los archivos correspondientes al EMTP-ATP deben “instalarse” en la carpeta C:\ATP\EMTP\. Para lograr esto, se deberán seguir los siguientes pasos:

1. Copiar el archivo ATPMinGW.zip en el directorio C:\ATP\TEMP\ y descomprimir su contenido en esta carpeta.

2. Cortar y pegar todos los archivos, excepto el archivo armafit.zip, en la carpeta C:\ATP\EMTP\.

NOTA: Las diferentes versiones del EMTP-ATP se identifican a través de su fecha de creación del archivo TPBIG.EXE (ver campo Fecha de Modificación). En este caso se utilizará la versión dic-12.

Instalación del ATP

Archivos a copiar

en la carpeta

C:\ATP\EMTP\

7

3. Descomprimir el contenido del archivo armafit.zip –ubicado en C:\ATP\TEMP\-, en la carpeta C:\ATP\ARMAFit\.

4. Eliminar los archivos temporales atpmingw.zip y armafit.zip del directorio C:\ATP\TEMP\.

NOTA: Antes de continuar es conveniente que el usuario se asegure que hayan instalado correctamente los archivos en el directorio C:\ATP\EMTP\. O sea, que en el directorio indicado, se encuentre el archivo tpbig.exe –que es el EMTP-ATP propiamente dicho-, y sus archivos auxiliares.

Instalación del ATP

Descomprimir en

C:\ATP\ARMAFit\

8

• Para Computadoras con Windows XP, Windows VISTA ó Windows 7. Aún cuando el siguiente procedimiento corresponde explícitamente a Windows 7, el mismo se puede aplicar para Windows XP o Vista.

1. Ir a Inicio\Panel de Control.

2. Una vez en el Panel de Control hacer clic sobre el icono Sistema y Seguridad y luego sobre el ícono Sistema.

3. Una vez en el menú Propiedades del Sistema ir a la página Configuración Avanzada del Sistema y seleccionar Variables de Entorno.

4. Antes de continuar, el usuario, debe decidir si la nueva variable del sistema va a ser solo válida para el usuario que se encuentra en ese momento operando la PC o para todos los usuarios. En virtud de lo decidido deberá presionar el botón Nueva... en el recuadro correspondiente a Variables de Usuario para... ó Variables del Sistema, según sea el caso.

Instalación del ATP Modificación, o Creación, de una Variable de Entorno en Windows

9

5. Suponiendo que se ha presionado el botón Nueva... del recuadro Variables de Usuario para..., se deberá ingresar en el campo Nombre de la Variable el nombre GNUDIR y en el campo Valor de la Variable la ruta de acceso siguiente C:\ATP\EMTP\.

6. Aceptar las modificaciones. En este caso no es necesario reiniciar la PC para que el sistema reconozca esta nueva variable, pero es siempre recomendable hacerlo.

NOTA: Para otras versiones de Windows el camino a seguir para modificar las variables de entorno puede ser algo diferente.

Instalación del ATP Modificación, o Creación, de una Variable de Entorno en Windows

No olvidar colocar la

barra invertida al final

del valor de la variable

10

• Para verificar que la instalación del EMTP-ATP se ha realizado correctamente, se deberán seguir los siguientes pasos:

NOTA: Lo que sigue es válido sea cual sea el sistema operativo que esté instalado en la PC.

1. Buscar cualquier archivo de simulación del EMTP-ATP (archivo .dat o .atp), por caso, uno de los archivos de simulación de prueba (benchmark) distribuidos junto al programa. Para ello, descomprimir el contenido del archivo alldat.zip en la carpeta C:\ATP\Data\DC\.

2. Ir a la carpeta C:\ATP\EMTP\ y hacer doble clic en el archivo tpbig.exe –esto ejecutará el programa y permitirá al usuario interactuar con el mismo a través de su propio léxico–.

3. Escribir en el “promt” del EMTP-ATP la sentencia BOTH –esto hace que el programa “vuelque” los resultados en pantalla y en un archivo de salida–, y presionar ENTRAR. A continuación, escribir la ruta de acceso y el nombre del archivo a ejecutar –en este caso C:\ATP\Data\DC\DC1.dat– y presionar nuevamente ENTRAR. Finalmente, escribir –R y presionar ENTRAR. Ver Diapositiva 12.

Instalación del ATP Verificación de la Correcta Instalación del ATP

11

4. Una vez que el programa le devuelve el control al usuario, para finalizar, escribir STOP y presionar ENTRAR. Ver Diapositiva 12.

5. Para tener la certeza de que el programa ha corrido correctamente:

a) Verificar que en el directorio C:\ATP\EMTP\ se hayan generado los archivos auxiliares y temporarios

de la figura siguiente.

b) Verificar que en el directorio C:\ATP\Data\DC\ el programa haya generado un archivo de igual nombre al corrido pero extensión .lis. Abrirlo con cualquier editor de textos y verificar que el archivo de simulación ha corrido exitosamente.

Instalación del ATP Verificación de la Correcta Instalación del ATP

Archivos

generados por el

ATP en

C:\ATP\EMTP\

12

13

NOTA: Para sistemas operativos de 64 bits es posible que las versiones anteriores a la versión 5.7 del ATPDraw no puedan ser instaladas; pues “el instalador” de dichas versiones no es compatible con estos sistemas.

• Para la instalación del ATPDraw se deberán seguir los siguientes pasos:

1. Copiar el archivo ATPDraw58_Install.zip en la carpeta C:\ATP\TEMP\.

2. Descomprimir el contenido del archivo y ejecutar el archivo setup.exe.

3. Si el Control de Cuentas del sistema operativo pregunta si desea ejecutar el programa, responder que si y luego presionar el botón Next.

4. Ingresar el nombre del directorio donde se desea instalar el programa –en este caso C:\ATP\ATPDr58–.

5. Una vez ingresada la ruta de acceso de instalación del programa presionar el botón Next.

NOTA: El programa de instalación establece, por defecto, como directorio de instalación

C:\Programs Files(x86)\ATPDraw\. Esta ruta no se debe aceptar; pues es altamente recomendable que los nombres de las carpetas que describen la ruta de acceso del directorio donde se instalará el programa, no posean espacios en blanco y, en lo posible, tengan hasta un máximo de ocho caracteres.

Instalación del ATPDraw

14

6. Seleccionar el nombre de la carpeta del menú de inicio y presionar el botón Next.

7. Seleccionar las tareas adicionales de instalación y presionar el botón Next.

8. Presione el botón Install para instalar ATPDraw y, una vez finalizada la instalación presionar Finish para terminar.

9. Al ejecutarse el programa por primera vez éste preguntará si el usuario desea crear una serie de directorios que hasta el momento no existen. Responder afirmativamente en todo los casos.

10.Si todo ha transcurrido con normalidad el programa de instalación creará una carpeta con el Acceso Directo al Programa en el menú de Inicio.

11.Abrir el ATPDraw y abrir un archivo de simulación de ejemplo, por caso, Exa_1.acp.

NOTA: A partir de la versión 5.0 del ATPDraw, los archivos pasaron de tener una extensión .adp por otra tipo .acp, esto es para que los archivos .adp no se confundan con los homónimos de Access.

Instalación del ATPDraw

15

• Llegado a este punto se deberán hacer algunas modificaciones al ATPDraw para que este “corra” adecuadamente.

1. Ir al menú Tools\Options... y hacer clic sobre la pestaña Preference. Luego, presionar el botón Browse del campo Programs\ATP y seleccionar el archivo runATP_G.bat del directorio C:\ATP\ATPDr58\.

2. Presionar el botón Browse del campo Programs\Armafit y seleccionar el archivo arma.bat del directorio C:\ATP\ARMAFit\. El programa auxiliar ARMAFit se utiliza para poder construir el modelo TAKU NODA de líneas con parámetros dependientes de la frecuencia.

3. Presionar los botones Apply, Save y por último Ok.

4. Para guardar los cambios en el archivo ATPDraw.ini, ir al menú Tool y hacer clic sobre el botón Save Options.

NOTA: En el archivo runATP_G.bat verificar que se encuentren correctamente escritas, al menos, las siguientes líneas de sentencia:

@echo off

%gnudir%tpbig.exe both %1 s -r

Instalación del ATPDraw

En el archivo runATP_G.bat puede aparecer una línea

que intenta generar la variable de entorno GNUDIR que

ya fue generada (set gnudir=c:\atp\ …). Si es así, se debe

eliminar la línea.

16

5. Para verificar que el programa funciona correctamente, correr el archivo de simulación (ir al menú ATP y hacer clic sobre Run ATP) y abrir el archivo de salida .lis (ir al menú ATP y hacer clic sobre View LIS file).

6. Cerrar el programa y, en el caso de que se disponga de un nuevo “parche” para la versión 5.8 descomprimir el contenido del mismo C:\ATP\ATPDr58\. Con esto se remplazarán los archivos Atpdraw.exe y ATPDraw.scl (incluido cuando hay cambios en el Help del programa); quedando así instalada la versión 5.8pX.

Nota: En este caso realizar el procedimiento indicado con el “parche #1”

(archivo ATPDraw58p1.zip).

Instalación del ATPDraw

17

• Este programa no necesita de instalación alguna, solo se debe descomprimir el contenido del archivo PlotXY-July11.zip en la carpeta C:\ATP\PLOTXY\.

NOTA: Para más información sobre el programa PlotXY leer los archivos de ayuda que acompañan el mismo.

NOTA: A esta altura ya se puede eliminar la carpeta C:\ATP\TEMP\ y su contenido.

Instalación del PlotXY

18

• Se debe asociar el comando run Plot con algún post-procesador gráfico, en este caso, con el programa PlotXY (en particular con el archivo PlotXWin.exe), lo que permitirá al usuario abrir automáticamente el archivo .pl4 con el programa PlotXY desde el ATPDraw –abre el archivo .pl4 que lleva el mismo nombre del archivo de simulación .acp–. Para esto se deben seguir los siguientes pasos:

1. Ir al menú Tools\Options... y hacer clic sobre la pestaña Preference. Luego, presionar el botón Browse del campo Plot program y seleccionar el archivo PlotXWin.exe del directorio C:\ATP\PlotXY\.

2. Presionar los botones Apply, Save y por último Ok. Finalmente, para guardar los cambios en el archivo ATPDraw.ini, ir al menú Tool y hacer clic sobre el botón Save Options.

NOTA: Con las últimas versiones del PlotXY, es posible que, a la hora de intentar observar las salidas gráficas, éste intente abrir y se cierre automáticamente, sin dar ningún indicio acerca de cual es el problema, o no se puedan graficar las variables. En tal caso, se recomienda modificar la variable NEWPL4 del STARTUP como sigue: editar el archivo startup (ubicado en C:\ATP\EMTP\) y modificar la variable NEWPL4 (variable que controla el formato de escritura del archivo *.pl4) cambiando el 0, existente, por un 2 (ver diapositiva siguiente).

Personalizando el ATPDraw Asociar un Post-Procesador Gráfico al Comando run Plot

19

Modificar el valor de la variable según el post-procesador gráfico que se utiliza. Por caso, si se utilizan las

últimas versiones de PlotXY debe ser igual a 2, si se utiliza ATP Analyzer debe ser igual a 0. El programa

GTPPlot es capaz de leer cualquier formato, por lo que no es necesario realizar ninguna modificación..

20

• Este comando le permitirá al usuario seleccionar el archivo .atp (o .dat) que desea correr, el que no necesariamente se corresponde con la simulación que se está trabajando en el ATPDraw.

Los pasos a seguir para su creación son:

1. Ir al menú ATP\Edit Commands… y presionar el botón New e ingresar la siguiente información en los campos correspondientes:

NAME: Correr Archivo

COMMAND: C:\ATP\ATPDr58\runATP_G.bat (seleccionar el archivo presionando el botón Browse)

PARAMETER: File

2. Presionar el botón Update.

3. Finalmente, presionar el botón Exit y seleccionar Save Options del menú Tools y verificar el correcto funcionamiento de los comandos creados.

NOTA: De manera similar se pueden crear nuevos comandos para, por caso, abrir los archivos gráficos (.pl4) con otros post-procesadores.

Personalizando el ATPDraw Crear el Nuevo Comando Correr Archivo

21

• Si se tienen instalada una versión más antigua del ATPDraw no es necesario desinstalarla. Sólo deben seguirse los siguientes pasos:

1. Obtener el archivo “imagen” de la versión del ATPDraw que se desea instalar (por caso, ATPDraw58_Image.zip).

2. Descomprimir el contenido de este archivo en la carpeta donde se encuentra instalada la versión más antigua.

3. Verificar que el programa se actualizó correctamente (abrir el ATPDraw y chequear la versión en Help/About).

Actualización

22

• A continuación se darán algunas recomendaciones que ayudarán al usuario a minimizar errores y facilitar el uso de esta herramienta.

– Si bien el nombre del archivo de simulación .acp, del ATPDraw, puede tener más de 8 caracteres y poseer espacios en blanco, es altamente recomendable no utilizar espacios en blanco ni más de ocho caracteres al nombrar un archivo de simulación. En realidad el conflicto se crea con el EMTP-ATP, pues ATPDraw crea los archivos de simulación .atp con el mismo nombre que el archivo .acp.

– Crear un comando para ejecutar el programa GTPPlot. A saber:

1. Crear una carpeta C:\ATP\GTPPlot y descomprimir en la misma el contenido del archivo GTPPlot.zip.

2. Ir al menú ATP\Edit Commands… y presionar el botón New e ingresar la siguiente información en los campos correspondientes:

NAME: Correr GTPPlot

COMMAND: C:\ATP\GTPPlot\GTPPL32.exe (seleccionar el archivo presionando el botón Browse)

PARAMETER: Current PL4

3. Presionar el botón Update.

Recomendaciones Adicionales

23

4. Finalmente, presionar el botón Exit y seleccionar Save Options del menú Tools y verificar el correcto funcionamiento de los comandos creados.

– Instalar el programa WindSyn (utilizado para generar los parámetros de máquinas rotantes en el formato requerido por el EMTP-ATP a partir de los datos de ensayos y de placa). Para ello:

1.Crear la carpeta C:\ATP\WindSyn.

2.Descomprimir el contenido del archivo WindSynATPDraw_Install.zip en la carpeta C:\ATP\Temp.

3.Ejecutar Setup.exe e instalar el programa en la carpeta C:\ATP\WindSyn.

4.Luego, en el ATPDraw, ir al menú Tools\Options... y hacer clic sobre la pestaña Preference. Luego, presionar el botón Browse del campo Programs\Windsyn y seleccionar el archivo WindSynATPDraw.exe del directorio C:\ATP\WindSyn.

5.Presionar los botones Apply, Save y por último Ok.

6.Para guardar los cambios en el archivo ATPDraw.ini, ir al menú Tool y hacer clic sobre el botón Save Options.

Recomendaciones Adicionales

24

– Para utilizar el editor de su preferencia, caso contrario ATPDraw utilizará el editor built-in, se debe proceder como sigue:

1.En el ATPDraw, ir al menú Tools\Options... y hacer clic sobre la pestaña Preference. Luego, presionar el botón Browse del campo Programs\Text editor y seleccionar el archivo ejecutable del editor de su preferencia (por caso, Notepad++.exe(*)).

2.Presionar los botones Apply, Save y por último Ok.

3.Para guardar los cambios en el archivo ATPDraw.ini, ir al menú Tool y hacer clic sobre el botón Save Options.

(*) Notepad++ es un editor de código libre que puede descargarse desde el link http://notepad-plus-plus.org/.

Recomendaciones Adicionales