oneliner/power flow automation with powerscript and olxapi - … · 2020. 5. 8. · aspen...

OneLiner/Power Flow Automation with

PowerScript and OlxAPIThanh Nguyen

ASPEN User Group Meeting Live Stream

May 5th 202010 – 11:30 AM US Pacific Day Time (GMT – 7)

About the Presenter

Thanh Nguyen

ASPEN Inc.

[email protected]

Enter questions for the presenter on www.aspeninc.com/may2020ug/slido

Thanh joined ASPEN in 1999 and has been in

charge of software development, user support

and training, and outreach works.

Thanh received his BS and MS degree in from

Moscow Power Engineering Institute in Russia,

and a PhD degree from the University of

Wisconsin at Milwaukee, all in power engineering.

Thanh is a member of IEEE

mailto:[email protected]

Automation & Scripting

[Some | a lot] of programming to

Get OneLiner/Power Flow works done faster and avoid

mistakes:

• Calculations and simulations

• Compliance and other types of reports

• Network model and relay data management tasks

Enable new kinds of study


What’s Available

The PowerScript engine

User-customizable features:

PowerCalc worksheet

Change file


ASPEN PowerScript Engine

Has read/write access to OneLiner/Power Flow

network and relay data

Lets you execute OneLiner and Power Flow

calculations and access simulation results

Programmable: Built-in scripting language (VBA-like)

Application programming interface (API) with the OlxAPI module

(OneLiner V14.7 and later).


Scripting Engine Operation

OneLiner/Power Flow: run PowerScript

programs

Tools | Scripting and Tools | User-defined

commands

Command line parametersoneline.exe -R ScriptFileName [ORLFileName] [-S]

(Online-help file section 8.7)

External applications: invoke the APIs in the

OlxAPI.DLL module


The Built-in Scripting Languge

Comes built-in with all OneLiner/Power Flow versions

Uses Enable Basic a VBA-like programming language

Has syntax highlighting, Interactive symbolic debugging,

Visual dialog editor

Reference is on-line:

www.aspeninc.com/man/ps14


OlxAPI Module

Shipped in V14.6: OlxAPI.DLL and supporting

components (Development build).

The APIs are callable in many programming platforms on

MS Windows systems: Python, Visual C++, C#, and

others.

Reference: Same as PowerScript, except all function

names are prefixed with OlxAPI


Applications

Access network and relay data in OLR files

Gateway to other enterprise systems

Custom fault simulation studies

Automatic relay setting calculation

Wide area relay coordination studies

Compliance studies

Many other


OneLiner/Power Flow Script Library


PowerScript and OlxAPI Dev

Open source PowerScript, Python, C++ apps

www.github.com/aspeninc


http://www.github/aspeninc

PowerScript and OlxAPI Dev

Open source PowerScript, Python, C++ apps

www.github/aspeninc

ASPEN Developer community email list:

[email protected]


http://www.github/aspeninc

OlxAPI Demo

Linez.py: Python app with OLR file data access

TestOlxAPI.exe: Visual C++ application


PowerCalc Worksheet

Embedded worksheet on the 1-line diagram

Excel like cell-based calculation and functions

ASPEN built-in functions:

Access network model and relay data

Drive the program solution engine

Access simulation results

User-managed template library


Typical PowerCalc Applications

Handy calculation tool

New 1-line diagram display dynamic content

Extend the program simulation capabilities


Network Model Access in PowerCalc

Step 1: Link cell to network model object

Step 2: Use object-linked cell as argument in function

calls placed in other cells.


PowerCalc Results on 1-line

PowerCal text on the 1-line consists of two parts:

Text from the Title edit box.

Text from an use-selected area of cells in the worksheet.

Text display color is user-definable.


ASPEN Change File

Can Modify, Add and Delete network components

and relay (data only, no graphic)

CHF text format specs are found in OneLiner help

Tool included: the Case comparison program

(differ.exe)

Coming in OneLiner V15: XML format, graphic data

support and 3-way diff.


Some Change File Applications

Team collaboration in model building

Model configurations management

Model management for future projects


Change File Application Demo

Create change file with add, delete and modify

Apply change file to different cases

Edit change file

Acquire graphic from another file


Thank You For Watching

Have Questions? Enter at:

www.aspeninc.com/may2020ug/slido


oneliner/power flow automation with powerscript and olxapi - … · 2020. 5. 8. · aspen...

Documents