/// <summary>
 /// Creates a new <see cref="ChannelDefinitionBase"/> from specified parameters.
 /// </summary>
 /// <param name="parent">The <see cref="IConfigurationCell"/> parent of this <see cref="ChannelDefinitionBase"/>.</param>
 /// <param name="label">The label of this <see cref="ChannelDefinitionBase"/>.</param>
 /// <param name="scale">The integer scaling value of this <see cref="ChannelDefinitionBase"/>.</param>
 /// <param name="offset">The offset of this <see cref="ChannelDefinitionBase"/>.</param>
 protected ChannelDefinitionBase(IConfigurationCell parent, string label, uint scale, double offset)
 {
     m_parent = parent;
     Label = label;
     m_scale = scale;
     m_offset = offset;
 }

        /// <summary>
        /// Creates a new <see cref="DataCell"/>.
        /// </summary>
        /// <param name="parent">The reference to parent <see cref="IDataFrame"/> of this <see cref="DataCell"/>.</param>
        /// <param name="configurationCell">The <see cref="IConfigurationCell"/> associated with this <see cref="DataCell"/>.</param>
        public DataCell(IDataFrame parent, IConfigurationCell configurationCell)
            : base(parent, configurationCell, Common.MaximumPhasorValues, Common.MaximumAnalogValues, Common.MaximumDigitalValues)
        {
            // Initialize single phasor value and frequency value with an empty value
            PhasorValues.Add(new PhasorValue(this, configurationCell.PhasorDefinitions[0]));

            // Initialize frequency and df/dt
            FrequencyValue = new FrequencyValue(this, configurationCell.FrequencyDefinition);
        }

        /// <summary>
        /// Creates a new <see cref="PhasorDefinitionBase"/> from specified parameters.
        /// </summary>
        /// <param name="parent">The <see cref="IConfigurationCell"/> parent of this <see cref="PhasorDefinitionBase"/>.</param>
        /// <param name="label">The label of this <see cref="PhasorDefinitionBase"/>.</param>
        /// <param name="scale">The integer scaling value of this <see cref="PhasorDefinitionBase"/>.</param>
        /// <param name="offset">The offset of this <see cref="PhasorDefinitionBase"/>.</param>
        /// <param name="type">The <see cref="PhasorType"/> of this <see cref="PhasorDefinitionBase"/>.</param>
        /// <param name="voltageReference">The associated <see cref="IPhasorDefinition"/> that represents the voltage reference (if any).</param>
        protected PhasorDefinitionBase(IConfigurationCell parent, string label, uint scale, double offset, PhasorType type, IPhasorDefinition voltageReference)
            : base(parent, label, scale, offset)
        {
            m_type = type;

            if (type == PhasorType.Voltage)
                m_voltageReference = this;
            else
                m_voltageReference = voltageReference;
        }

 /// <summary>
 /// Creates a new <see cref="DataCell"/>.
 /// </summary>
 /// <param name="parent">The reference to parent <see cref="IDataFrame"/> of this <see cref="DataCell"/>.</param>
 /// <param name="configurationCell">The <see cref="IConfigurationCell"/> associated with this <see cref="DataCell"/>.</param>
 public DataCell(IDataFrame parent, IConfigurationCell configurationCell)
     : base(parent, configurationCell, 0x0000, Common.MaximumPhasorValues, Common.MaximumAnalogValues, Common.MaximumDigitalValues)
 {
     // Define new parsing state which defines constructors for key data values
     State = new DataCellParsingState(
         configurationCell,
         PhasorValue.CreateNewValue,
         IEEEC37_118.FrequencyValue.CreateNewValue,
         AnalogValue.CreateNewValue,
         DigitalValue.CreateNewValue);
 }

        /// <summary>
        /// Creates a new <see cref="DataCellParsingState"/> from specified parameters.
        /// </summary>
        /// <param name="configurationCell">Reference to the <see cref="IConfigurationCell"/> associated with the <see cref="IDataCell"/> being parsed.</param>
        /// <param name="createNewPhasorValue">Reference to delegate to create new <see cref="IPhasorValue"/> instances.</param>
        /// <param name="createNewFrequencyValue">Reference to delegate to create new <see cref="IFrequencyValue"/> instances.</param>
        /// <param name="createNewAnalogValue">Reference to delegate to create new <see cref="IAnalogValue"/> instances.</param>
        /// <param name="createNewDigitalValue">Reference to delegate to create new <see cref="IDigitalValue"/> instances.</param>
        public DataCellParsingState(IConfigurationCell configurationCell, CreateNewValueFunction<IPhasorDefinition, IPhasorValue> createNewPhasorValue, CreateNewValueFunction<IFrequencyDefinition, IFrequencyValue> createNewFrequencyValue, CreateNewValueFunction<IAnalogDefinition, IAnalogValue> createNewAnalogValue, CreateNewValueFunction<IDigitalDefinition, IDigitalValue> createNewDigitalValue)
        {
            m_configurationCell = configurationCell;
            m_createNewPhasorValue = createNewPhasorValue;
            m_createNewFrequencyValue = createNewFrequencyValue;
            m_createNewAnalogValue = createNewAnalogValue;
            m_createNewDigitalValue = createNewDigitalValue;

            PhasorCount = m_configurationCell.PhasorDefinitions.Count;
            AnalogCount = m_configurationCell.AnalogDefinitions.Count;
            DigitalCount = m_configurationCell.DigitalDefinitions.Count;
        }

 /// <summary>
 /// Creates a new <see cref="FrequencyDefinition"/>.
 /// </summary>
 /// <param name="parent">The <see cref="IConfigurationCell"/> parent of this <see cref="FrequencyDefinition"/>.</param>
 public FrequencyDefinition(IConfigurationCell parent)
     : base(parent)
 {
     ScalingValue = 1000;
     DfDtScalingValue = 100;
 }

 /// <summary>
 /// Creates a new <see cref="PhasorDefinition"/> from specified parameters.
 /// </summary>
 /// <param name="parent">The <see cref="IConfigurationCell"/> parent of this <see cref="PhasorDefinition"/>.</param>
 public PhasorDefinition(IConfigurationCell parent)
     : base(parent)
 {
 }

 /// <summary>
 /// Creates a new <see cref="DigitalDefinitionBase"/> from specified parameters.
 /// </summary>
 /// <param name="parent">The <see cref="IConfigurationCell"/> parent of this <see cref="DigitalDefinitionBase"/>.</param>
 /// <param name="label">The label of this <see cref="DigitalDefinitionBase"/>.</param>
 protected DigitalDefinitionBase(IConfigurationCell parent, string label)
     : base(parent, label, 1, 0.0D)
 {
 }

 /// <summary>
 /// Creates a new <see cref="AnalogDefinition"/> from specified parameters.
 /// </summary>
 /// <param name="parent">The <see cref="IConfigurationCell"/> parent of this <see cref="AnalogDefinition"/>.</param>
 public AnalogDefinition(IConfigurationCell parent)
     : base(parent)
 {
 }

 /// <summary>
 /// Creates a new <see cref="DataCellParsingState"/> from specified parameters.
 /// </summary>
 /// <param name="configurationCell">Reference to the <see cref="IConfigurationCell"/> associated with the <see cref="IDataCell"/> being parsed.</param>
 /// <param name="createNewPhasorValue">Reference to delegate to create new <see cref="IPhasorValue"/> instances.</param>
 /// <param name="createNewFrequencyValue">Reference to delegate to create new <see cref="IFrequencyValue"/> instances.</param>
 /// <param name="createNewAnalogValue">Reference to delegate to create new <see cref="IAnalogValue"/> instances.</param>
 /// <param name="createNewDigitalValue">Reference to delegate to create new <see cref="IDigitalValue"/> instances.</param>
 /// <param name="isPdcBlockPmu">Flag that determines if associated <see cref="DataCell"/> PMU is in a PDC block.</param>
 public DataCellParsingState(IConfigurationCell configurationCell, CreateNewValueFunction<IPhasorDefinition, IPhasorValue> createNewPhasorValue, CreateNewValueFunction<IFrequencyDefinition, IFrequencyValue> createNewFrequencyValue, CreateNewValueFunction<IAnalogDefinition, IAnalogValue> createNewAnalogValue, CreateNewValueFunction<IDigitalDefinition, IDigitalValue> createNewDigitalValue, bool isPdcBlockPmu)
     : base(configurationCell, createNewPhasorValue, createNewFrequencyValue, createNewAnalogValue, createNewDigitalValue)
 {
     m_isPdcBlockPmu = isPdcBlockPmu;
 }

 /// <summary>
 /// Compares this instance to a specified <see cref="IConfigurationCell"/> object and returns an indication of their
 /// relative values.
 /// </summary>
 /// <param name="other">A <see cref="IConfigurationCell"/> object to compare.</param>
 /// <returns>
 /// A signed number indicating the relative values of this instance and value. Returns less than zero
 /// if this instance is less than value, zero if this instance is equal to value, or greater than zero
 /// if this instance is greater than value.
 /// </returns>
 public virtual int CompareTo(IConfigurationCell other)
 {
     // We sort configuration cells by ID code...
     return IDCode.CompareTo(other.IDCode);
 }

 /// <summary>
 /// Creates a new <see cref="FrequencyDefinition"/>.
 /// </summary>
 /// <param name="parent">The <see cref="IConfigurationCell"/> parent of this <see cref="FrequencyDefinition"/>.</param>
 public FrequencyDefinition(IConfigurationCell parent)
     : base(parent)
 {
 }

 /// <summary>
 /// Creates a new <see cref="DataCellBase"/> from serialization parameters.
 /// </summary>
 /// <param name="info">The <see cref="SerializationInfo"/> with populated with data.</param>
 /// <param name="context">The source <see cref="StreamingContext"/> for this deserialization.</param>
 protected DataCellBase(SerializationInfo info, StreamingContext context)
     : base(info, context)
 {
     // Deserialize data cell values
     m_configurationCell = (IConfigurationCell)info.GetValue("configurationCell", typeof(IConfigurationCell));
     m_statusFlags = info.GetUInt16("statusFlags");
     m_phasorValues = (PhasorValueCollection)info.GetValue("phasorValues", typeof(PhasorValueCollection));
     m_frequencyValue = (IFrequencyValue)info.GetValue("frequencyValue", typeof(IFrequencyValue));
     m_analogValues = (AnalogValueCollection)info.GetValue("analogValues", typeof(AnalogValueCollection));
     m_digitalValues = (DigitalValueCollection)info.GetValue("digitalValues", typeof(DigitalValueCollection));
     m_statusAssigned = true;
 }

 /// <summary>
 /// Returns a value indicating whether this instance is equal to specified <see cref="IConfigurationCell"/> value.
 /// </summary>
 /// <param name="other">A <see cref="IConfigurationCell"/> object to compare to this instance.</param>
 /// <returns>
 /// True if <paramref name="other"/> has the same value as this instance; otherwise, False.
 /// </returns>
 public bool Equals(IConfigurationCell other)
 {
     return (CompareTo(other) == 0);
 }

        // Static Methods

        // Delegate handler to create a new IEEE 1344 frequency definition
        internal static IFrequencyDefinition CreateNewDefinition(IConfigurationCell parent, byte[] binaryImage, int startIndex, out int parsedLength)
        {
            IFrequencyDefinition frequencyDefinition = new FrequencyDefinition(parent);

            parsedLength = frequencyDefinition.Initialize(binaryImage, startIndex, 0);

            return frequencyDefinition;
        }

 /// <summary>
 /// Returns a value indicating whether this instance is equal to specified <see cref="IConfigurationCell"/> value.
 /// </summary>
 /// <param name="other">A <see cref="IConfigurationCell"/> object to compare to this instance.</param>
 /// <returns>
 /// True if <paramref name="other"/> has the same value as this instance; otherwise, False.
 /// </returns>
 public bool Equals(IConfigurationCell other)
 {
     return ((object)other != null) && (CompareTo(other) == 0);
 }

 /// <summary>
 /// Creates a new <see cref="DataCell"/>.
 /// </summary>
 /// <param name="parent">The reference to parent <see cref="IDataFrame"/> of this <see cref="DataCell"/>.</param>
 /// <param name="configurationCell">The <see cref="IConfigurationCell"/> associated with this <see cref="DataCell"/>.</param>
 public DataCell(IDataFrame parent, IConfigurationCell configurationCell)
     : base(parent, configurationCell, Common.MaximumPhasorValues, Common.MaximumAnalogValues, Common.MaximumDigitalValues)
 {
 }

 /// <summary>
 /// Creates a new <see cref="AnalogDefinitionBase"/> from specified parameters.
 /// </summary>
 /// <param name="parent">The <see cref="IConfigurationCell"/> parent of this <see cref="AnalogDefinitionBase"/>.</param>
 /// <param name="label">The label of this <see cref="AnalogDefinitionBase"/>.</param>
 /// <param name="scale">The integer scaling value of this <see cref="AnalogDefinitionBase"/>.</param>
 /// <param name="offset">The offset of this <see cref="AnalogDefinitionBase"/>.</param>
 /// <param name="type">The <see cref="AnalogType"/> of this <see cref="AnalogDefinitionBase"/>.</param>
 protected AnalogDefinitionBase(IConfigurationCell parent, string label, uint scale, double offset, AnalogType type)
     : base(parent, label, scale, offset)
 {
     m_type = type;
 }

 /// <summary>
 /// Creates a new <see cref="DigitalDefinition"/>.
 /// </summary>
 /// <param name="parent">The <see cref="IConfigurationCell"/> parent of this <see cref="DigitalDefinition"/>.</param>
 public DigitalDefinition(IConfigurationCell parent)
     : base(parent)
 {
 }

 /// <summary>
 /// Creates a new <see cref="FrequencyDefinitionBase"/> from specified parameters.
 /// </summary>
 /// <param name="parent">The <see cref="IConfigurationCell"/> parent of this <see cref="FrequencyDefinitionBase"/>.</param>
 /// <param name="label">The label of this <see cref="FrequencyDefinitionBase"/>.</param>
 /// <param name="scale">The integer scaling value of this <see cref="FrequencyDefinitionBase"/>.</param>
 /// <param name="dfdtScale">The df/dt scaling value of this <see cref="FrequencyDefinitionBase"/>.</param>
 /// <param name="dfdtOffset">The df/dt offset of this <see cref="FrequencyDefinitionBase"/>.</param>
 protected FrequencyDefinitionBase(IConfigurationCell parent, string label, uint scale, uint dfdtScale, double dfdtOffset)
     : base(parent, label, scale, 0.0D)
 {
     m_dfdtScale = dfdtScale;
     m_dfdtOffset = dfdtOffset;
 }