com.powerdata.openpa.pwrflow

Class ACPowerCalc

java.lang.Object

com.powerdata.openpa.pwrflow.ACPowerCalc

public class ACPowerCalc
extends java.lang.Object

Calculate AC power and generate mismatches Two separate models exist for SVC's. If the droop is defined in the model (non-zero), then we follow that characteristic. If no droop is defined, then we don't solve the SVC and assume it is caluculated within the power flow. TODO: Track down device model for SVC and add documentation

Constructor Summary

Constructors

Constructor and Description
ACPowerCalc(PAModel model, java.util.Collection<FixedShuntListIfc<? extends FixedShunt>> shInSvc, Active1TData actvLoads, Active1TData actvGens) Constructs a new calculator object allowing overrides for injections.
ACPowerCalc(PAModel model, float sbase) Constructs a new calculator object from an entire model.

Method Summary

Modifier and Type	Method and Description
void	applyMismatch(float[] pmm, float[] qmm) Calculate mismatches on each bus, and apply to provided mismatch objects
void	calc(float[] vm, float[] va) Calculate flows and fixed shunts
java.util.List<ACBranchFlows>	getBranchFlows() return AC Branch calculator (one for each branch type in PAModel)
java.util.List<FixedShuntCalcList>	getFixedShuntCalc() return fixed shunt calculator (one for each list PAModel)
SVCList	getPvSvcList() Get the set of SVC's with no slope defined.
SVCCalcList	getSVCCalc() return SVC calculator for SVC's modeled with positive slope
static void	main(java.lang.String... args) Provide a main routine for testing and command-line to report branch flows and mismatches
static Active1TData	setupActiveGens(PAModel model, float sbase) Review the model for generats that are in-service and turning.
static Active1TData	setupActiveLoads(PAModel model, float sbase) Provide a standard interface to retrieve desired active and reactive power
static java.util.Collection<FixedShuntListIfc<? extends FixedShunt>>	setupFixedShunts(PAModel model) Review the model for fixed shunts that are in-service
void	updateResults() Update current results back into the OpenPA lists

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ACPowerCalc

public ACPowerCalc(PAModel model,
                   float sbase)
            throws PAModelException

Constructs a new calculator object from an entire model.

Parameters:

model - Power System model

bri - system bus topology

Throws:

PAModelException

ACPowerCalc

public ACPowerCalc(PAModel model,
                   java.util.Collection<FixedShuntListIfc<? extends FixedShunt>> shInSvc,
                   Active1TData actvLoads,
                   Active1TData actvGens)
            throws PAModelException

Constructs a new calculator object allowing overrides for injections.

For example, injections from generators might normally be taken from case data Gen.getP and Gen.getQ, but during a power flow, we might want the active power to be from a setpoint Gen.getPS, and not the case.

Parameters:

model - Current working power model

bri - Utility class to help manage different topologies

shInSvc - In-service shunts

actvLoads - In-service loads

actvGens - Generators that are in-service and running

Throws:

PAModelException

Method Detail

setupActiveLoads

public static Active1TData setupActiveLoads(PAModel model,
                                            float sbase)
                                     throws PAModelException

Provide a standard interface to retrieve desired active and reactive power

Parameters:

model - Current working power model

sbase - system base

Returns:

Standard interface for active and reactive power retrieval from the loads

Throws:

PAModelException

setupActiveGens

public static Active1TData setupActiveGens(PAModel model,
                                           float sbase)
                                    throws PAModelException

Review the model for generats that are in-service and turning.

Parameters:

bri - Utility to help manage different topologies

model - Current working power model

sbase - system base

Returns:

Standardized interface for active and reactive power retrieval from generators

Throws:

PAModelException

setupFixedShunts

public static java.util.Collection<FixedShuntListIfc<? extends FixedShunt>> setupFixedShunts(PAModel model)
                                                                                      throws PAModelException

Review the model for fixed shunts that are in-service

Parameters:

model - Current working power model

Returns:

Collection of fixed shunt lists that have filtered out any fixed shunts not in service

Throws:

PAModelException

getFixedShuntCalc

public java.util.List<FixedShuntCalcList> getFixedShuntCalc()

return fixed shunt calculator (one for each list PAModel)

getBranchFlows

public java.util.List<ACBranchFlows> getBranchFlows()

return AC Branch calculator (one for each branch type in PAModel)

getSVCCalc

public SVCCalcList getSVCCalc()

return SVC calculator for SVC's modeled with positive slope

getPvSvcList

public SVCList getPvSvcList()
                     throws PAModelException

Get the set of SVC's with no slope defined.

Returns:

SVC's with no slope (droop)

Throws:

PAModelException

calc

public void calc(float[] vm,
                 float[] va)
          throws PAModelException

Calculate flows and fixed shunts

Parameters:

vm - Voltage magnitude, per-unit on bus base KV

va - Voltage angle, radians

Throws:

PAModelException

applyMismatch

public void applyMismatch(float[] pmm,
                          float[] qmm)
                   throws PAModelException

Calculate mismatches on each bus, and apply to provided mismatch objects

Parameters:

pmm - active power bus mismatches

qmm - reactive power bus mismatches

Throws:

PAModelException

updateResults

public void updateResults()
                   throws PAModelException

Update current results back into the OpenPA lists

Throws:

PAModelException

main

public static void main(java.lang.String... args)
                 throws java.lang.Exception

Provide a main routine for testing and command-line to report branch flows and mismatches

Note about User-defined topology

The intent of user-defined topology is to allow topological groupings to be consistent when comparing external case data. This use case is specialized

For example, some external tools allow zero-impedance branches to be merged during a solution. However, the cutoff or other algorithm parameters may not clear, and any differences throw off the mismatches. To account for this, if a mapping of source-bus to merged-bus is available, then it can be used to compare values with a consistent topology.

To use this option, the --topologyparameter must specify UserDefined, and a CSV file with the mapping must be provided using the --userdeftop parameter. The CSV file must contain a column named "ID" that has the bus number for every bus in the system, and a "MappedBus" column that provides the mapping.

For example, A 5-bus system might have 2 user-defined topological nodes (at buses 2 and 4), the lists would look like:

ID	MappedBus
1	2
2	2
3	4
4	4
5	4

In this example, buses {1,2} are merged into bus 2, and {3,4,5} are merged into bus 4.

Parameters:

args -

--uri	Resource identifier for source data
--outdir	Location of output directory for results. This class generates a file named branches.csv by default for the branch flows, and mismatches.csv if that option is selected
--topology	Connectivity - full network connectivity including switches Single - single bus topology where switches are eliminated,buses tied by closed switches are merged UserDefined - See description above in method description. Requires --userdeftop
--userdeftop	Path to a CSV file that provides the bus-to-topological group mapping. See detail and example in method description.
--mismatches	Report mismatch and every flow & injection at every bus

Throws:

java.lang.Exception