com.interpss.core.funcImpl

Class CoreUtilFunc

java.lang.Object

com.interpss.core.funcImpl.CoreUtilFunc

public class CoreUtilFunc
extends java.lang.Object

core utility functions

Constructor Summary

Constructors

Constructor and Description
CoreUtilFunc()

Method Summary

Modifier and Type	Method and Description
static org.apache.commons.math3.complex.Complex	calExpLoad(double loadP0, double loadQ0, double volt, double expP, double expQ) Calculate exponential load
static double	calPFactor(double p, double q) calculate power factor
static double	calQ(double p, double pf, java.lang.String unit) Calculate Q based on P and PFactor
static double	calQ(double p, double pf, Unit.UnitType unit) Calculate Q based on P and PFactor
static double	calRatingKVA(double rating, Unit.UnitType ratingUnit, double pf, Unit.UnitType pfUnit) Calculate the KVA rating based on input rating and pfactor.
static org.apache.commons.math3.complex.Complex	calUitilityZ0PU(double kva1P, double x_r1P, double baseKva, org.apache.commons.math3.complex.Complex z1) Calculate utility bus z0 based on its 1-phase Sc Mva and X/r
static org.apache.commons.math3.complex.Complex	calUitilityZ1PU(double kva3P, double x_r3P, double baseKva) Calculate utility bus z1 based on its 3-phase Sc Mva and X/r
static org.apache.commons.math3.complex.Complex	calZPU(double x, double r, double x_r, Unit.UnitType unit, double baseKVA, double rating_kva, double baseV, double ratedV) Calculate PU z on the baseKva base
static long[]	getAreaNumberAry(java.util.List<Area> areaList) get araa number array from a list of area objects
static java.lang.String[]	getBranchIdArray(Network<?,?> net) Get branch ids into an array
static java.util.Set<java.lang.String>	getBranchIdSet(Network<?,?> net, int flag) Get branch ids with bus.intFlag == flag
static java.lang.String[]	getBusIdArray(Network<?,?> net) Get bus ids into an array
static java.util.Set<java.lang.String>	getBusIdSet(Network<?,?> net, int flag) Get bus ids with bus.intFlag == flag
static int	getBusSortNumber(java.lang.String busId, Network<?,?> net) Get bus sort number from bus id
static double	getMvaFlowCalculated(AclfBranch branch, boolean onFromSide, boolean flowFrom2To, Unit.UnitType unit) Calculate branch q at the specified side (onFromSide) and in specified direction (flowFrom2To)
static java.util.List<Branch>	getParallelBranchList(Branch b) calculate parallel branch list between branch.fromBus and branch.toBus.
static java.util.List<Branch>	getParallelBranchList(Bus b1, Bus b2) calculate parallel branch list between the two buses.
static long[]	getZoneNumberAry(java.util.List<Zone> zoneList) get zone number array from a list of zone objects
static boolean	isParallelBranch(Branch b1, Branch b2) check if the two branches are connected to the fromBus and toBus
static int	noParallelBranches(Branch b) calculate no of parallel branches between branch.fromBus and branch.toBus
static int	noParallelBranches(Bus b1, Bus b2) calculate no of parallel branches between the two buses.
static void	setBranchFaultData(AcscBranchFault fault, SimpleFaultCode type, double distance, double rLG, double xLG, double rLL, double xLL) Set AcscBranchFault object data
static void	setBusFaultData(AcscBusFault fault, SimpleFaultCode type, double rLG, double xLG, double rLL, double xLL) Set AcscBusFault object data
static org.apache.commons.math3.complex.Complex	yXfrGround(AcscBranch branch, boolean iAtFromSide) Compute zero sequence Xfr node to ground y.

Methods inherited from class java.lang.Object

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

Constructor Detail

CoreUtilFunc

public CoreUtilFunc()

Method Detail

isParallelBranch

public static boolean isParallelBranch(Branch b1,
                                       Branch b2)

check if the two branches are connected to the fromBus and toBus

Parameters:

b1 -

b2 -

Returns:

getParallelBranchList

public static java.util.List<Branch> getParallelBranchList(Bus b1,
                                                           Bus b2)

calculate parallel branch list between the two buses.

Parameters:

b1 -

b2 -

Returns:

getParallelBranchList

public static java.util.List<Branch> getParallelBranchList(Branch b)

calculate parallel branch list between branch.fromBus and branch.toBus.

Parameters:

b1 -

b2 -

Returns:

noParallelBranches

public static int noParallelBranches(Bus b1,
                                     Bus b2)

calculate no of parallel branches between the two buses.

Parameters:

b1 -

b2 -

Returns:

noParallelBranches

public static int noParallelBranches(Branch b)

calculate no of parallel branches between branch.fromBus and branch.toBus

Parameters:

b -

Returns:

getMvaFlowCalculated

public static double getMvaFlowCalculated(AclfBranch branch,
                                          boolean onFromSide,
                                          boolean flowFrom2To,
                                          Unit.UnitType unit)

Calculate branch q at the specified side (onFromSide) and in specified direction (flowFrom2To)

Parameters:

branch -

onFromSide -

flowFrom2To -

unit -

Returns:

the branch q

calUitilityZ1PU

public static org.apache.commons.math3.complex.Complex calUitilityZ1PU(double kva3P,
                                                                       double x_r3P,
                                                                       double baseKva)

Calculate utility bus z1 based on its 3-phase Sc Mva and X/r

Parameters:

kva3P - 3-phase sc mva in kav unit

x_r3P - 3-phase sc x/r

baseKva - system base kava

Returns:

z1 in pu

calUitilityZ0PU

public static org.apache.commons.math3.complex.Complex calUitilityZ0PU(double kva1P,
                                                                       double x_r1P,
                                                                       double baseKva,
                                                                       org.apache.commons.math3.complex.Complex z1)

Calculate utility bus z0 based on its 1-phase Sc Mva and X/r

Parameters:

kva1P - 1-phase sc mva in kav unit

x_r1P - 1-phase sc x/r

baseKva - system base kava

z1 - z1 of the bus

Returns:

z0 in pu

yXfrGround

public static org.apache.commons.math3.complex.Complex yXfrGround(AcscBranch branch,
                                                                  boolean iAtFromSide)
                                                           throws InterpssException

Compute zero sequence Xfr node to ground y. Assumptions - j side is Delta connected - i side is Wye connected

Parameters:

branch - the xfr branch object

zGround_i -

gtype_i -

Returns:

y

Throws:

InterpssException

setBusFaultData

public static void setBusFaultData(AcscBusFault fault,
                                   SimpleFaultCode type,
                                   double rLG,
                                   double xLG,
                                   double rLL,
                                   double xLL)

Set AcscBusFault object data

Parameters:

fault - the fault object

type - fault type

rLG - Line-ground r

xLG - Line-ground x

rLL - Line-line r

xLL - Line-line x

setBranchFaultData

public static void setBranchFaultData(AcscBranchFault fault,
                                      SimpleFaultCode type,
                                      double distance,
                                      double rLG,
                                      double xLG,
                                      double rLL,
                                      double xLL)

Set AcscBranchFault object data

Parameters:

fault - the fault object

type - fault type

distance - fault distance in pu from the FromBus

rLG - Line-ground r

xLG - Line-ground x

rLL - Line-line r

xLL - Line-line x

calExpLoad

public static org.apache.commons.math3.complex.Complex calExpLoad(double loadP0,
                                                                  double loadQ0,
                                                                  double volt,
                                                                  double expP,
                                                                  double expQ)

Calculate exponential load

Parameters:

load0 - load at v=1.0

volt - bus voltage

expP - real power exponential

expQ - reactive power exponential

Returns:

load at the bus voltage

getBusSortNumber

public static int getBusSortNumber(java.lang.String busId,
                                   Network<?,?> net)

Get bus sort number from bus id

Parameters:

busId, - the bus object

Returns:

sort number

getBusIdArray

public static java.lang.String[] getBusIdArray(Network<?,?> net)

Get bus ids into an array

Returns:

the bus id array

getBusIdSet

public static java.util.Set<java.lang.String> getBusIdSet(Network<?,?> net,
                                                          int flag)

Get bus ids with bus.intFlag == flag

Parameters:

flag -

Returns:

the bus id set

getBranchIdArray

public static java.lang.String[] getBranchIdArray(Network<?,?> net)

Get branch ids into an array

Returns:

the branch id array

getBranchIdSet

public static java.util.Set<java.lang.String> getBranchIdSet(Network<?,?> net,
                                                             int flag)

Get branch ids with bus.intFlag == flag

Parameters:

flag -

Returns:

the branch id set

calRatingKVA

public static double calRatingKVA(double rating,
                                  Unit.UnitType ratingUnit,
                                  double pf,
                                  Unit.UnitType pfUnit)

Calculate the KVA rating based on input rating and pfactor.

Parameters:

rating - input rating

ratingUnit - the rating unit

pf - power factor

pfUnit - power factor unit

Returns:

the calculated rating

calZPU

public static org.apache.commons.math3.complex.Complex calZPU(double x,
                                                              double r,
                                                              double x_r,
                                                              Unit.UnitType unit,
                                                              double baseKVA,
                                                              double rating_kva,
                                                              double baseV,
                                                              double ratedV)

Calculate PU z on the baseKva base

Parameters:

x - x on the rating base

r - r on the rating base

x_r - x/r ratio

unit - input x unit (PU or %)

baseKVA - base KVE

rating_kva - rating

Returns:

the calculated zpu

calQ

public static double calQ(double p,
                          double pf,
                          java.lang.String unit)

Calculate Q based on P and PFactor

Parameters:

p - active power

pf - power factor

unit - power factor unit, "PU" or "%"

Returns:

reactive power Q

calQ

public static double calQ(double p,
                          double pf,
                          Unit.UnitType unit)

Calculate Q based on P and PFactor

Parameters:

p - active power

pf - power factor

unit - power factor unit

Returns:

reactive power Q

calPFactor

public static double calPFactor(double p,
                                double q)

calculate power factor

Parameters:

p -

q -

Returns:

getZoneNumberAry

public static long[] getZoneNumberAry(java.util.List<Zone> zoneList)

get zone number array from a list of zone objects

Parameters:

zoneList -

Returns:

getAreaNumberAry

public static long[] getAreaNumberAry(java.util.List<Area> areaList)

get araa number array from a list of area objects

Parameters:

list -

Returns: