electricpy.acpiv¶

electricpy.acpiv(S=None, I=None, VLL=None, VLN=None, V=None, PF=None)[source]¶

AC Power-Voltage-Current Relation Function.

Relationship function to return apparent power, voltage, or current in one of various forms.

Parameters:¶

S : complex, optional¶

Apparent power, may be single or three-phase, specified in volt-amps (VAs)

I : complex, optional¶

Phase current in amps

VLL : complex, optional¶

Line-to-Line voltage in volts

VLN : complex, optional¶

Line-to-Neutral voltage in volts

V : complex, optional¶

Single-phase voltage in volts

PF : float, optional¶

Power factor to condition the apparent power to an appropriate complex value.

Returns:¶

• S (complex) – Apparent power, returned only if one voltage and current is specified

• I (complex) – Phase current, returned only if one voltage and apparent power is specified

• VLL (complex) – Line-to-Line voltage, returned only if current and apparent power specified, returned as set with other voltages in form: (VLL, VLN, V)

• VLN (complex) – Line-to-Neutral voltage, returned only if current and apparent power specified, returned as set with other voltages in form: (VLL, VLN, V)

• V (complex) – Single-phase voltage, returned only if current and apparent power specified, returned as set with other voltages in form: (VLL, VLN, V)

• PF (float, optional) – Supporting argument to convert floating-point apparent power to complex representation.

Examples

>>> import electricpy as ep
>>> ep.acpiv(S=550, V=167)
3.2934131736526946
>>> ep.acpiv(S=550, I=3.2934131736526946)
(96.4174949546675, 55.66666666666667, 167.0)