/// <summary>
/// The Copy Constructor.
/// Creates a new copy of the data value from the
/// original data value. The new copy is not associated
/// with any series or data file.
/// </summary>
/// <param name="original"></param>
public DataValue(DataValue original)
{
CensorCode = original.CensorCode;
DataFile = null;
Series = null;
DateTimeUTC = original.DateTimeUTC;
LocalDateTime = original.LocalDateTime;
OffsetType = original.OffsetType;
OffsetValue = original.OffsetValue;
Qualifier = original.Qualifier;
Sample = original.Sample;
UTCOffset = original.UTCOffset;
ValueAccuracy = original.ValueAccuracy;
Value = original.Value;
}
/// <summary>
/// Reads the DataValues section
/// </summary>
protected override IList<Series> ReadDataValues(XmlReader r)
{
int valueCount;
var lst = new List<DataValueWrapper>(Int32.TryParse(r.GetAttribute("count"), out valueCount) ? valueCount : 4);
var qualifiers = new Dictionary<string, Qualifier>();
var methods = new Dictionary<string, Method>();
var sources = new Dictionary<string, Source>();
var qualityControlLevels = new Dictionary<string, QualityControlLevel>();
var samples = new Dictionary<string,Sample>();
var offsets = new Dictionary<string, OffsetType>();
var seriesDictionary = new Dictionary<string, Series>();
while (r.Read())
{
if (r.NodeType == XmlNodeType.Element)
{
if (r.Name == "value")
{
//create a new empty data value and add it to the list
var wrapper = new DataValueWrapper();
var val = new DataValue();
wrapper.DataValue = val;
lst.Add(wrapper);
if (r.HasAttributes)
{
var censorCode = r.GetAttribute("censorCode");
if (!string.IsNullOrEmpty(censorCode))
{
val.CensorCode = censorCode;
}
//fix by Jiri - sometimes the dateTime attribute is uppercase
var localDateTime = r.GetAttribute("dateTime");
if (string.IsNullOrEmpty(localDateTime))
{
localDateTime = r.GetAttribute("DateTime");
}
val.LocalDateTime = Convert.ToDateTime(localDateTime, CultureInfo.InvariantCulture);
val.DateTimeUTC = val.LocalDateTime;
val.UTCOffset = 0.0;
//method
var methodID = r.GetAttribute("methodID");
if (String.IsNullOrEmpty(methodID))
{
methodID = "0"; //when a method ID is unspecified
}
if (!methods.ContainsKey(methodID))
{
var newMethod = Method.Unknown;
methods.Add(methodID, newMethod);
}
wrapper.MethodID = methodID;
//quality control level
string qualityCode = r.GetAttribute("qualityControlLevel");
if (String.IsNullOrEmpty(qualityCode))
{
qualityCode = "unknown"; //when the quality control level is unspecified
}
if (!qualityControlLevels.ContainsKey(qualityCode))
{
var qualControl = QualityControlLevel.Unknown;
qualControl.Code = qualityCode;
qualControl.Definition = qualityCode;
qualControl.Explanation = qualityCode;
qualityControlLevels.Add(qualityCode, qualControl);
}
//source
var sourceID = r.GetAttribute("sourceID");
if (String.IsNullOrEmpty(sourceID))
{
sourceID = "0"; //when a source ID is unspecified
}
if (!sources.ContainsKey(sourceID))
{
sources.Add(sourceID, Source.Unknown);
}
wrapper.SourceID = sourceID;
wrapper.SeriesCode = SeriesCodeHelper.CreateSeriesCode(methodID, qualityCode, sourceID); //----method-source-qualityControl combination----
//sample
var sampleID = r.GetAttribute("sampleID");
if (!String.IsNullOrEmpty(sampleID))
{
if (!samples.ContainsKey(sampleID))
{
samples.Add(sampleID, Sample.Unknown);
}
}
wrapper.SampleID = sampleID;
//qualifiers
string qualifierCodes = r.GetAttribute("qualifiers");
if (!String.IsNullOrEmpty(qualifierCodes))
{
if (!qualifiers.ContainsKey(qualifierCodes))
{
var newQualifier = new Qualifier {Code = qualifierCodes};
qualifiers.Add(qualifierCodes, newQualifier);
val.Qualifier = newQualifier;
}
else
{
val.Qualifier = qualifiers[qualifierCodes];
}
}
//vertical offset
var offsetID = r.GetAttribute("offsetTypeID");
if (!String.IsNullOrEmpty(offsetID))
{
if (!offsets.ContainsKey(offsetID))
{
offsets.Add(offsetID, new OffsetType());
}
var offsetValue = r.GetAttribute("offsetValue");
if (!String.IsNullOrEmpty(offsetValue))
{
val.OffsetValue = Convert.ToDouble(offsetValue, CultureInfo.InvariantCulture);
}
}
wrapper.OffsetID = offsetID;
//data value
val.Value = Convert.ToDouble(r.ReadString(), CultureInfo.InvariantCulture);
}
}
else if (r.Name == "method")
{
var method = ReadMethod(r);
var methodCodeKey = method.Code.ToString(CultureInfo.InvariantCulture);
if (methods.ContainsKey(methodCodeKey))
{
methods[methodCodeKey] = method;
}
}
else if (r.Name == "source")
{
var source = ReadSource(r);
var sourceCodeKey = source.OriginId.ToString(CultureInfo.InvariantCulture);
if (sources.ContainsKey(sourceCodeKey))
{
sources[sourceCodeKey] = source;
}
}
else if (r.Name == "qualityControlLevel")
{
//quality control level seems to be included with each value
}
else if (r.Name == "qualifier")
{
ReadQualifier(r, qualifiers);
}
else if (r.Name == "offset")
{
ReadOffset(r, offsets);
}
}
}
//to assign special properties of each data value
foreach (var wrapper in lst)
{
var val = wrapper.DataValue;
//which series does the data value belong to?
var seriesCode = wrapper.SeriesCode;
if (!seriesDictionary.ContainsKey(seriesCode))
{
var newSeries = new Series();
seriesDictionary.Add(seriesCode, newSeries);
//assign method, source and qual.control level
//assign method, source and qual.control level
try
{
newSeries.Method = methods[SeriesCodeHelper.GetMethodCode(seriesCode)];
//fix by Jiri: fixes the case when sourceID is unspecified sources
//has more than one source entry
string sourceCode = SeriesCodeHelper.GetSourceCode(seriesCode);
if (sourceCode == "0" && sources.Count > 0)
{
foreach (string sc in sources.Keys)
{
if (sc != "0")
{
sourceCode = sc;
break;
}
}
}
newSeries.Source = sources[sourceCode];
newSeries.QualityControlLevel = qualityControlLevels[SeriesCodeHelper.GetQualityCode(seriesCode)];
}
catch { }
}
//add the data value to the correct series
var series = seriesDictionary[seriesCode];
series.DataValueList.Add(val);
val.Series = series;
Sample sample;
if (!string.IsNullOrEmpty(wrapper.SampleID) &&
samples.TryGetValue(wrapper.SampleID, out sample))
{
val.Sample = sample;
}
OffsetType offset;
if (!string.IsNullOrEmpty(wrapper.OffsetID) &&
offsets.TryGetValue(wrapper.OffsetID, out offset))
{
val.OffsetType = offset;
}
if (series.Method == null)
{
series.Method = methods[wrapper.MethodID];
}
if (series.Source == null)
{
series.Source = sources[wrapper.SourceID];
}
}
//to check the qualifiers
CheckQualifiers(qualifiers);
return seriesDictionary.Values.ToList();
}
/// <summary>
/// Adds a data value to the end of this series
/// </summary>
/// <param name="time">the local observation time of the data value</param>
/// <param name="value">the observed value</param>
/// <param name="utcOffset">the difference between UTC and local time</param>
/// <param name="qualifier">the qualifier (contains information about specific
/// observation conditions</param>
/// <returns>the DataValue object</returns>
public virtual void AddDataValue(DateTime time, double value, double utcOffset, Qualifier qualifier)
{
var val = new DataValue(value, time, utcOffset) {Qualifier = qualifier};
AddDataValue(val);
}
/// <summary>
/// Adds a data value to the end of this series
/// </summary>
/// <param name="time">the local observation time of the data value</param>
/// <param name="value">the observation value</param>
/// <returns>the DataValue object</returns>
public virtual void AddDataValue(DateTime time, double value)
{
var val = new DataValue(value, time, 0.0);
AddDataValue(val);
}
/// <summary>
/// Associates an existing data value with this data series
/// </summary>
/// <param name="val"></param>
public virtual void AddDataValue(DataValue val)
{
DataValueList.Add(val);
val.Series = this;
UpdateSeriesInfoFromDataValues();
}
/// <summary>
/// Reads DataValues from a Series
/// </summary>
/// <param name="XmlNodeList"></param>
private Series ReadDataSeries(XmlDocument xml)
{
Series newSeries = new Series();
XmlNodeList tvps = GetTVPList(xml);
GetSeriesMetadata(xml, newSeries);
GetDefaultNodeMetadata(xml, newSeries);
//add Begin and End datetime to the series
try
{
XmlNode begin = xml.GetElementsByTagName("gml:beginPosition").Item(0);
XmlNode end = xml.GetElementsByTagName("gml:endPosition").Item(0);
if (begin.InnerText.Length > 19)
newSeries.BeginDateTime = Convert.ToDateTime(begin.InnerText.Remove(19));
else
newSeries.BeginDateTime = Convert.ToDateTime(begin.InnerText);
if (end.InnerText.Length > 19)
newSeries.EndDateTime = Convert.ToDateTime(end.InnerText.Remove(19));
else
newSeries.EndDateTime = Convert.ToDateTime(end.InnerText);
}
catch { }
//add each Time-Value-Pair to the series
foreach (XmlNode tvp in tvps)
{
Double value = -9999;
DateTime time = new DateTime();
double utcOffset = 0;
//parse Time-Value-Pair
foreach (XmlNode child in tvp.ChildNodes)
{
if (!String.IsNullOrEmpty(child.Name))
{
if (child.Name.ToLower() == "wml2:value" && child.InnerText != "")
value = Double.Parse(child.InnerText);
if (child.Name.ToLower() == "wml2:time" && child.InnerText != "")
{
String dateTime = child.InnerText;
String utcoffset = "Z";
if (dateTime.Length > 19)
{
utcoffset = dateTime.Substring(19);
dateTime = dateTime.Remove(19);
}
time = Convert.ToDateTime(dateTime);
if (utcoffset.ToLower() == "z")
utcOffset = 0;
else
utcOffset = ConvertUtcOffset(utcoffset);
}
if (child.Name.ToLower() == "wml2:metadata" && child.InnerText != "")
GetNodeMetadata(child, newSeries);
}
}
//add parsed Time-Value-Pair to series
DataValue dataValue = new DataValue(value, time, utcOffset);
newSeries.DataValueList.Add(dataValue);
dataValue.Series = newSeries;
}
return newSeries;
}
