noisedestroyers/DP44
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
DP44/enriched-qwen3-coder-next/Common/DTS.Common.DataModel.md
noisedestroyers bc3ac1d4c9 init
2026-04-17 14:55:32 -04:00

14 KiB
Raw Permalink Blame History

source_files, generated_at, model, schema_version, sha256
source_files generated_at model schema_version sha256
Common/DTS.Common.DataModel/ApplicationProperties.cs
Common/DTS.Common.DataModel/CollectDataProcess.cs
Common/DTS.Common.DataModel/SysBuiltObjectType.cs
Common/DTS.Common.DataModel/DataModelSettings.cs
Common/DTS.Common.DataModel/DataFiles.cs
Common/DTS.Common.DataModel/ChannelRepresentation.cs
Common/DTS.Common.DataModel/DASFactory.cs
2026-04-16T14:15:08.439336+00:00 zai-org/GLM-5-FP8 1 d315c00965ab6aef

DTS.Common.DataModel Module Documentation

1. Purpose

This module provides the core data model and application-wide state management for the DTS data acquisition system. It contains global application properties, configuration settings, hardware abstraction for channel representation, data file management utilities, and the DAS (Data Acquisition System) factory wrapper for device discovery and communication. The module serves as a central hub connecting hardware abstraction, user context, ISO standards, and file system operations.

2. Public Interface

ApplicationProperties (static class)

Global application state container.

Property Type Description
CurrentUser User Gets or sets the currently logged-in user.
DASFactory DASFactory Gets or sets the DAS factory instance for device management.
CurrentView User Gets or sets the current view context user.
IsoDb ISO13499FileDb Gets or sets the ISO 13499 database reference.
LicenseValidationResult ValidationResult Gets or sets the license validation result.
CanCurrentUserCommitChannelCodes bool Gets or sets whether the current user can commit channel codes.

CollectDataProcess : BasePropertyChanged

Represents a data collection process with visual properties.

Member Signature Description
Constructor CollectDataProcess(string name, Color color) Initializes with name and background color.
Name string Gets or sets the process name.
BackgroundColor Color Gets or sets the background color.
IsEnabled bool Gets or sets whether the process is enabled.

SysBuiltObjectType

Container for Dynamic Groups of a given test object type (Vehicle 1, Vehicle 2, Sled, etc.).

Member Signature Description
Constructor SysBuiltObjectType(string testObjectType) Initializes with a test object type string.
TestObject MMETestObjects Gets or sets the test object via ISO database lookup.
ISOTestObjectType string Gets the ISO test object type text (L1).
ToString() override string Returns TestObject.Text_L1.

DataModelSettings (static class)

Configuration settings with default values.

Property Type Default Description
UseISOCodeForDiadem200 bool false ISO code setting for Diadem 200.
SampleRateAAFilterRatio byte 5 Anti-aliasing filter ratio.
SupportedSquibFireModes string "CAP,CONSTANT" Supported squib fire modes.
ShowCompactHardware bool true Compact hardware display toggle.
AllowedVoltageInsertionErrorPercent double 1 Allowed voltage insertion error percentage.
AllowedExcitationErrorPercent double 2 Allowed excitation error percentage.
AllowedShuntErrorPercent double 5 Allowed shunt error percentage.
ShuntToleranceHighOhmPercent double 10 Shunt tolerance high ohm percentage.
AllowedGainErrorPercent double 2 Allowed gain error percentage.
AllowedGainErrorPercent_SLICE6andSLICE6A double 5 Gain error percentage for SLICE6/SLICE6A.
AutoZeroPercentDeviationAllowed double 5 Auto-zero deviation allowance.
ShuntToleranceHighOhmResistance double 4000 Shunt tolerance high ohm resistance.
DownloadFolder string "..\\..\\Data" Default download folder path.
RequireXCrashCompatibilityForISOExports bool true XCrash compatibility requirement.
DisplayDuplicateUDPStreamOutWarning bool true Duplicate UDP stream warning toggle.
SLICETurnOffAAFRealtime bool true SLICE anti-aliasing filter realtime toggle.
UseTestChannelOrder bool false Test channel order usage.
RealtimeSampleRateAAFilterRatio byte 1 Realtime sample rate AA filter ratio.
ArmChecklistRequiredIfTOM bool true Arm checklist requirement for TOM.
TestsRequireLevelTriggers bool false Level trigger requirement.
CheckUnitsIntervalMillisecond int 50 Units check interval in milliseconds.
SemaphoreDelay double 10 Semaphore delay value.
SemaphoreSpots int 3 Number of semaphore spots.
SLICEConcurrentSpots int 999 SLICE concurrent spots.
SLICEConcurrentDelayMs int 0 SLICE concurrent delay in ms.
MulticastAutoDiscoveryReceiveTimeoutMS int 1500 Multicast discovery timeout.
LocalKeepAliveRetryIntervalMS uint 1000 Local keep-alive retry interval.
LocalKeepAliveTimeOutMS uint 5000 Local keep-alive timeout.
RemoteKeepAliveRetryIntervalSeconds uint 5 Remote keep-alive retry interval.
RemoteKeepAliveSeconds uint 60 Remote keep-alive timeout.
ReceiveBufferSizeBytes int 65536 Receive buffer size.
SendBufferSizeBytes int 65536 Send buffer size.
HeartbeatAsyncConnectTimeoutMS int 10000 Heartbeat async connect timeout.
DefaultTDCSensorDatabaseFolder string "..\\SensorDatabase" Default TDC sensor database folder.
DefaultTDCSensorDatabaseFile string "SensorDatabase.CSV" Default TDC sensor database file.
TDCSensorDatabaseExportUseCurrentLocale bool false TDC export locale setting.
TDCSensorDatabaseImportEncoding string "Shift-JIS" TDC import encoding.

DataFiles : BasePropertyChanged

Represents metadata for a test data file.

Member Signature Description
Constructor DataFiles(string expandCollapse, string testName, string id, string allOrROI, string lab, string customer, DateTime dateCreated, string description, string numberOfChannels, string testEngineer, bool isTSRAIR, string roiSuffix = "") Initializes all file metadata properties.
LongString string Gets or sets a long string representation.
TestSelected bool Gets or sets test selection state.
ExpandCollapse string Gets or sets expand/collapse state ("+", "-", or empty).
TestId string Gets or sets the test ID.
TestName string Gets or sets the test name.
AllOrROI string Gets or sets whether this is "All" or ROI data.
Lab string Gets or sets the lab name.
Customer string Gets or sets the customer name.
DateCreated DateTime Gets or sets the creation date.
Description string Gets or sets the description.
NumberOfChannels string Gets or sets the channel count.
TestEngineer string Gets or sets the test engineer name.
ROISuffix string Gets or sets the ROI suffix.
DTSFile string Gets or sets the DTS file location (populated in export tab).
IsTSRAIR bool Gets or sets whether this is a TSR AIR test.

DataFilesList : BasePropertyChanged

Manages collections of DataFiles with file system traversal.

Member Signature Description
DownloadFolder string Field storing the download folder path.
GetAllFiles(string testName) DataFiles[] Returns all data files for a given test name by traversing folders.
Contract(DataFiles df) DataFiles[] Collapses the list, removing expanded items for the given test name.
GetAllDataFiles() DataFiles[] Returns top-level data file entries for all tests.
DataFiles DataFiles[] Gets or sets the data files list.
DataFileList static DataFilesList Singleton instance accessor.

ChannelRepresentation

Handles channel number conversion and display for various hardware types.

Member Signature Description
ChannelTypeEnum enum Values: SQUIB, TOMDigital, DigitalInput, Other.
Constructor ChannelRepresentation(DASHardware h, DASChannel c, int startingChannelNumber) Creates representation from DAS hardware and channel.
Constructor ChannelRepresentation(HardwareChannel c, int startingChannelNumber, IDASHardware[] hardwares = null) Creates representation from hardware channel.
DASSerialNumber string Gets or sets the DAS serial number.
SerialNumber string Gets or sets the module serial number.
ChannelNumberString string Gets the formatted channel number string with prefix.
ChannelNumber int Gets the numeric channel number.

DASFactory

Wrapper around DTS.DASLib.DASFactory.DASFactory for device discovery and management.

Member Signature Description
Constructor DASFactory() Initializes the factory, semaphores, and event handlers.
StartMulticastAutoDiscovery() void Starts auto-discovery process if not running.
StopMulticastAutoDiscovery() void Stops auto-discovery process.
GetDiscoveredDevices() IDiscoveredDevice[] Returns discovered devices.
GetDASFactory() IDASFactory Returns the underlying IDASFactory interface.
TakeOwnership() void Takes ownership of devices.
DetachAllDevices(bool detachUSB = false) void Detaches all devices; USB detaching is conditional.
DisposeFactory() void Disposes the underlying factory.
TDASHostNames string[] Gets or sets TDAS host names.
SPFDHostNames string[] Gets or sets SPFD host names.
SDBHostNames string[] Gets or sets SliceDB host names.
AutoDiscoverMulticast() SortableBindingList<IDiscoveredDevice> Performs multicast auto-discovery.
DiscoveryThread(DFConstantsAndEnums.MultiCastDeviceClasses[] deviceFilter, CancellationToken ct, bool discoverParents = true) void Background thread for continuous discovery.
StartQATSListening() void Starts QATS listening.
StopQATSListening() void Stops QATS listening.
SendQATSRequest() void Sends UDP QATS request.
GetQATS() IUDPQATSEntry[] Returns waiting QATS entries and clears the list.
MulticastAutoDiscoveryReceiveTimeoutMS int Gets or sets multicast discovery timeout.
MulticastAutoDiscoveryAddress string Gets or sets multicast address.
MulticastAutoDiscoveryPort int Gets or sets multicast transmit port.
MulticastAutoDiscoveryResponsePort int Gets or sets multicast response port.
S6ConnectNewTimeout double Gets or sets SLICE6 connect timeout.
Refresh(bool wait) void Refreshes device list; prevents overlapping refreshes.
GetActiveDevices() List<IDASCommunication> Returns list of active DAS communications.
GetReportedConnections() string[] Returns all reported connections from distributors.
AutoDiscoverIfNecessary() void Runs auto-discovery for SLICE6/SLICE6Db downstream MAC addresses.
IsStreaming(IDASCommunication das) static bool Returns true if DAS is streaming.
IsInRealtime(IDASCommunication das) static bool Returns true if unit is in realtime or streaming.
AnyInRealtime(List<IDASCommunication> das) static bool Returns true if any unit is in realtime or streaming.

Events:

  • OnDeviceArrived - DASFactoryEventHandler
  • OnFactoryChanged - DASFactoryEventHandler
  • DiscoveredDAS - DiscoveredDASEventHandler

3. Invariants

  1. ApplicationProperties singleton state: All properties are static and globally accessible; consumers must ensure thread-safe access patterns.

  2. DataFilesList singleton: The DataFileList property uses lazy initialization and returns a single shared instance.

  3. DASFactory refresh concurrency: The _bInRefresh flag prevents overlapping refresh calls. If Refresh is called while already refreshing, the second call is logged but ignored.

  4. ChannelRepresentation hardware type handling: The ConvertChannelNumbers method must receive valid HardwareTypes enum values; unknown types fall through to a default case that uses the starting channel number directly.

  5. DataFiles folder structure: GetFoldersWithData expects folders containing both .dts and .chn files; folders missing either are excluded.

  6. SysBuiltObjectType ISO lookup: The TestObject getter relies on ApplicationProperties.IsoDb being initialized; null IsoDb will cause runtime errors.

4. Dependencies

This module depends on:

  • DTS.Slice.Users - User types
  • DTS.Common.ISO - ISO 13499 database types (ISO13499FileDb, MMETestObjects)
  • DTS.Common.Licensing.Messages - ValidationResult
  • DTS.Common.Base - BasePropertyChanged for MVVM support
  • DTS.Serialization - File reading utilities
  • DTS.Common.Utilities.Logging - APILogger
  • DTS.Common.SharedResource.Strings - Localized string resources
  • DTS.Common.Utils - Utility classes including TestUtils
  • DTS.Common.Converters - EnumDescriptionTypeConverter
  • DTS.Common.Enums.Hardware - HardwareTypes enum
  • DTS.Common.Enums.Sensors - Sensor-related enums
  • DTS.Common.Interface.DataRecorders - IDASHardware
  • DTS.Common.Interface.DASFactory - IDASFactory, IDiscoveredDevice
  • DTS.Common.Enums.DASFactory - DFConstantsAndEnums
  • DTS.Common.Constant.DASSpecific - SensorConstants
  • DTS.DASLib.DASFactory - Underlying DAS factory implementation
  • DTS.DASLib.Service - DAS channel and communication types
  • DTS.DASLib.Command.TDAS - TDAS command infrastructure
  • System.Windows.Media - Color type
  • System.Xml.Linq - XML parsing

What depends on this module:

  • Unclear from source alone; the module exposes public classes that appear designed for consumption by UI layers, test setup components, and data export functionality.

5. Gotchas

  1. Namespace inconsistency: CollectDataProcess, SysBuiltObjectType, DataFiles, DataFilesList, and DASFactory are declared in namespace DataPROWin7.DataModel while the file path suggests DTS.Common.DataModel. This may cause confusion when importing.

  2. SysBuiltObjectType fallback value: The `_

Reference in New Issue View Git Blame Copy Permalink