DP44/docs/ai/Common/DTS.Common.SerializationPlus/Control/Event/Module/Channel.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
Common/DTS.Common.SerializationPlus/Control/Event/Module/Channel/ReviewableAttribute.NotApplicableException.cs Common/DTS.Common.SerializationPlus/Control/Event/Module/Channel/DataValues.cs Common/DTS.Common.SerializationPlus/Control/Event/Module/Channel/CalculatedChannel.cs	2026-04-17T15:38:30.345685+00:00	zai-org/GLM-5-FP8	1	7405548f6ed6f3f6

Documentation: DTS.Slice.Control.Event.Module.Channel

1. Purpose

This module provides channel-related types within the DTS.Slice.Control namespace hierarchy. It defines exception types for attribute validation, data storage mechanisms for channel values (with optional memory-mapped file support), and an abstract class hierarchy for calculated channels that derive data from operations such as FFT, integration, differentiation, and vector mathematics. The module supports engineering unit-aware channels with various calculation types used in data acquisition and analysis workflows.

---

2. Public Interface

Event.Module.Channel.ReviewableAttribute.NotApplicableException

Namespace: DTS.Slice.Control

A nested exception class representing attempts to use a channel attribute that is not applicable to the associated channel. Inherits from ApplicationException.

Constructor	Signature	Description
Default	public NotApplicableException()	Initializes an instance with no message.
With Message	public NotApplicableException(string msg)	Initializes with a custom message string.
With Message and Inner	public NotApplicableException(string msg, System.Exception innerEx)	Initializes with a message and inner exception.

---

Event.Module.Channel.DataValues

Namespace: DTS.Slice.Control

Represents a channel's data storage. Inherits from Exceptional.

Constructor	Signature	Description
Default	public DataValues()	Initializes with useMemoryMappedFile = true.
Parameterized	public DataValues(bool useMemoryMappedFile)	Initializes with explicit memory-mapped file setting.

Property	Type	Access	Description
UseMemoryMappedFile	bool	get/set	Switch to use memory-mapped files instead of in-memory lists (for large data sets).

---

Event.Module.Channel.CalculatedChannel (Abstract)

Namespace: DTS.Slice.Control

Abstract base class for calculated channels. Inherits from Channel and implements Common.DAS.Concepts.DAS.Channel.IEngineeringUnitAware.

Nested Enums:

Enum	Values
Operation	Integral, Derivative, HeadInjuryCriteria, FFT, ImportedCSV, Resultant, TSR, Scale, Offset, Sine, Cosine
XUnits	msec, sec, Hz, samples

Constructor:

public CalculatedChannel(
    string name,
    XUnits xAxis,
    string yAxis,
    double[] xValues,
    double[] yValues,
    Operation calcType,
    int number,
    Module parentModule
)

Properties:

Property	Type	Access	Description
CalculationType	Operation	get	Returns the operation type for this channel.
X	double[]	get	Returns X-axis values as array.
Y	double[]	get	Returns Y-axis values as array.
XAxis	XUnits	get	Returns the X-axis unit type.
XUnitsString	string	get	Returns string representation ("Hz", "ms", "samples", "s", or "N/A").
EngineeringUnits	string	get/set	Gets or sets the Y-axis engineering units string.
SupportsADC	bool	get	Always returns false.
SupportsEU	bool	get	Always returns true.
SupportsmV	bool	get	Always returns false.
ActualMaxRangeEu	double	get	Returns _y.Max().
ActualMinRangeEu	double	get	Returns _y.Min().
DataHalfRangeValueEu	double	get	Returns midpoint of min/max Y values.
DataMaxEu	double	get	Returns _y.Max().
DataMinEu	double	get	Returns _y.Min().
DataRangeEu	double	get	Returns max of absolute min/max Y values.
DataZeroLevelAdc	short	get	Always returns 0.
IsConfigured	bool	get/set	Getter returns true; setter throws NotSupportedException.

Methods:

Method	Return Type	Behavior
ToString()	string	Returns ChannelDescriptionString or "N/A".
GetUnfilteredDataEu()	List<double>	Returns a new List<double> copy of Y values.
FromDtsSerializationTestModuleChannel(Serialization.Test.Module.Channel)	void	Throws NotSupportedException.
SetPropertyValuesFrom(DASLib.Service.DASChannel)	void	Throws NotSupportedException.
SetPropertyValuesFrom(IDiagnosticResult)	void	Throws NotSupportedException.
ToDtsSerializationTestModuleChannel(Serialization.Test.Module)	Serialization.Test.Module.Channel	Throws NotSupportedException.
ActualMaxRangeMv	double	Throws NotSupportedException.
ActualMinRangeMv	double	Throws NotImplementedException.
GetUnfilteredDataMV()	List<double>	Throws NotImplementedException.
SensorCapacityEU	double	Throws NotImplementedException.
DesiredRangeEU	double	Throws NotImplementedException.

---

Concrete Calculated Channel Classes

All inherit from CalculatedChannel and expose only constructors matching the base signature:

Class	Additional Members
IntegralCalculatedChannel	None beyond base constructor.
DerivativeCalculatedChannel	None beyond base constructor.
ScaleCalculatedChannel	None beyond base constructor.
OffsetCalculatedChannel	None beyond base constructor.
ResultantCalculatedChannel	None beyond base constructor.
AdditiveVectorCalculatedChannel	None beyond base constructor.
SineCalculatedChannel	None beyond base constructor.
CosineCalculatedChannel	None beyond base constructor.

FFTCalculatedChannel

Extends CalculatedChannel with FFT-specific data.

Constructor:

public FFTCalculatedChannel(
    string name,
    XUnits xAxis,
    string yAxis,
    double[] xValues,
    double[] yValues,
    Operation calcType,
    int number,
    Module parentModule,
    double peakFrequency
)

Property	Type	Access	Description
PeakFrequency	`double