General Functions

clear()

Clears the command window in the SAInt-GUI.

edit('expr')

Opens the property editor for the object specified in the input expression. Multiple objects of the same type can be specified. A multi-edit session will be activated in the property editor for the common properties.

time('expr')

Changes the display time on the map window. The expression for time could be one of the following (see example below):

path('startnode','node(1)',..,'node(n)','endnode')

The function selects the shortest path from the start node to the end node. The path also covers the intermediate nodes if specified in the input expression.

zoom('expr(1)',..,'expr(n)')

Zooms to the object(s), specified in the input expression, on the map window. It can also zoom to the object(s) based on a given condition (conditional expression). At least one expression is mandatory for the function to zoom in the active map view window.

It is possible to specify the name of the map view where to perform the zoom operation. Simply append to the object expression selecting the objects you want to zoon on with Map_View_Name.

mark/unmark('expr')

The function marks or unmarks the object specified in the expression in the active map window. The input expression can also be a conditional expression allowing to select objects on certain criteria. The two functions accept more than one expression. At least one expression is mandatory for the function to work.

find('expr')

Checks the existence of the specific object given in the input expression. It can also find the object based on a given condition (conditional expression). Returns the ObjectType.ObjectId in case of existence and Object not found in case of non-existence. At least one expression is mandatory for the function to work. Multiple expressions could be used as arguments.

isf('expr(1)','expr(2)', 'expr(time)', 'expr(3)')

Where:

Injection Shift Factors (ISFs), also known as Generation Shift Factors (GSFs), quantify how a change in power injection at one node and a corresponding withdrawal at a reference node affects the power flow on a specific branch. They represent the sensitivity of line flows to nodal injections, assuming a linear (DC) power flow model.

In contingency analysis, ISFs are used to quickly estimate how re-dispatching generation or changing load patterns will influence network loading. By knowing the ISFs, operators can assess which lines are most affected by power transfers and determine corrective actions to prevent overloads after an outage. ISFs also form the basis for calculating Line Outage Distribution Factors (LODFs), since both describe how power redistributes in response to changes in network conditions. This makes ISFs fundamental tools for reliability studies, congestion management, and real-time grid security assessment.

lodf('expr(1)','expr(2)', 'expr(time)')

Where:

Line Outage Distribution Factors (LODFs) are sensitivity coefficients used in power system analysis to estimate the change in power flow on transmission lines following the outage (disconnection) of another line, without performing a full power flow recalculation. Mathematically, LODF quantifies the fraction of the pre-outage flow on a failed line that will redistribute to other lines in the network.

In contingency analysis — an essential part of reliability assessment — LODFs enable rapid screening of potential outages ("N-1" or "N-k" contingencies) to identify lines that may become overloaded if another line fails. By using LODFs, system operators can efficiently predict post-contingency flows, evaluate network vulnerability, and plan remedial actions such as re-dispatching generation or adjusting topology.