powerflow/powerflow.h File Reference

Id
powerflow.h 1182 2008-12-22 22:08:36Z dchassin

Copyright (C) 2008 Battelle Memorial Institute More...

Go to the source code of this file.



enum  FREQMEASDEFAULT { FMM_NONE = 0, FMM_SIMPLE = 1, FMM_PLL = 2 }
enum  INRUSHINTMETHOD { IRM_NONE = 0, IRM_UNDEFINED = 1, IRM_TRAPEZOIDAL = 2, IRM_BACKEULER = 3 }
enum  LINESTATUS { LS_OPEN = 0, LS_CLOSED = 1 }
enum  MATRIXDUMPMETHOD { MD_NONE = 0, MD_ONCE = 1, MD_PERCALL = 2, MD_ALL = 3 }
GLOBAL EXT_LU_FXN_CALLS LUSolverFcns
 links to external LU solver functions
GLOBAL NR_SOLVER_STRUCT NR_powerflow
 Newton-Raphson solver pointer working variables - one per island detected.
GLOBAL char1024 market_price_name INIT ("current_market.clearing_price")
 Flag to enable mesh-based fault current calculations.
GLOBAL double deltatimestep_running INIT (-1.0)
 Lower PU voltage level to convert all loads to impedance.
GLOBAL INRUSHINTMETHOD
default_inrush_integration_method 
INIT (IRM_TRAPEZOIDAL)
 Integration method used for inrush calculations.
GLOBAL double
default_maximum_voltage_error 
INIT (1e-6)
 default sync voltage convergence limit [puV]
GLOBAL complex fault_Z INIT (complex(1e-6, 0))
 fault impedance
GLOBAL double warning_voltageangle INIT (2.0)
 voltage angle (over link) above which a warning is posted
GLOBAL double warning_overvoltage INIT (1.2)
 voltage magnitude (per unit) above which a warning is posted
GLOBAL double warning_undervoltage INIT (0.8)
 voltage magnitude (per unit) below which a warning is posted
GLOBAL double warning_overfrequency INIT (65.0)
 frequency above which a warning is posted
GLOBAL double
warning_underfrequency 
INIT (55.0)
 frequency below which a warning is posted
GLOBAL double primary_voltage_ratio INIT (60.0)
 primary voltage ratio (
GLOBAL int64
NR_delta_iteration_limit 
INIT (10)
 Newton-Raphson iteration limit (per deltamode timestep).
GLOBAL TIMESTAMP NR_retval INIT (TS_NEVER)
 Newton-Raphson current return value - if t0 objects know we aren't going anywhere.
GLOBAL int NR_superLU_procs INIT (1)
 Newton-Raphson related - superLU MT processor count to request - separate from thread_count.
GLOBAL int64 NR_iteration_limit INIT (500)
 Newton-Raphson iteration limit (per GridLAB-D iteration).
GLOBAL int NR_curr_bus INIT (-1)
 Newton-Raphson current bus indicator - used to populate NR_busdata.
GLOBAL BUSDATA *NR_busdata INIT (NULL)
 Newton-Raphson bus data pointer array.
GLOBAL unsigned int NR_bus_count INIT (0)
 Newton-Raphson bus count - used for determining size of bus vector.
GLOBAL MATRIXSOLVERMETHOD
matrix_solver_method 
INIT (MM_SUPERLU)
 Newton-Raphson uses superLU as the default solver.
GLOBAL bool use_link_limits INIT (true)
 Flag to include line/transformer ratings and provide a warning if exceeded.
GLOBAL bool NRMatReferences INIT (false)
 Flag to indicate if the decoding information for the matrix is dumped - row/col to bus.
GLOBAL MATRIXDUMPMETHOD
NRMatDumpMethod 
INIT (MD_NONE)
 NR-based matrix output method.
GLOBAL SOLVERMETHOD solver_method INIT (SM_FBS)
 powerflow solver methodology
GLOBAL char256 LUSolverName INIT ("")
 filename for external LU solver

Detailed Description

Id
powerflow.h 1182 2008-12-22 22:08:36Z dchassin

Copyright (C) 2008 Battelle Memorial Institute

Id
powerflow_object.h 1182 2008-12-22 22:08:36Z dchassin

Copyright (C) 2008 Battelle Memorial Institute

Definition in file powerflow.h.


Enumeration Type Documentation

Enumerator:
FMM_NONE 

No default.

FMM_SIMPLE 

Objects default to simple frequency measurement method.

FMM_PLL 

Objects default to the PLL-based frequency measurement method.

Definition at line 55 of file powerflow.h.

Enumerator:
IRM_NONE 

Flag as no integration method.

IRM_UNDEFINED 

Basically a flag to indicate "use the default" - specific object-level usage.

IRM_TRAPEZOIDAL 

Use the trapezoidal implementaiton.

IRM_BACKEULER 

Use the backward-Euler implementation.

Definition at line 48 of file powerflow.h.

enum LINESTATUS
Enumerator:
LS_OPEN 

defines that that link is open

LS_CLOSED 

defines that that link is closed

Definition at line 43 of file powerflow.h.

Enumerator:
MD_NONE 

No matrix dump desired.

MD_ONCE 

Single matrix dump desired.

MD_PERCALL 

Matrix dump every call desired.

MD_ALL 

Matrix dump on every iteration desired.

Definition at line 36 of file powerflow.h.


Function Documentation

GLOBAL double default_resistance INIT ( 1e-  6  ) 

default sync voltage convergence limit [puV]

sets the default resistance for safety devices

GLOBAL complex ground_Z INIT ( complex(1e-6, 0)   ) 

fault impedance

ground impedance

GLOBAL double impedance_conversion_low_pu INIT ( 0.  8  ) 

voltage magnitude (per unit) below which a warning is posted

default power convergence limit for multirun

topological degree factor

GLOBAL double current_frequency INIT ( 60.  0  ) 

primary voltage ratio (

Current operating frequency of the system - used by deltamode stuff.

nomimal operating frequencty

Todo:
explain primary_voltage_ratio in powerflow (ticket #131)
GLOBAL int pwr_object_current INIT ( 1  ) 

Newton-Raphson current bus indicator - used to populate NR_busdata.

Newton-Raphson swing bus index reference in NR_busdata.

Newton-Raphson current branch indicator - used to populate NR_branchdata.

GLOBAL FUNCTIONADDR *post_delta_functions INIT ( NULL   ) 

Newton-Raphson bus data pointer array.

fault_check object of the system

restoration object of the system

Newton-Raphson swing bus.

Newton-Raphson branch data pointer array.

GLOBAL int pwr_object_count INIT (  ) 

Newton-Raphson bus count - used for determining size of bus vector.

Newton-Raphson solver island count (from fault_check) - determines the array size of NR_powerflow.

Newton-Raphson branch count - used for determining size of branch vector.

GLOBAL bool NR_admit_change INIT ( true   ) 

Flag to include line/transformer ratings and provide a warning if exceeded.

Newton-Raphson admittance matrix change detector - used to prevent complete recalculation of admittance at every timestep.

Newton-Raphson first run indicator - used by deltamode functionality for initialization powerflow.

GLOBAL bool all_house_delta INIT ( false   ) 

Flag to indicate if the decoding information for the matrix is dumped - row/col to bus.

Value of the current deltamode simulation - used for integration method in in-rush.

Flag to enable in-rush calculations in deltamode.

Flag to enable frequency-based updates of impedance values, namely loads and lines.

Whether a generator has designated itself "keeper of frequency" -- temporary deltamode override.

Mode designator for fault_check -- overrides errors and prevents powerflow -- meant for debug.

flag to enable voltage control source requirement

flag to enable dumping matrix calculations as they occur

Forward-Back Sweep swing assignment variable.

Newton-Raphson global flag to indicate if the solver is working -- mostly to prevent island redetection if it is mid-array.

Newton-Raphson multiple islands - determine how individual island failure may determined.

Flag to include line capacitance quantities.

GLOBAL char256 MDFileName INIT ( ""   ) 

filename for external LU solver

filename for matrix dump


GridLAB-D™ Version 4.1
An open-source smart grid simulator created by PNNL for the US Department of Energy Office of Electricity