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(AclfBus bus) Calculate exponential load
static org.apache.commons.math3.complex.Complex	calExpLoad(org.apache.commons.math3.complex.Complex load0, 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) Calcute Q based on P and PFactor
static double	calQ(double p, double pf, Unit.UnitType unit)
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 void	deepCopy(BaseAclfNetwork<?,?> fromNet, BaseAclfNetwork<?,?> toNet, java.lang.String[] busIdAry, java.lang.String[] branchIdAry) deep copy of the bus and branch set
static long[]	getAreaNumberAry(java.util.List<Area> list) get araa number array from a list of area objects
static java.lang.Object[]	getBranchIdArray(Network<Bus,Branch> net) Get branch ids into an array
static java.lang.Object[]	getBusIdArray(Network<Bus,Branch> net) Get bus ids into an array
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 long[]	getZoneNumberAry(java.util.List<Zone> list) get zone number array from a list of zone objects
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

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

Constructor Detail

CoreUtilFunc

public CoreUtilFunc()

Method Detail

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(org.apache.commons.math3.complex.Complex load0,
                                                                  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

calExpLoad

public static org.apache.commons.math3.complex.Complex calExpLoad(AclfBus bus)

Calculate exponential load

Parameters:

bus, - the bus object

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

deepCopy

public static void deepCopy(BaseAclfNetwork<?,?> fromNet,
                            BaseAclfNetwork<?,?> toNet,
                            java.lang.String[] busIdAry,
                            java.lang.String[] branchIdAry)
                     throws InterpssException

deep copy of the bus and branch set

Parameters:

fromNet -

toNet -

busIdAry -

branchIdAry -

Throws:

InterpssException

getBusIdArray

public static java.lang.Object[] getBusIdArray(Network<Bus,Branch> net)

Get bus ids into an array

Returns:

the bus id array

getBranchIdArray

public static java.lang.Object[] getBranchIdArray(Network<Bus,Branch> net)

Get branch ids into an array

Returns:

the branch id array

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)

Calcute 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)

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> list)

get zone number array from a list of zone objects

Parameters:

list -

Returns:

getAreaNumberAry

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

get araa number array from a list of area objects

Parameters:

list -

Returns: