//******************************************************************************************************
// FileExporter.cs - Gbtc
//
// Copyright © 2012, Grid Protection Alliance. All Rights Reserved.
//
// Licensed to the Grid Protection Alliance (GPA) under one or more contributor license agreements. See
// the NOTICE file distributed with this work for additional information regarding copyright ownership.
// The GPA licenses this file to you under the MIT License (MIT), the "License"; you may
// not use this file except in compliance with the License. You may obtain a copy of the License at:
//
// http://www.opensource.org/licenses/MIT
//
// Unless agreed to in writing, the subject software distributed under the License is distributed on an
// "AS-IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. Refer to the
// License for the specific language governing permissions and limitations.
//
// Code Modification History:
// ----------------------------------------------------------------------------------------------------
// 12/04/2012 - J. Ritchie Carroll
// Generated original version of source code.
// 12/13/2012 - Starlynn Danyelle Gilliam
// Modified Header.
//
//******************************************************************************************************
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Text;
using GSF;
using GSF.Diagnostics;
using GSF.TimeSeries;
using GSF.TimeSeries.Adapters;
using PhasorProtocolAdapters;
namespace COMTRADEAdapters
{
///
/// Represents an action adapter that exports measurements on an interval to a COMTRADE formatted file that can be imported into other systems for analysis.
///
[Description("COMTRADE: Exports measurements to a COMTRADE formatted file that can be imported into other systems for analysis")]
public class FileExporter : CalculatedMeasurementBase
{
#region [ Members ]
/// Fields
private string m_stationName;
private string m_deviceID;
private bool m_statusDisplayed;
#endregion
#region [ Properties ]
///
/// Gets or sets station name to use in COMTRADE configuration file.
///
[ConnectionStringParameter, Description("Defines station name to use in COMTRADE configuration file.")]
public string StationName
{
get
{
return m_stationName;
}
set
{
m_stationName = value;
}
}
///
/// Gets or sets device ID to use in COMTRADE configuration file.
///
[ConnectionStringParameter, Description("Defines device ID to use in COMTRADE configuration file.")]
public string DeviceID
{
get
{
return m_deviceID;
}
set
{
m_deviceID = value;
}
}
///
/// Gets the flag indicating if this adapter supports temporal processing.
///
public override bool SupportsTemporalProcessing => false;
///
/// Returns the detailed status of the .
///
public override string Status
{
get
{
StringBuilder status = new StringBuilder();
status.AppendFormat(" Station name: {0}\r\n", m_stationName);
status.AppendFormat(" Device ID: {0}\r\n", m_deviceID);
status.Append(base.Status);
return status.ToString();
}
}
#endregion
#region [ Methods ]
private bool m_disposed;
///
/// 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.
protected override void Dispose(bool disposing)
{
if (!m_disposed)
{
try
{
// This will be done regardless of whether the object is finalized or disposed.
if (disposing)
{
}
}
finally
{
m_disposed = true; // Prevent duplicate dispose.
base.Dispose(disposing); // Call base class Dispose().
}
}
}
///
/// Initializes .
///
public override void Initialize()
{
base.Initialize();
Dictionary settings = Settings;
string setting;
// Load required parameters
if (InputMeasurementKeys == null || InputMeasurementKeys.Length == 0)
throw new InvalidOperationException("There are no input measurements defined. You must define \"inputMeasurementKeys\" to define which measurements to export.");
// Get station name
if (settings.TryGetValue("stationName", out setting))
m_stationName = setting;
else
m_stationName = Name;
// Get device ID
if (settings.TryGetValue("deviceID", out setting))
m_deviceID = setting;
// We enable tracking of latest measurements so we can use these values if points are missing
TrackLatestMeasurements = true;
}
///
/// Process frame of time-aligned measurements that arrived within the defined lag time.
///
/// of measurements that arrived within lag time and are ready for processing.
/// Index of within one second of data ranging from zero to frames per second - 1.
protected override void PublishFrame(IFrame frame, int index)
{
IDictionary measurements = frame.Measurements;
if (measurements.Count > 0)
{
// We display export status every other minute
if (new DateTime(frame.Timestamp).Minute % 2 == 0)
{
//Make sure message is only displayed once during the minute
if (!m_statusDisplayed)
{
//OnStatusMessage(string.Format("{0} successful file based measurement exports...", m_dataExporter.TotalExports));
m_statusDisplayed = true;
}
}
else
m_statusDisplayed = false;
}
else
{
// No data was available in the frame, lag time set too tight?
OnProcessException(MessageLevel.Warning, new InvalidOperationException("No measurements were available for COMTRADE file based data export, possible reasons: system is initializing , receiving no data or lag time is too small. COMTRADE File creation was skipped."));
}
}
#endregion
}
}