DP44/docs/ai/Common/DTS.Common.Serialization/Test/Module.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
Common/DTS.Common.Serialization/Test/Module/IConvertable.cs Common/DTS.Common.Serialization/Test/Module/CalculatedChannel.cs	2026-04-17T15:38:29.079561+00:00	zai-org/GLM-5-FP8	1	a6c5362a20ffc690

Documentation: DTS.Serialization.Test.Module

1. Purpose

This module defines the CalculatedChannel class and IConvertable interface within the DTS.Serialization.Test.Module namespace hierarchy. The CalculatedChannel class represents a derived data channel whose values are computed from one or more source channels, supporting XML serialization/deserialization and aggregation of multiple source channels. The IConvertable interface provides a contract for objects that can transform themselves to/from Module objects. This is part of a larger test serialization framework for capturing test measurement data.

---

2. Public Interface

DTS.Serialization.Test.Module.IConvertable (Interface)

Location: IConvertable.cs

Method	Signature	Description
ToDtsSerializationTestModule	Module ToDtsSerializationTestModule(Test parentTest)	Converts the implementing object to a Module instance, receiving the containing ParentTest as context.
FromDtsSerializationTestModule	void FromDtsSerializationTestModule(Module testModule, ReportErrors reportErrors)	Initializes the implementing object from a Module instance, with error reporting via ReportErrors delegate/callback.

---

DTS.Serialization.Test.Module.CalculatedChannel (Class)

Location: CalculatedChannel.cs
Inheritance: Inherits from AnalogInputChannel
XML Tag: [XmlSerializationTag("CalculatedChannel")]

Constructor

Signature	Description
CalculatedChannel(Module parentModule)	Constructs a new instance with a reference to its parent Module.

Properties

Property	Type	Default	XML Tag	Description
SourceChannelNumber	int[]	null	SourceChannelNumber	Array of source channel numbers this calculated channel derives from.
SourceModuleNumber	int[]	null	SourceModuleNumber	Array of source module numbers.
SourceModuleSerialNumber	string[]	null	SourceModuleSerialNumber	Array of source module serial numbers.
Calculation	string	"NONE"	Calculation	The calculation expression/formula for this channel.
T1	ulong	0	T1	Time parameter 1 (HIC-related). Only serialized if HIC is initialized.
T2	ulong	0	T2	Time parameter 2 (HIC-related). Only serialized if HIC is initialized.
HIC	double	0D	HIC	Head Injury Criterion value. Conditionally serialized.
SampleRateHz	double	0	SampleRateHz	Sample rate in Hertz.

Methods

Method	Signature	Description
WriteXml	void WriteXml(XmlWriter writer)	Serializes this object to XML. Writes HIC, T1, T2 attributes only if _HIC.IsValueInitialized is true.
ReadXml	void ReadXml(XmlReader reader)	Deserializes from XML. Calls base.ReadXml(reader) first, then populates derived properties. HIC, T1, T2 only read if HIC attribute is present and non-whitespace.
Equals	override bool Equals(object obj)	Memberwise equality check comparing: ChannelId, SourceChannelNumber, ChannelDescriptionString, EngineeringUnits, Calculation, IsoCode.
GetHashCode	override int GetHashCode()	Returns base.GetHashCode().
ToString	override string ToString()	Returns ChannelDescriptionString.
CreateInstance (static)	static CalculatedChannel CreateInstance(Channel[] channels)	Factory method creating a CalculatedChannel from multiple source channels. Validates that the maximum sample rate is a multiple of each source's sample rate. Copies properties from the first channel via reflection.
`CreateInstance