Methods
arrayConcat(ar1,)
Concatenates up to 9 arrays (assuming the number of columns are the same in each array.
Parameters:
Name | Type | Description |
---|---|---|
ar1, |
array | ar2 ... ar 9 arrays to be concatenated. |
- Source:
Returns:
joined (concatenated array)
arrayJoin(ar1, ar2, col1, col2)
Joins two arrays (of different data) on column values in array 2, equalling column values in array 1.
Parameters:
Name | Type | Description |
---|---|---|
ar1 |
array | ar1 first array to be joined. |
ar2 |
array | ar2 second array to be joined. |
col1 |
col1 | col1 joining column in array 1 |
col2 |
col2 | col2 joing column in array 2 |
- Source:
Returns:
joined arrays
bs7671AirMultiCoreCapacity(cableDetailId, Ib, pf, In, phase, secondaryMethodID, inParallel, noCircuits, circuitSpacing, airTemperature, header)
Returns the sustained capacity (A) of a multi core cable installed in air in accordance with BS 7671.
Parameters:
Name | Type | Description |
---|---|---|
cableDetailId |
number | cableDetailId for which to look up the CSA. |
Ib |
number | Ib design current of the circuit, A. |
pf |
number | pf power factor (= 1 for d.c. circuits). |
In |
number | In rated current setting of a protective device, A. |
phase |
number | phase configuration:see =phases(). |
secondaryMethodID |
number | secondaryMethodID secondary installation method ID. |
inParallel |
number | inParallel number of cables in parallel supplying a single circuit. |
noCircuits |
number | noCircuits number of independent cable circuits running together. |
circuitSpacing |
number | circuitSpacing spacing between independent cable circuits (see noCircuits), m. |
airTemperature |
number | airTemperature ambient temperature of the air, °C. |
header |
boolean | header optional parameter, will display header row if set to true |
- Source:
Returns:
CSA (mm2), Capacity (A), CableDetailID
bs7671AirMultiCoreCSA(cableId, Ib, pf, In, phase, secondaryMethodID, inParallel, noCircuits, circuitSpacing, airTemperature, header)
Returns the recommend CSA (mm2) of a multi core cable installed in air in accordance with BS 7671.
Parameters:
Name | Type | Description |
---|---|---|
cableId |
number | cableId for which to look up the CSA. |
Ib |
number | Ib design current of the circuit, A. |
pf |
number | pf power factor (= 1 for d.c. circuits). |
In |
number | In rated current setting of a protective device, A. |
phase |
number | phase configuration:see =phases(). |
secondaryMethodID |
number | secondaryMethodID secondary installation method ID. |
inParallel |
number | inParallel number of cables in parallel supplying a single circuit. |
noCircuits |
number | noCircuits number of independent cable circuits running together. |
circuitSpacing |
number | circuitSpacing spacing between independent cable circuits (see noCircuits), m. |
airTemperature |
number | airTemperature ambient temperature of the air, °C. |
header |
boolean | header optional parameter, will display header row if set to true |
- Source:
Returns:
CSA (mm2), Capacity (A), CableDetailID
bs7671AirSingleCoreCapacity(cableDetailId, Ib, pf, In, phase, configurationID, secondaryMethodID, inParallel, noCircuits, circuitSpacing, airTemperature)
Returns the sustained current capacity of a single core cable installed in air in accordance with BS 7671.
Parameters:
Name | Type | Description |
---|---|---|
cableDetailId |
number | cableDetailId for which to look up the sustained capacity. |
Ib |
number | Ib design current of the circuit, A. |
pf |
number | pf power factor (= 1 for d.c. circuits). |
In |
number | In rated current setting of a protective device, A. |
phase |
number | phase configuration:see =phases(). |
configurationID |
number | configurationID: see configurations(). |
secondaryMethodID |
number | secondaryMethodID secondary installation method ID. |
inParallel |
number | inParallel number of cables in parallel supplying a single circuit. |
noCircuits |
number | noCircuits number of independent cable circuits running together. |
circuitSpacing |
number | circuitSpacing spacing between independent cable circuits (see noCircuits), m. |
airTemperature |
number | airTemperature ambient temperature of the air, °C. |
- Source:
Returns:
CSA (mm2), Capacity, CableDetailID
bs7671AirSingleCoreCSA(cableId, Ib, pf, In, phase, configurationID, secondaryMethodID, inParallel, noCircuits, circuitSpacing, airTemperature, header)
Returns the recommend CSA (mm2) of a single core cable installed in air in accordance with BS 7671.
Parameters:
Name | Type | Description |
---|---|---|
cableId |
number | cableId for which to look up the CSA. |
Ib |
number | Ib design current of the circuit, A. |
pf |
number | pf power factor (= 1 for d.c. circuits). |
In |
number | In rated current setting of a protective device, A. |
phase |
number | phase configuration:see =phases(). |
configurationID |
number | configurationID: see configurations(). |
secondaryMethodID |
number | secondaryMethodID secondary installation method ID. |
inParallel |
number | inParallel number of cables in parallel supplying a single circuit. |
noCircuits |
number | noCircuits number of independent cable circuits running together. |
circuitSpacing |
number | circuitSpacing spacing between independent cable circuits (see noCircuits), m. |
airTemperature |
number | airTemperature ambient temperature of the air, °C. |
header |
boolean | header optional parameter, will display header row if set to true |
- Source:
Returns:
CSA (mm2), Capacity (A), CableDetailID
bs7671BuriedMultiCoreCapacity(cableDetailId, Ib, pf, In, phase, secondaryMethodID, inParallel, noCircuits, circuitSpacing, groundTemperature, depth, soilThermalResistivity, header)
Returns the capacity (A) of a multi core cable installed in ground in accordance with BS 7671.
Parameters:
Name | Type | Description |
---|---|---|
cableDetailId |
number | cableDetailId for which to look up the CSA. |
Ib |
number | Ib design current of the circuit, A. |
pf |
number | pf power factor (= 1 for d.c. circuits). |
In |
number | In rated current setting of a protective device, A. |
phase |
number | phase configuration:see =phases(). |
secondaryMethodID |
number | secondaryMethodID secondary installation method ID. |
inParallel |
number | inParallel number of cables in parallel supplying a single circuit. |
noCircuits |
number | noCircuits number of independent cable circuits running together. |
circuitSpacing |
number | circuitSpacing spacing between independent cable circuits (see noCircuits), m. |
groundTemperature |
number | groundTemperature ambient temperature of the soil, °C. |
depth |
number | depth buried cable depth, M |
soilThermalResistivity |
number | soilThermalResistivity soil thermal resistivity of ground (cable are buried in), K.m/W |
header |
boolean | header optional parameter, will display header row if set to true |
- Source:
Returns:
CSA (mm2), Capacity (A), CableDetailID
bs7671BuriedMultiCoreCSA(cableId, Ib, pf, In, phase, secondaryMethodID, inParallel, noCircuits, circuitSpacing, groundTemperature, depth, soilThermalResistivity, header)
Returns the recommend CSA (mm2) of a multi core cable installed in ground in accordance with BS 7671.
Parameters:
Name | Type | Description |
---|---|---|
cableId |
number | cableId for which to look up the CSA. |
Ib |
number | Ib design current of the circuit, A. |
pf |
number | pf power factor (= 1 for d.c. circuits). |
In |
number | In rated current setting of a protective device, A. |
phase |
number | phase configuration:see =phases(). |
secondaryMethodID |
number | secondaryMethodID secondary installation method ID. |
inParallel |
number | inParallel number of cables in parallel supplying a single circuit. |
noCircuits |
number | noCircuits number of independent cable circuits running together. |
circuitSpacing |
number | circuitSpacing spacing between independent cable circuits (see noCircuits), m. |
groundTemperature |
number | groundTemperature ambient temperature of the soil, °C. |
depth |
number | depth buried cable depth, M |
soilThermalResistivity |
number | soilThermalResistivity soil thermal resistivity of ground (cable are buried in), K.m/W |
header |
boolean | header optional parameter, will display header row if set to true |
- Source:
Returns:
CSA (mm2), Capacity (A), CableDetailID
bs7671PrimaryMethods(cableId, phase, header)
Returns a list of BS 7671 primary installation methods for a given a cable id and phase.
ID, Description, ReferenceMethod, Buried.
Parameters:
Name | Type | Description |
---|---|---|
cableId |
number | cableId for which to look up the installation methods. |
phase |
number | Phase configuration:see =phases(). |
header |
boolean | header optional parameter, will display header row if set to true |
- Source:
Returns:
ID, Description, ReferenceMethod, Buried
bs7671SecondaryMethods(cableId, primaryID, phase, header)
Returns a list of BS 7671 secondary installation methods for a given a cable id, primaryID and phase.
ID, Description, ReferenceMethod, Buried, ScConfig (allowable single core configurations).
Parameters:
Name | Type | Description |
---|---|---|
cableId |
number | cableId for which to look up the installation methods. |
primaryID |
number | primaryID for which to look up the installation methods. |
phase |
number | Phase configuration:see =phases(). |
header |
boolean | header optional parameter, will display header row if set to true |
- Source:
Returns:
ID,primaryID, Description, ScConfig
cableConductorTemperature(Ib, Iz, ambientTemperature, Ti)
Estimate the operating temperature of a conductor based on it's calculated sustained rating, Iz (at Ti), cable current Ib, ambient temperature Ta, and
maximum insulation temperature Ti.
Parameters:
Name | Type | Description |
---|---|---|
Ib |
number | design current of a circuit, A. |
Iz |
number | sustained capacity of cable (at maximum insulation temperature), A. |
ambientTemperature |
number | ambient temperature of the surrounding, °C. |
Ti |
number | insulation maximum operating temperature, °C. |
- Source:
Returns:
Operating temperature.
cableConductorTemperature_LibraryID(Ib, Iz, ambientTemperature, cableLibraryID)
Estimate the operating temperature of a conductor based on it's calculated sustained rating, Iz (at Ti), cable current Ib, ambient temperature Ta, and
cable library ID.
Parameters:
Name | Type | Description |
---|---|---|
Ib |
number | design current of a circuit, A. |
Iz |
number | sustained capacity of cable (at maximum insulation temperature), A. |
ambientTemperature |
number | ambient temperature of the surrounding, °C. |
cableLibraryID |
number | cable library ID. |
- Source:
Returns:
Operating temperature.
cableDetails(cableId, header)
Returns a list of cable details for a given cable id and phase.
ID, CSA, OverallDiameter(mm), ArmmourCSA.
Parameters:
Name | Type | Description |
---|---|---|
cableId |
number | cableId database id of the cable to get details for. |
header |
boolean | header optional parameter, will display header row if set to true |
- Source:
Returns:
ID, CableID, CSA, OverallDiameter(mm), ArmmourCSA.
cableDetailsID(cableDetailId, header)
Returns cable details given its id.
ID, CSA, OverallDiameter(mm), ArmmourCSA.
Parameters:
Name | Type | Description |
---|---|---|
cableDetailId |
number | cableDetailId database id of the cable to get details for. |
header |
boolean | header optional parameter, will display header row if set to true |
- Source:
Returns:
ID, CableID, CSA, OverallDiameter(mm), ArmmourCSA.
cables(cableSourceId, phase, header)
Returns a list of cables for a given source id and phase.
ID, Description, Cores, ConductorMaterial ConductorMaterialId, InsulationMaterial, InsulationMaterialId, ArmourMaterial, ArmourMaterialID.
Parameters:
Name | Type | Description |
---|---|---|
cableSourceId |
number | cableSourceId for which to look up cables for. |
phase |
number | Phase configuration:see =phases(). |
header |
boolean | header optional parameter, will display header row if set to true |
- Source:
Returns:
ID, CableSourceID, Description, Cores, ConductorMaterial, ConductorMaterialId, InsulationMaterial, InsulationMaterialId, ArmourMaterial, ArmourMaterialID
cablesID(cableId, header)
Returns a cable for a given its id.
ID, Description, Cores, ConductorMaterial, ConductorMaterialId, InsulationMaterial, InsulationMaterialId, ArmourMaterial, ArmourMaterialID.
Parameters:
Name | Type | Description |
---|---|---|
cableId |
number | cableId database id of the cable. |
header |
boolean | header optional parameter, will display header row if set to true |
- Source:
Returns:
ID, CableSourceID, Description, Cores, ConductorMaterial, ConductorMaterialId, InsulationMaterial, InsulationMaterialId, ArmourMaterial, ArmourMaterialID
cableSources(header)
Returns a list of all cable sources. ID, Manufacturer, Description, U3, U0, Udc.
Parameters:
Name | Type | Description |
---|---|---|
header |
boolean | header optional parameter, will display header row if set to true |
- Source:
Returns:
ID, Manufacturer, Description, U3, U0, Udc
cableSourcesID(id, header)
Returns a cable sources for a given id.
ID, Manufacturer, Description, U3, U0, Udc.
Parameters:
Name | Type | Description |
---|---|---|
id |
number | database id of the cables, V |
header |
boolean | header optional parameter, will display header row if set to true |
- Source:
Returns:
ID, Manufacturer, Description, U3, U0, Udc
cableSourcesVoltagePhase(voltage, phase, header)
Returns a list of all cable sources suitable for use with given voltage and phase.
ID, Manufacturer, Description, U3, U0, Udc.
Parameters:
Name | Type | Description |
---|---|---|
voltage |
number | System operating voltage, V |
phase |
number | Phase configuration: 0 - d.c. 1 - single phase a.c. 3 - three phase a.c. 4 - three pahse + neutral a.c. |
header |
boolean | header optional parameter, will display header row if set to true |
- Source:
Returns:
ID, Manufacturer, Description, U3, U0, Udc
complex(Re, Im)
Generate a complex number, give the real and imaginary parts.
Parameters:
Name | Type | Description |
---|---|---|
Re |
number | real part of a complex |
Im |
number | imaginary part of a complex number, |
- Source:
Returns:
complex number
complexAdd(first, second)
Add two complex numbers (a+b).
Parameters:
Name | Type | Description |
---|---|---|
first |
complex | number |
second |
complex | number |
- Source:
Returns:
complex number (the sum)
complexConjugate(complex)
Find the conjugate of a complex number.
Parameters:
Name | Type | Description |
---|---|---|
complex |
complex | number |
- Source:
Returns:
complex number (the conjugate)
complexCurrentPF(current, powerFactor)
Get the complex representation of current, from the magnitude and power factor.
For d.c. power factor = 1. +ve power factor indicates lagging, -ve leading.
Parameters:
Name | Type | Description |
---|---|---|
current |
number | magnitude of the current |
powerFactor |
number | the power factor of the current (set = 1 for d.c.). |
- Source:
Returns:
complex number representing the current
complexDivide(first, second)
Divide two complex numbers (a/b).
Parameters:
Name | Type | Description |
---|---|---|
first |
complex | number |
second |
complex | number |
- Source:
Returns:
complex number (the division)
complexIm(complex)
Get the imaginary part of a complex number, give the full number (both real and imaginary parts).
Parameters:
Name | Type | Description |
---|---|---|
complex |
complex | number |
- Source:
Returns:
imaginary part
complexMag(complex)
Get the magnitude part of a complex number, give the full number (both real and imaginary parts).
Parameters:
Name | Type | Description |
---|---|---|
complex |
complex | number |
- Source:
Returns:
magnitude of the number
complexMagPhase(magnitude, phase)
Generate a complex number, give the magnitude and phase angle, radians.
Parameters:
Name | Type | Description |
---|---|---|
magnitude |
number | magnitude of the complex number |
phase |
number | phase angle of the complex number, radians |
- Source:
Returns:
complex number
complexMagPhaseDeg(magnitude, phase)
Generate a complex number, give the magnitude and phase angle, degrees.
Parameters:
Name | Type | Description |
---|---|---|
magnitude |
number | magnitude of the complex number |
phase |
number | phase angle of the complex number, degrees |
- Source:
Returns:
complex number
complexMultiply(first, second)
Multiple two complex numbers (a*b).
Parameters:
Name | Type | Description |
---|---|---|
first |
complex | number |
second |
complex | number |
- Source:
Returns:
complex number (the product)
complexPF(complex)
Get the power factor (cos(phase)) part of a complex number, give the full number (both real and imaginary parts).
Normally used with electrical current.
Parameters:
Name | Type | Description |
---|---|---|
complex |
complex | number |
- Source:
Returns:
power factor
complexPhase(complex)
Get the phase (radians) part of a complex number, give the full number (both real and imaginary parts).
Parameters:
Name | Type | Description |
---|---|---|
complex |
complex | number |
- Source:
Returns:
phase of the number, radians
complexPhaseDeg(complex)
Get the phase (degrees) part of a complex number, give the full number (both real and imaginary parts).
Parameters:
Name | Type | Description |
---|---|---|
complex |
complex | number |
- Source:
Returns:
phase of the number, degrees
complexRe(complex)
Get the real part of a complex number, give the full number (both real and imaginary parts).
Parameters:
Name | Type | Description |
---|---|---|
complex |
complex | number |
- Source:
Returns:
real part
complexReciprocal(complex)
Find the reciprocal of a complex number.
Parameters:
Name | Type | Description |
---|---|---|
complex |
complex | number |
- Source:
Returns:
complex number (the reciprocal)
complexReIm(Re, Im)
Generate a complex number, give the real and imaginary parts.
Parameters:
Name | Type | Description |
---|---|---|
Re |
number | real part of a complex |
Im |
number | imaginary part of a complex number, |
- Source:
Returns:
complex number
complexRound(complex, dp)
Round a complex number to a given number of decimal places.
Parameters:
Name | Type | Description |
---|---|---|
complex |
complex | number |
dp |
number | number of decimal places to round to |
- Source:
Returns:
complex number
complexSubtract(first, second)
Subtract one complex number from another (a-b).
Parameters:
Name | Type | Description |
---|---|---|
first |
complex | number |
second |
complex | number |
- Source:
Returns:
complex number (the difference)
configurations(header)
Gets a list of configuration ID for various single core cable installations.
ConfigurationID and description.
Parameters:
Name | Type | Description |
---|---|---|
header |
boolean | header optional parameter, will display header row if set to true |
- Source:
Returns:
ID and description.
materialConductorResistivity(input)
Electrical resistivity of a conductor, Ohm.m
Parameters:
Name | Type | Description |
---|---|---|
input |
number | The conductor material ID |
- Source:
Returns:
Conductor resistivity, Ohm.m
materialConductors(header)
Returns a list conductor materials which can be used in Electrical Functions.
ID, Symbol and Description.
Parameters:
Name | Type | Description |
---|---|---|
header |
boolean | header optional parameter, will display header row if set to true |
- Source:
Returns:
ID, Symbol and Description
materialConductorTemperatureCoefficient(input)
Temperature coefficient of a conductor, 1/K.
Parameters:
Name | Type | Description |
---|---|---|
input |
number | The conductor material ID. |
- Source:
Returns:
Temperature coefficient of resistivity, 1/K.
materialConductorVolumetricHeatCapacity(input)
Volumetric heat capacity of a conductor, J.(1/K).(1/m3)
Parameters:
Name | Type | Description |
---|---|---|
input |
number | The conductor material ID. |
- Source:
Returns:
Volumetric heat capacity of resistivity, J.(1/K).(1/m3)
phases(header)
Gets a list of phase IDs and associated description.
PhaseID is used in many calls to differentiate between systems (i.e. single phase or three phase).
Gives PhaseID, Description
Parameters:
Name | Type | Description |
---|---|---|
header |
boolean | header optional parameter, will display header row if set to true |
- Source:
Returns:
PhaseID, Description
powerAC(resistance, reactance, current, powerFactor)
AC power across an impedance due to current flowing, W.
Parameters:
Name | Type | Description |
---|---|---|
resistance |
number | resistance of the circuit in Ohm. |
reactance |
number | reactance of the circuit in Ohm. |
current |
number | the current flowing in the circuit, A. |
powerFactor |
number | power factor of the current (set =1 for d.c.). |
- Source:
Returns:
Power, W.
powerACVA(resistance, reactance, current, powerFactor)
AC VA (volt-amps) across an impedance due to current flowing, W.
Parameters:
Name | Type | Description |
---|---|---|
resistance |
number | resistance of the circuit in Ohm. |
reactance |
number | reactance of the circuit in Ohm. |
current |
number | the current flowing in the circuit, A. |
powerFactor |
number | power factor of the current (set =1 for d.c.). |
- Source:
Returns:
Power, W.
powerACVAr(resistance, reactance, current, powerFactor)
AC reactive power across an impedance due to current flowing, W.
Parameters:
Name | Type | Description |
---|---|---|
resistance |
number | resistance of the circuit in Ohm. |
reactance |
number | reactance of the circuit in Ohm. |
current |
number | the current flowing in the circuit, A. |
powerFactor |
number | power factor of the current (set =1 for d.c.). |
- Source:
Returns:
Power, W.
powerCmplx(impedance, current)
Complex power across an impedance due to current flowing, W.
Parameters:
Name | Type | Description |
---|---|---|
impedance |
complex | impedance of the circuit in Ohm. |
current |
complex | the current flowing in the circuit, A. |
- Source:
Returns:
Power, W.
powerComplex(voltage, current, phase)
Complex power give by VxI* (I* is the conjugate of I), W.
Additionally, power is calculated depending on phases (d.c., 1-ph or 3-ph)
Parameters:
Name | Type | Description |
---|---|---|
voltage |
complex | voltage of the circuit, cartesian coordinate, V. |
current |
complex | current of the circuit, cartesian coordinates, A. |
phase |
number | number of phases to consider, see =phases(). |
- Source:
Returns:
Power, complex form (W + jVAr).
powerDC(resistance, current)
DC power across a resistance due to current flowing, W.
Parameters:
Name | Type | Description |
---|---|---|
resistance |
number | resistance of the circuit in Ohm. |
current |
number | the current flowing in the circuit, A. |
- Source:
Returns:
Power, W.
resistanceDC20(resistivity, CSA, length)
d.c. resistance of a conductor at 20degC, Ohm.
Parameters:
Name | Type | Description |
---|---|---|
resistivity |
number | Electrical resistivity of conductor or material at 20degC, Ohm.m |
CSA |
number | Cross-sectional area of cable or conductor, mm2 |
length |
number | Length of cable or conductor, m |
- Source:
Returns:
Conductor resistance, Ohm
resistanceDCT(resistivity, CSA, length, temperature, temperatureCoefficient)
d.c. resistance of a conductor at TdegC, Ohm.
Parameters:
Name | Type | Description |
---|---|---|
resistivity |
number | Electrical resistivity of conductor or material at 20degC, Ohm.m |
CSA |
number | Cross-sectional area of cable or conductor, mm2 |
length |
number | Length of cable or conductor, m |
temperature |
number | Operating temperature of a conductor or material, degC |
temperatureCoefficient |
number | Temperature Coefficient (resistance) at 20degC, 1/K |
- Source:
Returns:
Conductor resistance, Ohm
resistanceDeltaT(resistanceResistance, temperatureBase, temperatureOperating, temperatureCoefficient)
d.c. resistance temperature adjustment.
Find resistance at operating temperature given the resistance at the base temperature, Ohm.
Parameters:
Name | Type | Description |
---|---|---|
resistanceResistance |
number | of a cable (single conductor) or circuit element, Ohm |
temperatureBase |
number | Base temperature of a conductor or material, degC |
temperatureOperating |
number | Operating temperature of a conductor or material, degC |
temperatureCoefficient |
number | Temperature Coefficient (resistance) at 20degC, 1/K |
- Source:
Returns:
Conductor resistance, Ohm
verify()
Verify connection and authorisation to the Electrical Functions API server. Returns 'true' if successful.
- Source:
Returns:
Returns 'true' if successful
voltage3pLL(voltage)
Calculates the 3-phase Line-line voltage, given the line-neutral.
If available standards are used (i.e. 400/230V),otherwise value is calculated.
Parameters:
Name | Type | Description |
---|---|---|
voltage |
number | magnitude of the voltage (line-line), V. |
- Source:
Returns:
Line-line voltage.
voltage3pLLCmplx(voltage)
Calculates the 3-phase Line-line voltage, given the line-neutral.
If available standards are used (i.e. 400/230V),otherwise value is calculated.
Parameters:
Name | Type | Description |
---|---|---|
voltage |
complex | voltage in complex form (line-line), V. |
- Source:
Returns:
Line-line voltage.
voltage3pLN(voltage)
Calculates the 3-phase Line-neutral voltage, given the line-line.
If available standards are used (i.e. 400/230V),otherwise value is calculated.
Parameters:
Name | Type | Description |
---|---|---|
voltage |
number | magnitude of the voltage (line-neutral), V. |
- Source:
Returns:
Line-neutral voltage.
voltage3pLNCmplx(voltage)
Calculates the 3-phase Line-neutral voltage, given the line-line.
If available standards are used (i.e. 400/230V),otherwise value is calculated.
Parameters:
Name | Type | Description |
---|---|---|
voltage |
complex | voltage in complex form (line-neutral), V. |
- Source:
Returns:
Line-neutral voltage.
voltageDropAC(resistance, reactance, current, powerFactor)
AC voltage drop across an impedance (I*Z), V.
Parameters:
Name | Type | Description |
---|---|---|
resistance |
number | the resistance of the circuit in Ohm. |
reactance |
number | the reactance of the circuit in Ohm. |
current |
number | the current flowing in the circuit. |
powerFactor |
number | the power factor of the circuit. |
- Source:
Returns:
Voltage drop.
voltageDropCenelec(voltage, voltagePhase, phase, resistance, reactance, current, powerFactor)
Voltage drop (in V) calculated in accordance with CENELEC technical report CLC/TR 50480.
This is intended for calculation of voltage drop across cables, where conductor impedance is known.
Parameters:
Name | Type | Description |
---|---|---|
voltage |
number | magnitude of the voltage, V. |
voltagePhase |
number | phase angle of the voltage in radians |
phase |
number | phase configuration, see =phases() |
resistance |
number | the resistance of the cable/circuit in Ohm. |
reactance |
number | the reactance of the cable/circuit in Ohm. |
current |
number | the current flowing in the cable/circuit, A. |
powerFactor |
number | the power factor of the cable/circuit, A. |
- Source:
Returns:
Voltage drop, V.
voltageDropCenelecCmplx(voltage, phase, impedance, current)
Voltage drop (in V) calculated in accordance with CENELEC technical report CLC/TR 50480.
This is intended for calculation of voltage drop across cables, where conductor impedance is known.
Parameters:
Name | Type | Description |
---|---|---|
voltage |
complex | voltage in complex form, V. |
phase |
number | phase configuration, see =phases() |
impedance |
complex | impedance in complex form of the cable/circuit in Ohm. |
current |
complex | current in complex form flowing in the cable/circuit, A. |
- Source:
Returns:
Voltage drop, V.
voltageDropCenelecCmplxPercent(voltage, phase, impedance, current)
Voltage drop (in % decimal) calculated in accordance with CENELEC technical report CLC/TR 50480.
This is intended for calculation of voltage drop across cables, where conductor impedance is known.
Parameters:
Name | Type | Description |
---|---|---|
voltage |
complex | voltage in complex form, V. |
phase |
number | phase configuration, see =phases() |
impedance |
complex | impedance in complex form of the cable/circuit in Ohm. |
current |
complex | current in complex form flowing in the cable/circuit, A. |
- Source:
Returns:
Voltage drop, % decimal.
voltageDropCenelecPercent(voltage, voltagePhase, phase, resistance, reactance, current, powerFactor)
Voltage drop (in % decimal) calculated in accordance with CENELEC technical report CLC/TR 50480.
This is intended for calculation of voltage drop across cables, where conductor impedance is known.
Parameters:
Name | Type | Description |
---|---|---|
voltage |
number | magnitude of the voltage, V. |
voltagePhase |
number | phase angle of the voltage in radians |
phase |
number | phase configuration, see =phases() |
resistance |
number | the resistance of the cable/circuit in Ohm. |
reactance |
number | the reactance of the cable/circuit in Ohm. |
current |
number | the current flowing in the cable/circuit, A. |
powerFactor |
number | the power factor of the cable/circuit, A. |
- Source:
Returns:
Voltage drop, % decimal.
voltageDropCmplx(impedance, current)
Calculates a voltage drop across a cable or circuit element.
Voltage drop across an impedance (I*Z), V.
Parameters:
Name | Type | Description |
---|---|---|
impedance |
complex | (complex form) the impedance of the circuit in Ohm. |
current |
complex | (complex form) the current of the circuit in A. |
- Source:
Returns:
Voltage drop, V.
voltageDropDC(resistance, current)
DC voltage drop across a resistance (I*R), V.
Parameters:
Name | Type | Description |
---|---|---|
resistance |
number | the resistance of the circuit in Ohm. |
current |
number | the current flowing in the circuit. |
- Source:
Returns:
Voltage drop, V.