DP44/docs/ai/Common/DTS.Common/Classes/TestSetups.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
Common/DTS.Common/Classes/TestSetups/SimpleHardware.cs Common/DTS.Common/Classes/TestSetups/TestSetupHelper.cs Common/DTS.Common/Classes/TestSetups/ExtraProperties.cs Common/DTS.Common/Classes/TestSetups/ROIPeriodChannelRecord.cs Common/DTS.Common/Classes/TestSetups/TestSetupHardwareRecord.cs Common/DTS.Common/Classes/TestSetups/TestSetupROIsRecord.cs Common/DTS.Common/Classes/TestSetups/CalculatedChannelRecord.cs Common/DTS.Common/Classes/TestSetups/ISFFile.cs Common/DTS.Common/Classes/TestSetups/GraphRecord.cs Common/DTS.Common/Classes/TestSetups/RegionOfInterest.cs Common/DTS.Common/Classes/TestSetups/ISFSensorRecord.cs	2026-04-17T15:31:22.274945+00:00	zai-org/GLM-5-FP8	1	061f25a4b5f73dbc

Documentation: DTS.Common.Classes.TestSetups

1. Purpose

This module provides the data structures and helper utilities for defining, serializing, and managing test configurations within the DTS system. It encompasses hardware definitions (SimpleHardware, TestSetupHardwareRecord), data processing configurations (CalculatedChannelRecord, RegionOfInterest), graph layouts (GraphRecord), and legacy file format handling (ISFFile, ISFSensorRecord). It serves as the domain model layer mapping database records and interface contracts to concrete classes used throughout the application.

2. Public Interface

SimpleHardware

Inherits from Tuple<string, string, int, int>. A lightweight immutable container for hardware identification.

• SimpleHardware(string serialNumber, string parentDAS, int dasId, int dasType) — Constructor.
• string SerialNumber — Gets Item1.
• string ParentDAS — Gets Item2.
• int DASId — Gets Item3.
• int DASType — Gets Item4.

TestSetupHelper

Abstract class providing static management of test setup names.

• static void ClearTestSetupNames() — Clears the internal dictionary.
• static void SetTestSetupName(int id, string name) — Maps an ID to a name.
• static string GetTestSetupName(int Id) — Retrieves a name by ID; returns string.Empty if not found.

ExtraProperty

Implements IExtraProperty. A key-value pair supporting INotifyPropertyChanged and UI commands.

• ExtraProperty() — Default constructor.
• ExtraProperty(string key, string value) — Constructor initializing key/value.
• ExtraProperty(IExtraProperty iep) — Copy constructor.
• string Key — Gets or sets the property key.
• string Value — Gets or sets the property value.
• ICommand PasteCommand — Gets or sets a command for paste operations (ignored by JSON serialization).
• UIItemStatus ItemStatus — Gets or sets the UI status (ignored by JSON serialization).
• event PropertyChangedEventHandler PropertyChanged — Notification event.

ROIPeriodChannelRecord

Implements IROIPeriodChannelRecord. Represents a channel within a Region of Interest period.

• ROIPeriodChannelRecord(IDataReader reader, int storedProcedureVersionToUse) — Constructs a record from a data reader.
• int TestSetupROIId — Foreign key to the ROI table.
• string ChannelName — Name of the channel.
• long ChannelId — ID of the channel; defaults to -1 if storedProcedureVersionToUse is below Constants.ROIPERIODCHANNELS_CHANNELID_DB_VERSION.

TestSetupHardwareRecord

Implements ITestSetupHardwareRecord. Represents hardware configuration for a test setup.

• TestSetupHardwareRecord() — Default constructor.
• TestSetupHardwareRecord(IDataReader reader, int storedProcedureVersionToUse) — Constructs from database reader.
• TestSetupHardwareRecord(ITestSetupHardwareRecord copy) — Copy constructor.
• int DASId, int TestSetupId, bool AddDAS, int SamplesPerSecond, bool IsClockMaster, byte PTPDomainId, int AntiAliasFilterRate — Configuration properties.

TestSetupROIsRecord

Implements ITestSetupROIRecord. Represents a Region of Interest definition.

• TestSetupROIsRecord(IDataReader reader) — Constructs from database reader.
• int TestSetupROIId, int TestSetupId, string Suffix, double ROIStart, double ROIEnd, bool IsEnabled, bool IsDefault — ROI properties.

CalculatedChannelRecord

Implements ICalculatedChannelRecord. Defines a derived channel based on operations on other channels.

• CalculatedChannelRecord() — Default constructor.
• CalculatedChannelRecord(ICalculatedChannelRecord record) — Copy constructor.
• CalculatedChannelRecord(IDataReader reader) — Constructs from database reader.
• string Name, string TestSetupName, int Id, Operations Operation, string CalculatedValueCode, string[] InputChannelIds, string CFCForInputChannels, string ChannelFilterClassForOutput, int TestSetupId, bool ViewInRealtime, int ClipLength — Calculation definition properties.

ISFFile

Handles reading/writing ISF (fixed-width) files.

• ISFFile() — Constructor initializing header lines with spaces.
• char[] HeaderLine1, char[] TestSetupName, char[] NumberOfRecords, char[] TestType, char[] TestDivision, char[] TCFile — Header metadata properties.
• IISFSensorRecord[] Records — Gets the list of sensor records.
• void AddRecord(IISFSensorRecord record) — Adds a sensor record and updates the record count.
• void WriteToFile(string pathToFile) — Writes the header and records to a binary file.
• void AddSensors(ISensorData[] sensors) — Converts ISensorData array to ISFSensorRecord and adds them.

ArrayExtensions (Static class in ISFFile.cs)

• void Fill<T>(this T[] sourceArray, T with) — Fills array with a specific value.
• void SubFill<T>(this T[] source, T with, int startIndex, int finalIndex) — Fills a range of the array.
• void SetValues<T>(this T[] source, T[] with, int startIndex, int length, T pad) — Copies values into a range, padding if necessary.
• T[] GetValues<T>(this T[] source, int startIndex, int length) — Extracts a segment of the array.

GraphRecord

Implements IGraphRecord. Defines a graph layout for a test setup.

• GraphRecord() — Default constructor.
• GraphRecord(IGraphRecord copy) — Copy constructor.
• GraphRecord(IDataReader reader) — Constructs from database reader.
• int GraphId, int TestSetupId, string GraphName, string GraphDescription, string ChannelsString, string ThresholdsString — Identification and content.
• bool UseDomainMin, double DomainMin, bool UseDomainMax, double DomainMax — Domain axis settings.
• bool UseRangeMin, double RangeMin, bool UseRangeMax, double RangeMax — Range axis settings.
• bool LocalOnly — Deprecated property for DB synchronization.

RegionOfInterest

Implements IRegionOfInterest. A mutable ROI definition with validation and event aggregation.

• static bool Deserializing — Flag to suppress change notifications during deserialization.
• RegionOfInterest(), RegionOfInterest(bool isDefault), RegionOfInterest(string suffix, bool isDefault, double start, double end) — Constructors.
• string Suffix — Automatically prepends "_" if missing.
• double Start, double End — Time boundaries; enforce Start < End via adjustment.
• bool IsEnabled, bool IsDefault — State flags.
• string[] ChannelNames, long[] ChannelIds — Associated channels.
• void ResetSuffix() — Clears the suffix.
• void SetChannelNamesNoNotify(string[] names), void SetChannelIdsNoNotify(long[] ids) — Mutators that bypass NotifyChanged.
• static string GetAnalogChanName(...) — Formats channel names for specific hardware types.
• static string GetChanName(...) — Formats channel names based on serial number and hardware.
• static string RemoveParentDASName(string entireChannelName) — Strips parent DAS prefix.
• static string RemoveAssignedByIDFromHardwareString(string chHardware) — Cleans up hardware string formatting.

ISFSensorRecord

Implements IISFSensorRecord. Represents a sensor in an ISF file (4 records of