GSF.COMTRADE

Represents an analog channel definition of the .

Default multiplier for current magnitude values.

Default multiplier for voltage magnitude values.

Default multiplier for phase angle values.

Default multiplier for frequency values.

Default multiplier for dF/dt values.

Default multiplier for an analog value.

Creates a new instance of the .

Target schema version. Determines if file type is targeting floating point.

Creates a new instance of the from an existing line image.

Line image to parse. Target schema version. Determines if file type is targeting floating point. Indicates whether to relax validation on the number of line image elements.

Gets or sets index of this .

Gets or sets name of this formatted as station_name:channel_name.

Name must be formatted as station_name:channel_name.

Gets or sets station name component of this .

Gets or sets channel name component of this .

Gets or sets the 2-character phase identifier for this .

Gets or sets phase designation of this .

Value is not a valid phase designation.

Gets or sets phasor type of this , if applicable.

Gets or sets nominal frequency of this .

Gets or sets signal kind of this .

Value is not a valid analog signal kind.

Gets or sets coordinate format of this .

Gets or sets circuit component of this .

Gets or sets units of this .

Gets or sets value multiplier of this .

Gets or sets adder of this .

Gets or sets time skew between channels of this .

Gets or sets minimum unscaled value of this .

Gets or sets maximum unscaled value of this .

Gets or sets the channel voltage or current transformer ratio primary factor of this .

Gets or sets the channel voltage or current transformer ratio secondary factor of this .

Gets or sets the primary or secondary data scaling identifier of this .

Gets derived from , if applicable to channel type.

Gets target schema version.

Converts to its string format.

Defines a minimal set of channel metadata for a COMTRADE config file.

Channel name.

Channel signal type.

Determines if channel is a digital.

Channel is assumed to be an analog if field is false.

Defines units to use for channel.

Leave null for defaults.

Defines circuit component channel.

Leave null for none.

Defines a comparison class to property sort metadata.

Compares one metadata record to another.

Left metadata record to compare. Right metadata record to compare. Comparison sort order of metadata record.

Default instance of the metadata record sorter.

Represents a digital channel definition of the .

Creates a new instance of the .

Target schema version.

Creates a new instance of the from an existing line image.

Line image to parse. Target schema version. Indicates whether to relax validation on the number of line image elements.

Gets or sets index of this .

Gets or sets name of this formatted as station_name:channel_name.

Name must be formatted as station_name:channel_name.

Gets or sets station name component of this .

Gets or sets channel name component of this .

Gets or sets the 2-character phase identifier for this .

Gets or sets circuit component of this .

Gets or sets normal state of this .

Gets target schema version.

Converts to its string format.

COMTRADE data file(s) parser.

Releases the unmanaged resources before the object is reclaimed by .

Gets or sets associated COMTRADE schema for this .

Upon assignment, any value will be used to initialize the parser's initial property when an associated data file that ends with ".cff", ".dat" or ".d00" is found to exist.

Gets or sets COMTRADE data filename. If there are more than one data files in a set, this should be set to first file name in the set, e.g., DATA123.D00.

Gets flag that determines if is a Combined File Format (.cff) file.

Gets the byte count as parsed from a Combined File Format (.cff) file targeted with binary format.

Gets or sets flag that determines if time should be inferred from sample rates.

Gets timestamp of current record.

Gets values of current record.

Gets values of current record with secondary analog channels scaled to primary values.

Gets values of current record with primary analog channels scaled to secondary values.

Gets or sets flag that determines if schemas that include a time code for a UTC offset should apply the adjustment so that timestamps are parsed as UTC.

Gets or sets target angle unit for any analog channels that are angles.

When assigned, any encountered angles will be converted to the specified unit while parsing.

Releases all the resources used by the object.

Releases the unmanaged resources used by the object and optionally releases the managed resources.

true to release both managed and unmanaged resources; false to release only unmanaged resources.

Opens all COMTRADE data file streams.

Closes all COMTRADE data file streams.

Reads next COMTRADE record.

true if read succeeded; otherwise, false if end of data set was reached.

Represents a sample rate with associated ending sample using the COMTRADE file standard, IEEE Std C37.111-1999.

Sample rate in Hertz (Hz).

Last sample number at sample rate.

Creates a new instance of the from an existing line image.

Line image to parse. Indicates whether to relax validation on the number of line image elements.

Converts to its string format.

file type enumeration.

ASCII file type.

Binary file type, analog channel size = uint16.

Binary file type, analog channel size = uint32.

Binary file type, analog channel size = float32.

time quality indicator code.

Clock locked, Normal operation.

Clock fault, time not reliable.

Clock unlocked, time within 10^1s.

Clock unlocked, time within 10^0s.

Clock unlocked, time within 10^-1s.

Clock unlocked, time within 10^-2s.

Clock unlocked, time within 10^-3s.

Clock unlocked, time within 10^-4s.

Clock unlocked, time within 10^-5s.

Clock unlocked, time within 10^-6s.

Clock unlocked, time within 10^-7s.

Clock unlocked, time within 10^-8s.

Clock unlocked, time within 10^-9s.

leap second indicator.

No leap second adjustment was added during recorded data set.

Leap second adjustment was added during recorded data set.

Leap second adjustment was subtracted during recorded data set.

Leap second adjustment not capable for recording device.

Represents the schema for a configuration file in the COMTRADE file standard, IEEE Std C37.111-1999/2013.

Creates a new instance of the .

Creates a new instance of the from an existing configuration file name.

File name of configuration file to parse.

Creates a new instance of the from an existing configuration file name.

File name of configuration file to parse. Indicates whether to relax validation on the number of line image elements.

Gets the file name used to generate this schema when constructed with one; otherwise, null.

Gets flag that determines if is a Combined File Format (.cff) file.

Gets or sets free-form station name for this .

Gets or sets free-form device ID for this .

Gets or sets version number of the IEEE Std C37.111 used by this .

Gets total number of analog and digital channels of this .

Gets total number of analog channels of this .

Gets total number of digital channels of this .

Gets or sets analog channels of this .

Gets or sets digital channels of this .

Gets or sets nominal frequency of this .

Gets or sets sampling rates of this . A file of phasor data will normally be made using a single sampling rate, so this will usually be 1.

Gets total number of sample rates of this .

Gets total number of samples, i.e., rows per timestamp, as reported by the sample rates.

Gets total number of channels values, i.e., TotalChannels * TotalSamples.

Gets or sets start timestamp of this .

Gets or sets trigger timestamp of this .

Gets or sets file type of this .

Gets or sets the multiplication factor for the time differential (timestamp) field in this .

Gets or sets UTC offset for channel timestamps - format HhMM.

Gets or sets UTC offset for timezone of recording device, or "x" for not applicable - format HhMM.

Gets or sets the time quality indicator code for the recorded data set.

Gets or sets the leap second indicator for the recorded data set.

Gets the total digital words for given number of digital values when the file type is binary.

Calculates the size of a record, in bytes, when the file type is binary.

Calculates the size of a record, in bytes, when the file type is binary32.

Calculates the size of a record, in bytes, when the file type is float32.

Gets the file image of this .

Represents a UTC time offset for COMTRADE - format HhMM.

Creates a new instance of the

Creates a new instance of the

Line image to parse.

Gets or sets UTC time offset hours.

Gets or sets UTC time offset minutes.

Gets or sets value that determines if offset is not applicable.

Gets the total value in ticks.

Converts to its string format.

Represents a timestamp in the COMTRADE file standard format, IEEE Std C37.111-1999..

Timestamp in ticks.

Creates a new instance of the from an existing line image.

Line image to parse.

Converts to its string format.

COMTRADE data and config file writer.

Defines the maximum file size for this COMTRADE implementation.

Value represents 256TB, arbitrarily chosen extreme maximum file size.

Defines the maximum COMTRADE end sample number.

Defines a carriage return and line feed constant, i.e., "\r\n".

The standard .NET constant can just be a line feed, "\n", on some operating systems, e.g., Linux, however the COMTRADE standard requires that end of line markers be both a carriage return and line feed, "\r\n".

Creates a new COMTRADE configuration .

Schema records. Station name for the schema. Device ID for the schema. Data start time. Total data samples (i.e., total number of rows). Target schema version - defaults to 1999. Determines the data file type for the schema. Time factor to use in schema - defaults to 1000. Desired sampling rate - defaults to 33.3333Hz. Nominal frequency - defaults to 60Hz. Determines if the FRACSEC word digital definitions should be included - defaults to true. New COMTRADE configuration . This function is primarily intended to create a configuration based on synchrophasor data (see Annex H: Schema for Phasor Data 2150 Using the COMTRADE File Standard in IEEE C37.111-2010), it may be necessary to manually create a schema object for other COMTRADE needs. You can call the property to return a string that can be written to a file that will be the contents of the configuration file. Linear scaling factors for analog channels, i.e., adders and multipliers, will be set to reasonable values based on the channel type. These should be adjusted as needed based on actual channel value ranges. Note that for the multiplier will be 1.0 and the adder will be 0.0 for all analog values.

Creates a new Combined File Format (.cff) COMTRADE file stream.

Target file name. Must have ".cff" extension. Schema of file stream. Lines of "INF" section to write to stream, if any. Lines of "HDR" section to write to stream, if any. Target encoding; null value will default to UTF-8 (no BOM). New file stream for Combined File Format (.cff) COMTRADE file, ready to write at data section.

Creates a new Combined File Format (.cff) COMTRADE file stream targeted for ASCII.

Target file name. Must have ".cff" extension. Schema of file stream. Lines of "INF" section to write to stream, if any. Lines of "HDR" section to write to stream, if any. Target encoding; null value will default to UTF-8 (no BOM). New stream writer for Combined File Format (.cff) COMTRADE file, ready to write at data section. For COMTRADE versions greater than 2001, any use of the term ASCII also inherently implies Unicode UTF-8. When then parameter is null, the default, UTF-8 encoding will be used for text writes. If ASCII encoding needs to be enforced for backwards compatibility reasons, then the parameter will need to be set to .

Creates a new Combined File Format (.cff) COMTRADE file stream.

Target stream. Schema of file stream. Lines of "INF" section to write to stream, if any. Lines of "HDR" section to write to stream, if any. Target encoding; null value will default to UTF-8 (no BOM).

Creates a new Combined File Format (.cff) COMTRADE file stream targeted for ASCII.

Target stream. Schema of file stream. Lines of "INF" section to write to stream, if any. Lines of "HDR" section to write to stream, if any. Target encoding; null value will default to UTF-8 (no BOM). New stream writer for Combined File Format (.cff) COMTRADE file, ready to write at data section. For COMTRADE versions greater than 2001, any use of the term ASCII also inherently implies Unicode UTF-8. When then parameter is null, the default, UTF-8 encoding will be used for text writes. If ASCII encoding needs to be enforced for backwards compatibility reasons, then the parameter will need to be set to .

Updates a Combined File Format (.cff) COMTRADE file stream with a final end sample number.

Destination stream. End sample value. Zero-based rate index to update. Target encoding; null value will default to UTF-8 (no BOM).

Updates a Combined File Format (.cff) COMTRADE file stream with a final binary byte count.

Destination stream. Binary byte count. Target encoding; null value will default to UTF-8 (no BOM).

Writes next COMTRADE record in ASCII format.

Destination stream. Source schema. Record timestamp (implicitly castable as ). Values to write - 16-bit digitals should exist as a word in an individual double value, method will write out bits. User incremented sample index. Determines if FRACSEC value should be automatically injected into stream as first digital - defaults to true. FRACSEC value to inject into output stream - defaults to 0x0000. This function is primarily intended to write COMTRADE ASCII data records based on synchrophasor data (see Annex H: Schema for Phasor Data 2150 Using the COMTRADE File Standard in IEEE C37.111-2010), it may be necessary to manually write records for other COMTRADE needs (e.g., non 16-bit digitals).

Writes next COMTRADE record in binary format.

Destination stream. Source schema. Record timestamp (implicitly castable as ). Values to write - 16-bit digitals should exist as a word in an individual double value. User incremented sample index. Determines if FRACSEC value should be automatically injected into stream as first digital - defaults to true. FRACSEC value to inject into output stream - defaults to 0x0000. This function is primarily intended to write COMTRADE binary data records based on synchrophasor data (see Annex H: Schema for Phasor Data 2150 Using the COMTRADE File Standard in IEEE C37.111-2010), it may be necessary to manually write records for other COMTRADE needs (e.g., non 16-bit digitals).

Writes next COMTRADE record in binary32 format.

Destination stream. Source schema. Record timestamp (implicitly castable as ). Values to write - 16-bit digitals should exist as a word in an individual double value. User incremented sample index. Determines if FRACSEC value should be automatically injected into stream as first digital - defaults to true. FRACSEC value to inject into output stream - defaults to 0x0000. This function is primarily intended to write COMTRADE binary32 data records based on synchrophasor data (see Annex H: Schema for Phasor Data 2150 Using the COMTRADE File Standard in IEEE C37.111-2010), it may be necessary to manually write records for other COMTRADE needs (e.g., non 16-bit digitals).

Writes next COMTRADE record in float32 format.

Destination stream. Source schema. Record timestamp (implicitly castable as ). Values to write - 16-bit digitals should exist as a word in an individual double value. User incremented sample index. Determines if FRACSEC value should be automatically injected into stream as first digital - defaults to true. FRACSEC value to inject into output stream - defaults to 0x0000. This function is primarily intended to write COMTRADE float32 data records based on synchrophasor data (see Annex H: Schema for Phasor Data 2150 Using the COMTRADE File Standard in IEEE C37.111-2010), it may be necessary to manually write records for other COMTRADE needs (e.g., non 16-bit digitals).

Writes next COMTRADE record in ASCII format.

Destination stream. Source schema. Record timestamp (implicitly castable as ). Values to write for analog channels. Values to write for digital channels. User incremented sample index. Determines if FRACSEC value should be automatically injected into stream as first digital - defaults to false. FRACSEC value to inject into output stream - defaults to 0x0000. This function is primarily intended to write COMTRADE ASCII data records based on synchrophasor data (see Annex H: Schema for Phasor Data 2150 Using the COMTRADE File Standard in IEEE C37.111-2010), it may be necessary to manually write records for other COMTRADE needs (e.g., non 16-bit digitals).

Writes next COMTRADE record in binary format.

Destination stream. Source schema. Record timestamp (implicitly castable as ). Values to write for analog channels. Values to write for digital channels. User incremented sample index. Determines if FRACSEC value should be automatically injected into stream as first digital - defaults to false. FRACSEC value to inject into output stream - defaults to 0x0000. This function is primarily intended to write COMTRADE binary data records based on synchrophasor data (see Annex H: Schema for Phasor Data 2150 Using the COMTRADE File Standard in IEEE C37.111-2010), it may be necessary to manually write records for other COMTRADE needs (e.g., non 16-bit digitals).

Writes next COMTRADE record in binary32 format.

Destination stream. Source schema. Record timestamp (implicitly castable as ). Values to write for analog channels. Values to write for digital channels. User incremented sample index. Determines if FRACSEC value should be automatically injected into stream as first digital - defaults to false. FRACSEC value to inject into output stream - defaults to 0x0000. This function is primarily intended to write COMTRADE binary32 data records based on synchrophasor data (see Annex H: Schema for Phasor Data 2150 Using the COMTRADE File Standard in IEEE C37.111-2010), it may be necessary to manually write records for other COMTRADE needs (e.g., non 16-bit digitals).

Writes next COMTRADE record in float32 format.

Destination stream. Source schema. Record timestamp (implicitly castable as ). Values to write for analog channels. Values to write for digital channels. User incremented sample index. Determines if FRACSEC value should be automatically injected into stream as first digital - defaults to false. FRACSEC value to inject into output stream - defaults to 0x0000. This function is primarily intended to write COMTRADE float32 data records based on synchrophasor data (see Annex H: Schema for Phasor Data 2150 Using the COMTRADE File Standard in IEEE C37.111-2010), it may be necessary to manually write records for other COMTRADE needs (e.g., non 16-bit digitals).