PowerCalculations
Calculates a real-time average frequency reporting the average, maximum and minimum values.
Gets or sets low frequency reasonability threshold, inclusive.
Gets or sets high frequency reasonability threshold, inclusive.
Gets or sets flag that determines if unreasonable results should be reported as NaN.
Returns the detailed status of the calculator.
Initializes the calculator.
Calculates the average frequency for all frequencies that have reported in the specified lag time.
Single frame of measurement data within a one second sample.
Index of frame within the one second sample.
Represents an adapter that manages bulk calculation of positive, negative and zero sequence values based on A, B and C phase data inputs.
Defines the default value for the .
Creates new .
Gets or sets flag that determines if the last few values should be monitored for diagnostics.
Gets or sets the sample size of the data to be monitored.
Gets or sets flag that determines if positive sequence calculations should be included.
Gets or sets flag that determines if negative sequence calculations should be included.
Gets or sets flag that determines if zero sequence calculations should be included.
Gets or sets the bad data strategy used to when inputs are marked with bad quality.
Gets number of input measurements required by each adapter.
Gets or sets the index into the per adapter input measurements to use for target adapter name.
Gets output measurement names.
Gets output phase for each output measurement.
Gets or sets default signal type to use for all output measurements when array is not defined.
Gets or sets flag that determines if all output signal types should be forced to CALC.
Gets signal type for each output measurement, used when each output needs to be a different type.
Gets any custom adapter settings to be added to each adapter connection string. Can be used to add
settings that are custom per adapter.
Gets or sets template for output measurement point tag names.
Gets or sets template for local signal reference measurement name for source historian point.
Gets or sets template for output measurement descriptions.
Gets or sets template for the parent device acronym used to group associated output measurements.
Gets associated device ID for , if any, for measurement generation.
Gets or sets output measurements that the will produce, if any.
Parses connection string.
Represents an enumeration of bad data strategies.
Drops outputs when inputs are bad.
Marks outputs as bad when inputs are bad.
Class used to save measurement objects for power calculation adapter
Saves measurement back to the configuration database
Database connection for query. Will be created from config if this value is null.
Measurement to be inserted or updated
Model class for power calculations stored in the configuration repository
ID field for the
Circuit Description field for the
Measurement key from the 's Voltage Angle
Measurement key from the 's Voltage Magnitude
Measurement key from the 's Current Angle
Measurement key from the 's Current Magnitude
Measurement template to be used for active power output values from the
Measurement template to be used for reactive power output values from the
Measurement template to be used for apparent power output values from the
Implements validations for power calculations in the power calculation adapter
Validates that data operation and adapter instance exist within database.
Returns true if a data operation exists to run this class. Returns false otherwise.
Database connection to use for checking the data operation
True or false indicating whether the operation exists
Creates a data operation to run the validations in this class.
Database connection to use for creating the data operation
Returns true if a data operation exists to run this class. Returns false otherwise.
Database connection to use for checking the data operation
True or false indicating whether the operation exists
Creates a data operation to run the validations in this class.
Database connection to use for creating the data operation
Data operation to validate power calculation configuration. This method checks that input measurements and non-null output measurements exist, are enabled, and have the correct signal type.
If null output measurements are found in the configuration, this method will create the output measurements and update the configuration.
Database connection for configuration information
Node ID for database queries
Not used
Not used
Delegate for method to communicate status updates
Exception handling delegate
Checks power calculation configuration for null output measurements. When found, a new measurement is created, and the configuration is updated to use the new measurement.
Configuration database connection
Node ID formatted for query
Delegate for communicating status updates
Creates a new measurement object for power calculation output measurements
Updated power calculation to use new Signal IDs for output measurement
Configuration database connection
ID of the power calculation to be updated
Active power output signal ID, if needed for update
Reactive power output signal ID, if needed for update
Apparent power output signal ID, if needed for update
Verifies that output measurements are set to calculated signal type. Calculations are disabled if output measurements are not configured correctly.
Configuration database connection
Node ID formatted for query
Delegate to communicate status updates
Verifies that output measurements are enabled. Power calculations will be disabled where outputs are disabled.
Verifies that output measurements exist in the measurement table. Power calculations are disabled where the configured outputs do not exist.
Configuration database connection
Node ID formatted for query
Delegate to communicate status updates
Validates that input measurements have the correct signal type. Power calculations are disabled where inputs have the wrong signal types.
Configuration database connection
Node ID formatted for database query
Delegate for status updates
Verifies that input measurements are enabled. Power calculations are disabled where input measurements are disabled.
Configuration database connection
Node ID formatted for query
Delegate for communicating status updates
Verifies that input measurements exist. Power calculations are disabled where input measurements do not exist.
Configuration database connection
Node ID formatted for query
Delegate for communicating status updates
Simple model class for measurements
Gets or sets the current 's Signal ID
Gets or sets the current 's Point Tag
Gets or sets the current 's Adder
Gets or sets the current 's Multiplier
Gets or sets the current 's description
Gets or sets the current 's Device ID
Gets or sets the current 's Historian ID
Gets or sets the current 's Signal Type ID
Gets or sets the current 's Enabled flag
Gets or sets the current 's signal reference
Performs MW, MVA, and MVAR calculations based on current and voltage phasors input to the adapter
Creates the adapter
Gets or sets flag that determines if the last few values should be monitored for diagnostics.
Gets or sets the name of the table this adapter will use to obtain its metadata.
Gets or sets flag indicating whether or not this adapter will produce a result for all calculations. If this value is true and a calculation fails,
the adapter will produce NaN for that calculation. If this value is false and a calculation fails, the adapter will not produce any result.
Gets or sets the default strategy used to adjust voltage values for based on the nature of the voltage measurements.
Gets or sets flag that determines if adapter should enable temporal processing support.
Gets or sets SI units factor to use for power calculations, defaults to Mega (10^6).
Gets or sets the bad data strategy used to when inputs are marked with bad quality.
Gets the flag indicating if this adapter supports temporal processing.
Returns the adapter status, including real-time statistics about adapter operation
Loads configuration from the database and configures adapter to run with that configuration
Calculates MW, MVAR and MVA then publishes those measurements.
Input values for calculation
Index of frame within second.
Calculates running average of a value
Average calculated on values provided so far
Calculates running average based on previous values and the new value
Value to be added to the running average
New running average
Calculates a composed angle difference.
Gets or sets flag indicating whether or not this adapter will produce a result for all calculations. If this value is true and a calculation fails,
the adapter will produce NaN for that calculation. If this value is false and a calculation fails, the adapter will not produce any result.
Returns the detailed status of the calculator.
Initializes the calculator.
Calculates an angle difference.
Single frame of measurement data within one second samples
Index of frame within the one second samples
Represents an algorithm that calculates power and stability from a synchrophasor device.
Gets or sets the flag that determines if line-to-line adjustment should be applied.
Returns the detailed status of the monitor.
Initializes the monitor.
Publishes the of time-aligned collection of values that arrived within the
adapter's defined .
of measurements with the same timestamp that arrived within that are ready for processing.
Index of within a second ranging from zero to - 1.
Represents the strategy used to adjust voltage values for power
calculations based on the nature of the voltage measurement.
Factor of 3 adjustment (S=3*V*I)
Factor of Sqrt(3) adjustment (S=Sqrt(3)*V*I)
Factor of 1 adjustment (S=1*V*I). Same as .
Factor of 1/Sqrt(3) adjustment (S=V*I/Sqrt(3))
No adjustment (S=V*I)
Calculates positive, negative and zero sequences using A, B and C phase voltage or current magnitude and angle signals input to the adapter.
Defines the output measurements for the .
One output measurement should be defined for each enumeration value, in order:
Positive sequence magnitude measurement.
Positive sequence angle measurement.
Negative sequence magnitude measurement.
Negative sequence angle measurement.
Zero sequence magnitude measurement.
Zero sequence angle measurement.
Gets or sets flag that determines if the last few values should be monitored for diagnostics.
Gets or sets the sample size of the data to be monitored.
Gets or sets flag that determines if positive sequence calculations should be included.
Gets or sets flag that determines if negative sequence calculations should be included.
Gets or sets flag that determines if zero sequence calculations should be included.
Gets or sets the bad data strategy used to when inputs are marked with bad quality.
Gets the flag indicating if this adapter supports temporal processing.
Returns the detailed status of the .
Initializes the .
Publish frame of time-aligned collection of measurement values that arrived within the defined lag time.
Frame of measurements with the same timestamp that arrived within lag time that are ready for processing.
Index of frame within a second ranging from zero to frames per second - 1.
Calculates MW and MVAR using Voltage and Current Magnitude and Angle signals input to the adapter.
Gets or sets flag that determines if the last few values should be monitored.
Gets or sets the sample size of the data to be monitored.
Gets the flag indicating if this adapter supports temporal processing.
Returns the detailed status of the .
Initializes the .
Publish frame of time-aligned collection of measurement values that arrived within the defined lag time.
Frame of measurements with the same timestamp that arrived within lag time that are ready for processing.
Index of frame within a second ranging from zero to frames per second - 1.
Represents an algorithm that calculates power and stability from a synchrophasor device.
This algorithm calculates power and its standard deviation in real-time that can be used to
determine if there is an oscillatory signature in the power output.
If multiple voltage phasors are provided as inputs to this algorithm, then they are assumed to be
redundant values on the same bus, the first energized value will be the voltage phasor that is
used in the calculation.
If multiple current phasors are provided as inputs to this algorithm, then they are assumed to be
cumulative inputs representing the desired power output summation of the generation source.
Individual phase angle and magnitude phasor elements are expected to be defined consecutively.
That is the definition order of angles and magnitudes must match so that the angle / magnitude
pair can be matched up appropriately. For example: angle1;mag1; angle2;mag2; angle3;mag3.
Gets or sets the sample size, in seconds, of the data to be monitored.
Gets or sets the energized bus threshold, in volts. The recommended value is 20% of nominal line-to-neutral voltage.
Returns the detailed status of the monitor.
Initializes the monitor.
Publishes the of time-aligned collection of values that arrived within the
adapter's defined .
of measurements with the same timestamp that arrived within that are ready for processing.
Index of within a second ranging from zero to - 1.
Defines the type of frequency excursion detected.
Generation based frequency excursion.
Load based frequency excursion.
Represents an algorithm that detects frequency excursions.
Gets or sets the threshold for detecting an abnormal excursion in frequency.
Gets or sets the number of frames to be analyzed at any given time.
Gets or sets the interval between adjacent calculations.
Gets or sets the minimum number of consecutive excursions needed in order to trip the alarm.
Gets or sets the minimum frequency values needed to perform a valid calculation.
Gets or sets the ratio used to calculate the total estimated MW change from frequency.
Gets or sets the period, in seconds, used to prevent duplicate alarms.
Returns the detailed status of the detector.
Initializes the detector.
Publishes the of time-aligned collection of values that arrived within the
adapter's defined .
of measurements with the same timestamp that arrived within that are ready for processing.
Index of within a second ranging from zero to - 1.
Represents an algorithm that detects Loss of Field from a synchrophasor device.
Gets or sets the threshold of P-set MW.
Gets or sets the threshold of Q-set MVar.
Gets or sets the threshold of Q-area MVar-sec.
Gets or sets the threshold of voltage, in volts.
Gets or sets the interval between adjacent calculations.
Returns the detailed status of the detector.
Initializes the detector.
Publishes the of time-aligned collection of values that arrived within the
adapter's defined .
of measurements with the same timestamp that arrived within that are ready for processing.
Index of within a second ranging from zero to - 1.
Calculates a composed reference angle.
Returns the detailed status of the calculator.
Initializes the calculator.
Calculates a virtual reference angle.
Single frame of measurement data within one second samples
Index of frame within the one second samples
Calculates an average magnitude associated with a composed reference angle.
Returns the detailed status of the calculator.
Initializes the calculator.
Calculates the average reference magnitude.
Single frame of measurement data within a one second sample.
Index of frame within the one second sample.