Gemstone PhasorProtocols Library
Frame
Represents a frame parser for a SEL CWS text based data stream that returns parsed data via events.
Definition
Namespace: Gemstone.PhasorProtocols.SelCWS
Assembly: Gemstone.PhasorProtocols (in Gemstone.PhasorProtocols.dll) Version: 1.0.160 -- Release Build+513330b2be7fdb9c9f4bfe60fd4f0a256321d484
Assembly: Gemstone.PhasorProtocols (in Gemstone.PhasorProtocols.dll) Version: 1.0.160 -- Release Build+513330b2be7fdb9c9f4bfe60fd4f0a256321d484
C#
public class FrameParser : FrameParserBase<FrameType>VB
Public Class FrameParser
Inherits FrameParserBase(Of FrameType)C++
public ref class FrameParser : public FrameParserBase<FrameType>JavaScript
Gemstone.PhasorProtocols.SelCWS.FrameParser = function();
Type.createClass(
'Gemstone.PhasorProtocols.SelCWS.FrameParser',
Gemstone.PhasorProtocols.FrameParserBase`1);- Inheritance
- Object MarshalByRefObject Stream BinaryImageParserBase FrameImageParserBaseFrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType MultiSourceFrameImageParserBaseSourceChannel, FrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType FrameParserBaseFrameType FrameParser
Remarks
Frame parser is implemented as a write-only stream - this way data can come from any source.
Constructors
| FrameParser | Creates a new FrameParser. |
Properties
| CalculatePhaseEstimates | Gets or sets flag that determines if current and voltage phase estimates, frequency and dF/dt should be calculated for PoW data. |
| CalculationFrameRate | Gets or sets the configured frame rate for phase estimate calculations. |
| CanRead |
Gets a value indicating whether the current stream supports reading.
(Inherited from BinaryImageParserBase) |
| CanSeek |
Gets a value indicating whether the current stream supports seeking.
(Inherited from BinaryImageParserBase) |
| CanTimeout | Gets a value that determines whether the current stream can time out. (Inherited from Stream) |
| CanWrite |
Gets a value indicating whether the current stream supports writing.
(Inherited from BinaryImageParserBase) |
| CheckSumValidationFrameTypes |
Gets or sets flags that determine if check-sums for specified frames should be validated.
(Inherited from FrameParserBaseTFrameIdentifier) |
| ConfigurationFrame |
Gets or sets current IConfigurationFrame used for parsing IDataFrame's encountered in the data stream from a device.
(Overrides FrameParserBaseTFrameIdentifierConfigurationFrame) |
| ConnectionParameters |
Gets or sets any connection specific IConnectionParameters that may be needed for parsing.
(Overrides FrameParserBaseTFrameIdentifierConnectionParameters) |
| Enabled |
Gets or sets a boolean value that indicates whether the frame image parser is currently enabled.
(Inherited from FrameImageParserBaseFrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType) |
| EnableIntervalAveraging | Gets or sets a flag that determines if interval averaging (boxcar averaging) is enabled across each publish interval when down-sampling. |
| EnablePublishEMA | Gets or sets a flag that determines if an additional exponential moving average (EMA) is applied to the published stream (after interval averaging). |
| Length |
The parser is designed as a write only stream, so this method is not implemented.
(Inherited from BinaryImageParserBase) |
| Name |
Gets the name of BinaryImageParserBase.
(Inherited from BinaryImageParserBase) |
| NominalFrequency | Gets the nominal LineFrequency of the SEL CWS device. |
| Position |
The parser is designed as a write only stream, so this method is not implemented.
(Inherited from BinaryImageParserBase) |
| ProtocolSyncBytes |
Gets or sets synchronization bytes for this parsing implementation, if used.
(Inherited from BinaryImageParserBase) |
| ProtocolUsesSyncBytes |
Gets flag that determines if SEL CWS protocol parsing implementation uses synchronization bytes.
(Overrides ProtocolUsesSyncBytes) |
| PublishAnglesTauSeconds | Gets or sets the EMA time constant τ (seconds) for published phase angles. |
| PublishFrequencyTauSeconds | Gets or sets the EMA time constant τ (seconds) for published frequency. |
| PublishMagnitudesTauSeconds | Gets or sets the EMA time constant τ (seconds) for published RMS magnitudes. |
| PublishRocofTauSeconds | Gets or sets the EMA time constant τ (seconds) for published ROCOF (dF/dt). |
| QueuedBuffers |
Gets the total number of buffers that are currently queued for processing, if any.
(Inherited from MultiSourceFrameImageParserBaseSourceChannel, FrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType) |
| QueuedOutputs |
Gets the total number of parsed outputs that are currently queued for publication, if any.
(Inherited from FrameImageParserBaseFrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType) |
| ReadTimeout | Gets or sets a value, in milliseconds, that determines how long the stream will attempt to read before timing out. (Inherited from Stream) |
| RecalculationCycles | Gets or sets the number of nominal cycles between full DFT recalculations for numerical stability. |
| RedundantFramesPerPacket |
Gets the number of redundant frames in each packet.
(Inherited from FrameParserBaseTFrameIdentifier) |
| ReferenceChannel | Gets or sets the reference channel for frequency tracking. |
| RepeatLastCalculatedValueWhenDownSampling | Gets or sets flag that determines if last value should be repeated when down-sampling, i.e., when CalculationFrameRate is less than SEL CWS frame rate (commonly 3000Hz); otherwise NaN will be used. |
| RunTime |
Gets the total amount of time, in seconds, that the BinaryImageParserBase has been active.
(Inherited from BinaryImageParserBase) |
| SampleFrequencyTauSeconds | Gets or sets the EMA time constant τ (seconds) for the internal per-sample frequency smoothing that occurs inside the estimator before any down-sampling/publish filtering. |
| SampleRocofTauSeconds | Gets or sets the EMA time constant τ (seconds) for the internal per-sample ROCOF smoothing (computed from the internally smoothed frequency). |
| Status |
Gets current descriptive status of the FrameParserBaseTFrameIdentifier.
(Inherited from FrameParserBaseTFrameIdentifier) |
| TargetCycles | Gets or sets the number of nominal cycles contained in the sliding DFT analysis window. |
| TotalProcessedBuffers |
Gets the total number of buffer images processed so far.
(Inherited from BinaryImageParserBase) |
| TrustHeaderLength |
Gets or sets flag that determines if header lengths should be trusted over parsed byte count.
(Inherited from FrameParserBaseTFrameIdentifier) |
| ValidateCommandFrameCheckSum |
Gets flag based on CheckSumValidationFrameTypes property that determines if command frames are selected for check-sum validation.
(Inherited from FrameParserBaseTFrameIdentifier) |
| ValidateConfigurationFrameCheckSum |
Gets flag based on CheckSumValidationFrameTypes property that determines if configuration frames are selected for check-sum validation.
(Inherited from FrameParserBaseTFrameIdentifier) |
| ValidateDataFrameCheckSum |
Gets flag based on CheckSumValidationFrameTypes property that determines if data frames are selected for check-sum validation.
(Inherited from FrameParserBaseTFrameIdentifier) |
| ValidateHeaderFrameCheckSum |
Gets flag based on CheckSumValidationFrameTypes property that determines if header frames are selected for check-sum validation.
(Inherited from FrameParserBaseTFrameIdentifier) |
| WriteTimeout | Gets or sets a value, in milliseconds, that determines how long the stream will attempt to write before timing out. (Inherited from Stream) |
Methods
| BeginRead | Begins an asynchronous read operation. (Consider using ReadAsync(Byte, Int32, Int32) instead.) (Inherited from Stream) |
| BeginWrite | Begins an asynchronous write operation. (Consider using WriteAsync(Byte, Int32, Int32) instead.) (Inherited from Stream) |
| Close | Closes the current stream and releases any resources (such as sockets and file handles) associated with the current stream. Instead of calling this method, ensure that the stream is properly disposed. (Inherited from Stream) |
| CopyTo(Stream) | Reads the bytes from the current stream and writes them to another stream. Both streams positions are advanced by the number of bytes copied. (Inherited from Stream) |
| CopyTo(Stream, Int32) | Reads the bytes from the current stream and writes them to another stream, using a specified buffer size. Both streams positions are advanced by the number of bytes copied. (Inherited from Stream) |
| CopyToAsync(Stream) | Asynchronously reads the bytes from the current stream and writes them to another stream. Both streams positions are advanced by the number of bytes copied. (Inherited from Stream) |
| CopyToAsync(Stream, Int32) | Asynchronously reads the bytes from the current stream and writes them to another stream, using a specified buffer size. Both streams positions are advanced by the number of bytes copied. (Inherited from Stream) |
| CopyToAsync(Stream, CancellationToken) | Asynchronously reads the bytes from the current stream and writes them to another stream, using a specified cancellation token. Both streams positions are advanced by the number of bytes copied. (Inherited from Stream) |
| CopyToAsync(Stream, Int32, CancellationToken) | Asynchronously reads the bytes from the current stream and writes them to another stream, using a specified buffer size and cancellation token. Both streams positions are advanced by the number of bytes copied. (Inherited from Stream) |
| CreateWaitHandle | Allocates a WaitHandle object. (Inherited from Stream) Obsolete. |
| Dispose | Releases all resources used by the Stream. (Inherited from Stream) |
| Dispose(Boolean) |
Releases the unmanaged resources used by the FrameParserBaseTFrameIdentifier object and optionally releases the managed resources.
(Inherited from FrameParserBaseTFrameIdentifier) |
| DisposeAsync | Asynchronously releases the unmanaged resources used by the Stream. (Inherited from Stream) |
| EndRead | Waits for the pending asynchronous read to complete. (Consider using ReadAsync(Byte, Int32, Int32) instead.) (Inherited from Stream) |
| EndWrite | Ends an asynchronous write operation. (Consider using WriteAsync(Byte, Int32, Int32) instead.) (Inherited from Stream) |
| Equals | Determines whether the specified object is equal to the current object. (Inherited from Object) |
| Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object) |
| Flush |
When overridden in a derived class, clears all buffers for this stream and causes any buffered data
to be written to the underlying device.
(Inherited from BinaryImageParserBase) |
| FlushAsync | Asynchronously clears all buffers for this stream and causes any buffered data to be written to the underlying device. (Inherited from Stream) |
| FlushAsync(CancellationToken) | Asynchronously clears all buffers for this stream, causes any buffered data to be written to the underlying device, and monitors cancellation requests. (Inherited from Stream) |
| GetHashCode | Serves as the default hash function. (Inherited from Object) |
| GetLifetimeService | Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject) Obsolete. |
| GetType | Gets the Type of the current instance. (Inherited from Object) |
| InitializeLifetimeService | Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject) Obsolete. |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object) |
| MemberwiseClone(Boolean) | Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject) |
| ObjectInvariant | Provides support for a Contract. (Inherited from Stream) Obsolete. |
| OnBufferParsed |
Raises the BufferParsed event.
(Inherited from BinaryImageParserBase) |
| OnConfigurationChanged |
Raises the ConfigurationChanged event.
(Inherited from FrameParserBaseTFrameIdentifier) |
| OnDataDiscarded(Byte[]) |
Raises the DataDiscarded event.
(Inherited from MultiSourceFrameImageParserBaseSourceChannel, FrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType) |
| OnDataParsed(T3) |
Raises the DataParsed event.
(Inherited from MultiSourceFrameImageParserBaseSourceChannel, FrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType) |
| OnDuplicateTypeHandlerEncountered(Type, T1) |
Raises the DuplicateTypeHandlerEncountered event.
(Inherited from FrameImageParserBaseFrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType) |
| OnOutputTypeNotFound(T1) |
Raises the OutputTypeNotFound event.
(Inherited from FrameImageParserBaseFrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType) |
| OnParsingException |
Raises the ParsingException event.
(Overrides OnParsingException(Exception)) |
| OnReceivedChannelFrame |
Casts the parsed IChannelFrame to its specific implementation (i.e., DataFrame or ConfigurationFrame).
(Overrides FrameParserBaseTFrameIdentifierOnReceivedChannelFrame(IChannelFrame)) |
| OnReceivedCommandFrame |
Raises the ReceivedCommandFrame event.
(Inherited from FrameParserBaseTFrameIdentifier) |
| OnReceivedConfigurationFrame |
Raises the ReceivedConfigurationFrame event.
(Overrides FrameParserBaseTFrameIdentifierOnReceivedConfigurationFrame(IConfigurationFrame)) |
| OnReceivedDataFrame |
Raises the ReceivedDataFrame event.
(Inherited from FrameParserBaseTFrameIdentifier) |
| OnReceivedFrameBufferImage |
Raises the ReceivedFrameImage and ReceivedFrameBufferImage event.
(Inherited from FrameParserBaseTFrameIdentifier) |
| OnReceivedHeaderFrame |
Raises the ReceivedHeaderFrame event.
(Inherited from FrameParserBaseTFrameIdentifier) |
| OnReceivedUndeterminedFrame |
Raises the ReceivedUndeterminedFrame event.
(Inherited from FrameParserBaseTFrameIdentifier) |
| OnSourceDataParsed(T1, IList<T3>) |
Raises the SourceDataParsed event.
(Inherited from MultiSourceFrameImageParserBaseSourceChannel, FrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType) |
| OnUnknownFrameTypeEncountered |
Handles unknown frame types.
(Inherited from FrameParserBaseTFrameIdentifier) |
| Parse(ISupportBinaryImage) |
Not implemented. Consumers should call the Parse(T1, ISupportBinaryImage) method instead to make sure data source ID gets tracked with data buffer.
(Inherited from MultiSourceFrameImageParserBaseSourceChannel, FrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType) Obsolete. |
| Parse(T1, ISupportBinaryImage) |
Queues the object implementing the ISupportBinaryImage interface, from the specified data source, onto the stream for parsing.
(Inherited from MultiSourceFrameImageParserBaseSourceChannel, FrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType) |
| Parse(T1, Byte[]) |
Queues a sequence of bytes, from the specified data source, onto the stream for parsing.
(Inherited from MultiSourceFrameImageParserBaseSourceChannel, FrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType) |
| Parse(SourceChannel, Byte, Int32, Int32) |
Queues a sequence of bytes, from the specified data source, onto the stream for parsing.
(Overrides Parse(T1, Byte[], Int32, Int32)) |
| ParseCommonHeader |
Parses a common header instance that implements ICommonHeader for the output type represented
in the binary image.
(Overrides ParseCommonHeader(Byte[], Int32, Int32)) |
| ParseFrame |
Output type specific frame parsing algorithm.
(Overrides ParseFrame(Byte[], Int32, Int32)) |
| PublishParsedOutput(EventArgs<T2>) | AsyncQueue handler used to publish queued outputs.
(Inherited from FrameImageParserBaseFrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType) |
| PurgeBuffer(T1) |
Clears the internal buffer of unparsed data received from the specified source.
(Inherited from MultiSourceFrameImageParserBaseSourceChannel, FrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType) |
| Read(SpanByte) | When overridden in a derived class, reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read. (Inherited from Stream) |
| Read(Byte[], Int32, Int32) |
The parser is designed as a write only stream, so this method is not implemented.
(Inherited from BinaryImageParserBase) |
| ReadAsync(MemoryByte, CancellationToken) | Asynchronously reads a sequence of bytes from the current stream, advances the position within the stream by the number of bytes read, and monitors cancellation requests. (Inherited from Stream) |
| ReadAsync(Byte, Int32, Int32) | Asynchronously reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read. (Inherited from Stream) |
| ReadAsync(Byte, Int32, Int32, CancellationToken) | Asynchronously reads a sequence of bytes from the current stream, advances the position within the stream by the number of bytes read, and monitors cancellation requests. (Inherited from Stream) |
| ReadAtLeast | Reads at least a minimum number of bytes from the current stream and advances the position within the stream by the number of bytes read. (Inherited from Stream) |
| ReadAtLeastAsync | Asynchronously reads at least a minimum number of bytes from the current stream, advances the position within the stream by the number of bytes read, and monitors cancellation requests. (Inherited from Stream) |
| ReadByte | Reads a byte from the stream and advances the position within the stream by one byte, or returns -1 if at the end of the stream. (Inherited from Stream) |
| ReadExactly(SpanByte) | Reads bytes from the current stream and advances the position within the stream until the buffer is filled. (Inherited from Stream) |
| ReadExactly(Byte, Int32, Int32) | Reads count number of bytes from the current stream and advances the position within the stream. (Inherited from Stream) |
| ReadExactlyAsync(MemoryByte, CancellationToken) | Asynchronously reads bytes from the current stream, advances the position within the stream until the buffer is filled, and monitors cancellation requests. (Inherited from Stream) |
| ReadExactlyAsync(Byte, Int32, Int32, CancellationToken) | Asynchronously reads count number of bytes from the current stream, advances the position within the stream, and monitors cancellation requests. (Inherited from Stream) |
| Seek(Int64, SeekOrigin) |
The parser is designed as a write only stream, so this method is not implemented.
(Inherited from BinaryImageParserBase) |
| SetLength(Int64) |
The parser is designed as a write only stream, so this method is not implemented.
(Inherited from BinaryImageParserBase) |
| Start |
Start the data parser.
(Overrides Start) |
| Start(IEnumerable<Type>) |
Starts the data parser given the specified type implementations.
(Inherited from MultiSourceFrameImageParserBaseSourceChannel, FrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType) |
| Stop |
Stops the streaming data parser.
(Inherited from BinaryImageParserBase) |
| ToString | Returns a string that represents the current object. (Inherited from Object) |
| Write(ReadOnlySpanByte) | When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written. (Inherited from Stream) |
| Write(Byte[], Int32, Int32) |
Not implemented. Consumers should call the Parse(T1, Byte[], Int32, Int32) method instead to make sure data source ID gets tracked with data buffer.
(Inherited from MultiSourceFrameImageParserBaseSourceChannel, FrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType) Obsolete. |
| WriteAsync(ReadOnlyMemoryByte, CancellationToken) | Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests. (Inherited from Stream) |
| WriteAsync(Byte, Int32, Int32) | Asynchronously writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written. (Inherited from Stream) |
| WriteAsync(Byte, Int32, Int32, CancellationToken) | Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests. (Inherited from Stream) |
| WriteByte | Writes a byte to the current position in the stream and advances the position within the stream by one byte. (Inherited from Stream) |
Events
| BufferParsed |
Occurs when buffer parsing has completed.
(Inherited from BinaryImageParserBase) |
| ConfigurationChanged |
Occurs when a device sends a notification that its configuration has changed.
(Inherited from FrameParserBaseTFrameIdentifier) |
| DataDiscarded |
Occurs when data image fails deserialized due to an exception.
(Inherited from BinaryImageParserBase) |
| DataParsed |
Occurs when a data image is deserialized successfully to one of the output types that the data
image represents.
(Inherited from FrameImageParserBaseFrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType) |
| DuplicateTypeHandlerEncountered |
Occurs when more than one type has been defined that can deserialize the specified output type.
(Inherited from FrameImageParserBaseFrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType) |
| OutputTypeNotFound |
Occurs when matching an output type for deserializing the data image could not be found.
(Inherited from FrameImageParserBaseFrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType) |
| ParsingException |
Occurs when an Exception is encountered while attempting to parse data.
(Inherited from BinaryImageParserBase) |
| ReceivedChannelFrame |
Occurs when any IChannelFrame has been received.
(Inherited from FrameParserBaseTFrameIdentifier) |
| ReceivedCommandFrame |
Occurs when a ICommandFrame has been received.
(Inherited from FrameParserBaseTFrameIdentifier) |
| ReceivedConfigurationFrame | Occurs when a SEL CWS ConfigurationFrame has been received. |
| ReceivedDataFrame | Occurs when a SEL CWS DataFrame has been received. |
| ReceivedFrameBufferImage |
Occurs when a frame image has been received, event includes buffer.
(Inherited from FrameParserBaseTFrameIdentifier) |
| ReceivedFrameImage |
Occurs when a frame image has been received.
(Inherited from FrameParserBaseTFrameIdentifier) |
| ReceivedHeaderFrame |
Occurs when a IHeaderFrame has been received.
(Inherited from FrameParserBaseTFrameIdentifier) |
| ReceivedUndeterminedFrame |
Occurs when an undetermined IChannelFrame has been received.
(Inherited from FrameParserBaseTFrameIdentifier) |
| SourceDataParsed |
Occurs when a data image is deserialized successfully to one or more of the output types that the data image represents.
(Inherited from MultiSourceFrameImageParserBaseSourceChannel, FrameType, ISupportSourceIdentifiableFrameImageSourceChannel, FrameType) |
Fields
| StreamInitialized |
Tracks if data stream has been initialized.
(Inherited from BinaryImageParserBase) |
| UnparsedBuffer |
Remaining unparsed buffer from last parsing execution, if any.
(Inherited from BinaryImageParserBase) |