Anda di halaman 1dari 19

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

DEF  función NPL:


POO “RunNeplanScript()”
Visual “C++/MFC”

“NPL”
“MyApp.dll”
XML
aplicación
ejecutable por BBDD
NEPLAN
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
neplan@gers.com.co

• NEPLAN AG
www.neplan.ch
info@neplan.ch
Gracias
GERS S.A. Ingenieros Consultores
Dpto. NEPLAN
Tel. +(57 2) 489 7000
neplan@gers.com.co
www.gers.com.co