NPL - NEPLAN

NPL
NEPLAN
Programming
Library
NPL – NEPLAN Programming Library
<< Contenido >>
• Introducción
• Requerimientos (NPL) – Conceptos (C++)
• Aspectos del Desarrollo C++ y Funciones NPL
• Video ejemplo de una aplicación NPL
• Experiencia NPL
• Soporte NPL
NPL – NEPLAN Programming Library
<< Introducción >>
NPL
Biblioteca de programación que contiene funciones para
interactuar con “NEPLAN”, mediante aplicaciones
creadas por el usuario.
Aplicación tipo DLL
La aplicación a crear debe ser tipo “DLL” desarrollada en
lenguaje “C++/MFC”, empleando MS Visual Studio 2005.
Cada desarrollo debe integrar la biblioteca NPL.
NPL – NEPLAN Programming Library
NEPLAN
Ejecución de la
aplicación “DLL”
desarrollada por el
usuario.
“NPLExample.dll”
DLL: Dynamic Link Library
NPL – NEPLAN Programming Library
NPL – Funciones y Métodos
• Establecer/Modificar parámetros de elementos,
reguladores predefinidos, bloques de funciones
• Ejecutar análisis: LF, SC,VS, etc
• Capturar resultados: V, I, P, Q, etc.
• Eliminar/Adicionar elementos: datos y gráficos
• Opciones para Importar/Exportar
• Etc.
NPL – NEPLAN Programming Library
NPL - Beneficios
• Automatizar tareas / Ahorro de tiempo
• Crear nuevos módulos de cálculo a medida
• Acceso a todas las funciones y módulos de NEPLAN
C++/MFC - Beneficios
• Integración con otras tecnologías (XML, BBDD, etc.)
• Crear interfaces con otras aplicaciones
• Uso de técnicas de POO
(Programación Orientada a Objetos)
NPL – NEPLAN Programming Library
<< Requerimientos (NPL) – Conceptos (C++) >>
Software
•
•
•
•
NEPLAN + Licencia NPL
Archivos NPL (.LIB y .H)
Soft. leer PDF (Manual NPL)
Microsoft Visual Studio .NET 2005 (C++/MFC)
LIB: Static Library
MFC: Microsoft Foundation Classes
NPL – NEPLAN Programming Library
Hardware
• Requeridos para usar NEPLAN
• Memoria RAM 2GB (recomendado)
Usuario
• Referencia al manual NPL (PDF)
• Conocimientos en C++/MFC
• Conceptos en POO (deseable)
NPL – NEPLAN Programming Library
POO
DEF  función NPL:
“RunNeplanScript()”
Visual “C++/MFC”
“MyApp.dll”
aplicación
ejecutable por
NEPLAN
“NPL”
XML
BBDD
NPL – NEPLAN Programming Library
<< Desarrollo C++/MFC, Funciones NPL >>
Configurar Proyecto C++/MFC
• Microsoft Visual Studio .NET 2005
• Toda aplicación NPL requiere ser configurada
siguiendo las indicaciones del manual (NEPLAN AG)
Video ilustrativo paso a paso
• https://www.youtube.com/watch?v=Sn9unQ8KIq8
NPL – NEPLAN Programming Library
Función RunNeplanScript()
• Es invocada al ejecutar la aplicación “DLL”
desarrollada por el usuario (acceso)
• En ella se establece el código del usuario
• Se debe exportar explícitamente en el archivo
“DEF” del proyecto C++/MFC (VSTO 2005)
• Una vez finaliza su ejecución, se retorna el control
a NEPLAN
NPL – NEPLAN Programming Library
BOOL RunNeplanScript() {
• Usar directamente las funciones NPL
• Invocar otras funciones (del mismo proyecto)
• Invocar ventanas de dialogo (eventos)
• Características C++ y POO
…
return TRUE; // Fin -> retorna el control a NEPLAN
}
NPL – NEPLAN Programming Library
BOOL RunNeplanScript() {
unsigned long ElementID=0;
//Get the element ID of line "LINE1-3"
GetElementByName(_T("LINE"),_T("LINE1-3"), ElementID);
//Change the line length of line "LINE1-3" to 5
if (ElementID > 0)
SetParameterDouble(ElementID, _T("Length"), 5.0);
…
return TRUE;
}
NPL – NEPLAN Programming Library
BOOL RunNeplanScript() {
//Run load flow and refresh screen
RunAnalysisLF();
RefreshScreen();
//Messages
CString sMsg;
TCHAR wcMsg[300];
sMsg = _T("Run load flow with LINE1-3 length=5.0");
swprintf_s(wcMsg, _T("%s"), sMsg);
WriteMessageToLogFile(wcMsg);
…
return TRUE;
}
NPL – NEPLAN Programming Library
BOOL RunNeplanScript() {
CString sParam1=_T("Plosses-x1");
TCHAR wcParam1[300];
swprintf_s(wcParam1, _T("%s"), sParam1);
double dPar=0.0;
// Get parameter "P-loss" in "LINE1-3", NPL manual page 79
GetResultDouble(ElementID, wcParam1, dPar);
…
return TRUE;
}
NPL – NEPLAN Programming Library
<< Video ilustrativo NPL >>
Temas importantes
• Configuración del proyecto C++/MFC
• Código NPL ejemplo (Función RunNeplanScript)
• Ejecución de la aplicación DLL desde NEPLAN
Ver Video NPL
NPL – NEPLAN Programming Library
<< Experiencia NPL >>
GERS S.A. – NEPLAN AG, 2012
• Interfaz para importar datos (Datos y Gráficos) desde
ETAP (BBDD, XML)
• Interfaz para importar datos (Datos y Gráficos) desde
CYME PSAF (TXT, BBDD, XML)
• Cálculo de impedancias de secuencia en conductores
aislados
NPL – NEPLAN Programming Library
<< Soporte NPL >>
• GERS S.A. Ingenieros Consultores
www.gers.com.co
[email protected]
• NEPLAN AG
www.neplan.ch
[email protected]
Gracias
GERS S.A. Ingenieros Consultores
Dpto. NEPLAN
Tel. +(57 2) 489 7000
[email protected]
www.gers.com.co