Manual de Usuario

Aplicación Tipo ERP

Desarrollo de aplicación de manejo y
centralización de información para el desarrollo de
documentos de ingenierı́a

DATA-INST.pyw
Realizaciones de Listados de Circuitos, Entradas y
Salidas, Diagramas de Lazo y Segmento, de forma
Automática

Autor: Jorge Zolorza Vidal.

Fecha: 03 de Enero del 2023.
Índice
1. Requisitos de instalación de IT Service 1
1.1. Instalación de Python . . . . . . . . . . . . . . . . . . . . . . 1
1.2. Instalación pip install . . . . . . . . . . . . . . . . . . . . . . 1

2. Instalación de aplicación y documentación necesaria 1

3. Uso de aplicación 2
3.1. Descripción de opciones . . . . . . . . . . . . . . . . . . . . . 2
3.2. Ingreso de Información . . . . . . . . . . . . . . . . . . . . . . 3
3.3. Manejo de la información Ingresada . . . . . . . . . . . . . . 5
3.4. Salidas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.4.1. Generación de Planos Autocad . . . . . . . . . . . . . 6
3.4.2. Exportar Información a Excel . . . . . . . . . . . . . . 8

4. Revisión de opciones previas Administradores de Aplica-

ción 9
4.1. Hoja FORMATO-CABLE . . . . . . . . . . . . . . . . . . . . 9
4.2. Edición de Formato de TAG en cables . . . . . . . . . . . . . 10
4.3. Listado de instrumentos . . . . . . . . . . . . . . . . . . . . . 12
4.4. Listado de circuitos . . . . . . . . . . . . . . . . . . . . . . . . 13

5. Documentos Relacionados 13
1. Requisitos de instalación de IT Service
En esta sección se presentan los requisitos de instalación de software y
librerı́as para poder hacer uso del programa ”DATA-INST.pyw”.
Las siguientes subsecciones dividen las instalaciones a realizar por IT
Service:

1.1. Instalación de Python

Solicitar a través del Software Center la instalación de la aplicación
Python en su versión mas resiente mayor a (v.3.8)

1.2. Instalación pip install

Una vez instalado Python se requiere instalar las siguientes librerı́as
mediante comandos pip install mediante CMD, esto debe ser realizado por
IT Service, puede hacer uso del siguiente link con la sucesión de pasos para
realizar pip install a las siguientes librerı́as:

pip install pywin32

pip install pandas

pip install numpy

pip install openpyxl

2. Instalación de aplicación y documentación ne-

cesaria
La siguiente sección describe la serie de pasos para instalar la aplicación
en su computador a través de una carpeta compartida en ONE-DRIVE,
ubicada en el directorio:,

1. Seleccionar Carpeta compartida DATA-INST y hacer click en Add

shortcut to My files, de esta manera el directorio compartido con
todos sus archivos estarán presentes en una ruta de su computador y
compartirá los permisos de edición.

2. Una vez la carpeta se encuentre en su directorio de ONE-DRIVE

esta no debe ser removida de tal directorio.

1
 3. Abrir los documentos ANA1.dwg y PROYECTO.xlsx sin editar-
los, una vez abiertos cerrar sin realizar cambios. para hacer uso de la
aplicación los archivos deben estar cerrados

4. El documento ANA1.dwg es un documento que no se debe editar.

3. Uso de aplicación
3.1. Descripción de opciones
Una vez comprobado los pasos de la sección anterior, es posible abrir la
aplicación haciendo doble click sobre el archivo FINAL ACAD v12 , lo
cual abre la ventana mostrada en la Figura 1:

Figura 1: Página de Inicio

Esta ventana posee dos opciones:

2 y 3 HILOS:
Esta opción abre el menú para instrumentos analógicos de 2 y 3 Hilos,
la cual solicita los parámetros mostrados en la Figura 2, para poder
generar la información requerida para generar, diagramas y listados.

2
 Figura 2: Menú de opción 2 y 3 HILOS

4 HILOS:
Esta opción abre el menú para instrumentos analógicos de 4 Hilos,
la cual solicita los parámetros mostrados en la Figura 3, para poder
generar la información requerida para generar, diagramas y listados
de los instrumentos análogos de 4 hilos.

Figura 3: Menú de opción 4 HILOS

Es posible pasar de un menú a otro indistintamente presionado los botones.

3.2. Ingreso de Información

El ingreso de la información a la aplicación se realiza mediante los campos
mostrados a continuación, como ejemplo el menú de 2 y 3 HILOS,

3
 Figura 4: Campos de información solicitada

En Rojo se tienen campos de información con desplegables donde tendrá

que seleccionar una opción dentro de ese desplegable como se muestra en la
Figura 5. Mientras que los campos marcados en Azul son campos de ingreso
manual de texto.

Figura 5: Menú desplegable

Una vez todos los campos de información sean completados por el usua-
rio, y solo si todos están completos podrá presionar el botón AÑADIR
DATO, lo cual se vera reflejado en una Tabla justo abajo del menú princi-
pal esto se puede ver en la Figura 6

4
 Figura 6: Información completa y añadida

Será responsabilidad del usuario los siguientes items:

El tipo de instrumento seleccionado debe ser concordante con la opción

seleccionada de 4 hilos o 2 y 3 hilos, según corresponda (ejemplo: FIT
es un instrumento de 4 Hilos).

LOS INSTRUMENTOS DEBEN SER AÑADIDOS EN OR-

DEN SEGÚN EL NUMERO DE CANAL QUE OCUPEN.

La selección de los tipos de cables y sus calibres sean concordantes con

el servicio que prestan.

No ocupar Canales de tarjetas ya ocupadas (a futuro se planea poner

una alarma).

WBS debe ser el mismo que del TAG del instrumento.

En general la concordancia de los datos ingresados con el instrumento

es responsabilidad del usuario.

3.3. Manejo de la información Ingresada

Una vez el usuario haya ingresado información a la aplicación esta puede
ser eliminada si ası́ se requiere, esto se realiza haciendo doble click sobre la
fila que se desea eliminar, luego se abrirá una cuadro preguntando si esta
seguro de eliminar, esto puede ser visto en la Figura 7.

5
 Figura 7: Eliminar información añadida

Finalmente para borrar los campos que posean información que no se

desea utilizar se utiliza la opción LIMPIAR DATOS

3.4. Salidas
La aplicación en su versión actual posee dos salidas, dadas por las opcio-
nes GENERAR PLANO y EXPORTAR A EXCEL, las cuales pueden
ser utilizadas una vez exista información añadida en la Tabla, si la Tabla se
encuentra vacı́a NO SE DEBEN PRESIONAR DADAS OPCIONES
puesto no existen datos que trabajar lo cual conllevara a errores en la apli-
cación. Las opciones de salida son descritas en las siguientes subsecciones.

3.4.1. Generación de Planos Autocad

Para la generación de planos automáticos, se debe tener abierto el pro-
grama Autocad, vacı́o en el espacio Model, preferentemente en versión ingles:

6
 Figura 8: Autocad vacı́o en espacio Model

Luego al presionar se debe presionar el botón GENERAR PLANO

Figura 9: Botón generar plano

De esta manera se generara los dibujos dentro del espacio Model con
todos los tags, servicios, protecciones, tarjetas, canales asignados.

7
 Figura 10: Diagrama generado

Luego el usuario podrá copiar, reordenar o disponer como estime conve-

niente. Si se desea generar nuevamente los diagramas, es conveniente abrir
un nuevo archivo autocad, o bien vaciar el espacio Model y Purgar toda
layer o Bloque para que no exista ningún error de referencia externa.

3.4.2. Exportar Información a Excel

Para exportar la información generada a el archivo Excel, solo se debe
presionar el botón EXPORTAR A EXCEL.

Figura 11: Exportar información a excel

Esto se vera reflejado en el archivo Excel PROYECTO.xlsx que se

8
encuentra en el mismo directorio compartido.

Figura 12: Información exportada

De esta manera se genera el listado de circuitos de las entradas análogas.

En el caso de que sea ingresado un instrumento que ya exista este sera
reemplazado por la nueva asignación, en cualquier caso es labor del usuario
procurar no añadir información que ya exista, a no ser que esta sea errada.

4. Revisión de opciones previas Administradores

de Aplicación
Las siguientes definiciones, opciones y detalles deben ser conocidas por
usuarios y administradores de aplicación, pero las labores de edición son
responsabilidad principal del administrador de aplicación.
El documento PROYECTO.xlsx contenido en el directorio compartido
es un archivo semi-editable, en el cual se debe respetar lo siguiente:
1. No se debe cambiar el orden de las hojas ya existentes.

2. El archivo no debe cambiar de nombre o de directorio.

3. La primera y segunda fila de la hoja LISTADO-CIRCUITOS no

debe ser editada.
Respetando lo anterior, el documento PROYECTO.xlsx puede ser edita-
do, en este esta permitido: añadir hojas y disponer libremente de su conte-
nido, sin intervenir los puntos anteriores.

4.1. Hoja FORMATO-CABLE

La hoja FORMATO-CABLE es un archivo semi editable, la cual cuen-
ta con una lista de parámetros que inicia desde la columna J a la N, en esta,
se declaran parámetros y sus asignaciones:

9
 Figura 13: Hoja FORMATO-CABLE

Por ejemplo: existen dos parámetros llamados AA (col:J) que son del
tipo ÁREA(col:K) en los cuales se definen 3632(col:L) y 3616(col:L), de
esta misma manera se pueden añadir en ese formato mas Áreas (WBS) de
un proyecto, (estas luego las reconocerá la aplicación).
La columna L corresponde a una columna de asignación, donde por ejem-
plo al calibre 23AWG se le asigna 23W, es por esto que la la columna
L es completamente editable dependiendo del requerimiento del proyec-
to. Si el proyecto no requiere de su definición el campo queda en
VACÍO, ası́ mismo pueden editarse todas las asignaciones contenidas en la
tabla.
Todos los detalles anteriores deben proceder de los estándares solicitados
por cada proyecto.

4.2. Edición de Formato de TAG en cables

En la Hoja FORMATO-CABLE se encuentra una sección comprendida
en las Filas 1 y 2 desde la columna A hasta la I esto puede verse en la
Figura 14

Figura 14: Hoja FORMATO-TAG

Este campo es el encargado de designar el formato de TAG deseado

en donde el carácter ürepresenta el guion del TAG para el caso en que se
muestra en la Figura 14 este representa un TAG de la siguiente forma:

AA − BBEE − CCDDF F GG

10
en cual posee 7 campos diferentes correspondientes a AA, BB, CC, DD,
EE, F F y GG, el Usuario podrı́a reordenar los campos de las formas que
estime conveniente, para inhabilitar un campo basta con dejarlo vació en la
de asignación, vista en la subsección anterior.
Los campos poseen las siguientes definiciones:

AA es el campo que representa siempre al WBS o Área de un pro-

yecto (es un campo editable en asignación pero este siempre debe
corresponder a Área osea el usuario es libre de asignar o quitar áreas
al campo AA). Este es un campo que siempre debe estar presente.

EE es el campo que representa el TAG del dispositivo (al cual perte-

nece el TAG del circuito) y este no es asignable por tabla. Este es un
campo que siempre debe estar presente.

BB es un campo de especialidad, puede ser editable por tabla, de no

ser necesario se debe dejar vacı́o en tabla.

CC es un campo que representa el calibre del cable, de no ser necesario

se debe dejar vacı́o en tabla.

DD es un campo que representa el tipo de cable si este pertenece

a ’Control’, ’Fuerza’, ’Instrumentación’, sus asignaciones pueden ser
cambiadas por Tabla, de no ser necesario se debe dejar vacı́o en tabla.

Los campos F F y GG son campos sin asignación puestos para futuras

asignaciones de ser necesarios.

Los campos son directamente alterables en orden, esto provocara direc-

tamente que el TAG que genere la Aplicación cambie.
Se presenta un ejemplo si se desea formar otra forma de TAG del si-
guiente tipo:
3551 − F IT − 801 − J01
donde 3551 representa el área, F IT − 801 representa al instrumento con su
numeral y J01 representa a cualquier cable de instrumentación.
Para lograr ese TAG se deben realizar los siguientes cambios:

1. Añadir en la columna L el área 3551 asignado a un campo AA

Figura 15: FORMATO-TAG EJEMPLO

11
 2. Añadir en la columna L la palabra J01 asignado a un campo DD a
todos los cables del tipo instrumentación alli definidos, puede definir
nuevos tipos de cables de instrumentación si ası́ lo desea

Figura 16: FORMATO-TAG EJEMPLO

3. Dejar en vacı́o las celdas en la columna L de los campos que no se

utilicen.
4. Redefinir el formato de los campos en el orden deseado en este caso:
AA − EE − DD
Esto se logra de la siguiente manera cambiando el Excel:

Figura 17: FORMATO-TAG EJEMPLO

Dado que los campos CC, BB, F F y GG fueron asignados como

vacı́os en el Paso 3, no aportan nada al TAG y es como si solo tuviese
3 campos reales.

4.3. Listado de instrumentos

Para uso de la aplicación el Administrador de la aplicación debe definir
previamente el listado de instrumentos en la Hoja LISTADO-INSTRUMENTOS
de la siguiente manera:

Figura 18: definición del listado de instrumentos

Importante: La primera fila no debe ser editada

12
4.4. Listado de circuitos
La hoja LISTADO-CIRCUITOS corresponde a una salida de la apli-
cación, Importante: Las primeras 2 filas no deben ser editadas, res-
petando lo anterior el usuario puede añadir circuitos manualmente, esto no
interfiere con la aplicación.

Figura 19: definición del listado de circuitos

5. Documentos Relacionados
Esta Aplicación fue Basada en Python con su librerı́a Tkinter, uniéndo-
lo a la API de AUTOCAD mediante el uso de la librerı́a Pywin32,
la presente aplicación corresponde a su 12ava versión.

El Trabajo de datos con Excel se realiza mediante la librerı́a pandas

y la edición de los archivos existentes mediante el uso de la librerı́a
openpyxl

El formato de TAG de cable utilizado para el ejemplo ya inserto en la

Aplicación compartida corresponde al Formato CODELCO de PLAN
DE EJECUCIÓN BIM (PEB) utilizado en la ODS11- INGE-
NIERÍA COMPLEMENTARIA Y DE FACTIBILIDAD, ADICIÓN
TEMPRANA DE CLORURO EN LIXIVIACIÓN DRT, CÓDIGO:
4600017310-0000-PLNMD-00001

De momento solo se ha programado el uso de TARJETAS MODICOM,

bloques que fueron obtenidos desde el documento: Diagramas de Lazos,
Trans de Flujo 03616 y Analizador Cloruro 03616-AIT-102, Trans. de
Nivel 03616-LIT-103 y Trans. de Presión 03616-PIT-103, CÓDIGO:
4502053483-03616-204AT-00005 Q.

Para el formato del listado de instrumentos fue utilizado el documen-

to: LISTADO DE INSTRUMENTOS, CÓDIGO: 4502053483-03000-
LSTAT-00001 P DEL PROYECTO ODS11 - INGENIERÍA COM-
PLEMENTARIA Y DE FACTIBILIDAD, ADICIÓN TEMPRANA
DE CLORURO EN LIXIVIACIÓN DRT.

13
Para el formato del listado de circuitos fue utilizado el documen-
to: LISTADO DE CIRCUITOS, CÓDIGO: 4502053483-03000-LSTAT-
00005 P DEL PROYECTO ODS11 - INGENIERÍA COMPLEMEN-
TARIA Y DE FACTIBILIDAD, ADICIÓN TEMPRANA DE CLO-
RURO EN LIXIVIACIÓN DRT.

14