DP44/enriched-qwen3-coder-next/Common/DTS.CommonCore/Interface/DTS.Viewer/TestModification.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
Common/DTS.CommonCore/Interface/DTS.Viewer/TestModification/ITestModificationView.cs Common/DTS.CommonCore/Interface/DTS.Viewer/TestModification/ITestModificationViewModel.cs Common/DTS.CommonCore/Interface/DTS.Viewer/TestModification/ITestModificationModel.cs	2026-04-16T02:32:49.562747+00:00	Qwen/Qwen3-Coder-Next-FP8	1	a5f27c5a375dc7b6

TestModification

Documentation: Test Modification Module Interfaces

---

1. Purpose

This module defines the core interfaces for the Test Modification feature, which enables users to modify properties of a selected test channel (e.g., description, Eu multiplier/offset, T0/T1/T2 timing, sensitivity, software filter, and data flag). It follows the MVVM pattern, with ITestModificationView, ITestModificationViewModel, and ITestModificationModel forming the view, view model, and model layers respectively. The module exists to encapsulate state and behavior related to channel-specific modifications, supporting features such as ISO code synchronization when software filters change and configurable representation of unfiltered states (e.g., "0" vs "P").

---

2. Public Interface

ITestModificationView

• Inherits: IBaseView
• Description: Marker interface for the view layer of the test modification UI. No additional members defined beyond base view contract.

ITestModificationViewModel

• Inherits: IBaseViewModel
• Properties:
  • ITestModificationView View { get; set; } – Binds to the associated view instance.
  • IBaseViewModel Parent { get; set; } – Reference to the parent view model (e.g., containing test configuration).
  • bool UseISOCodeFilterMapping { get; set; } – Controls whether modifying the software filter should trigger automatic ISO code updates.
  • bool UseZeroForUnfiltered { get; set; } – Controls whether "0" or "P" is used when the ISO code is auto-updated due to filter change (i.e., for unfiltered state).
• Methods:
  • void PublishChanges() – Commits pending modifications (e.g., to the selected channel or underlying data model). Behavior not specified beyond this; implementation-dependent.

ITestModificationModel

• Inherits: IBaseModel
• Properties:
  • ITestModificationViewModel Parent { get; set; } – Back-reference to the associated view model.
  • ITestChannel SelectedChannel { get; set; } – The channel whose properties are being modified.
  • string Description { get; set; } – The ChannelDescriptionString of SelectedChannel.
  • bool IsModifiedDescription { get; } – true if Description differs from the channel’s original value.
  • double EuMultiplier { get; set; } – Eu multiplier of SelectedChannel.
  • bool IsModifiedEuMultiplier { get; } – true if EuMultiplier differs from original.
  • double EuOffset { get; set; } – Eu offset of SelectedChannel.
  • bool IsModifiedEuOffset { get; } – true if EuOffset differs from original.
  • double T0 { get; set; } – T0 offset in milliseconds.
  • bool IsModifiedT0 { get; } – true if T0 differs from original.
  • bool IsModifiedLineFit { get; set; } – true if T1 or T2 has been modified.
  • double T1 { get; set; } – Start time (ms) for line fit.
  • double T2 { get; set; } – End time (ms) for line fit.
  • bool IsModifiedSensitivity { get; } – true if Sensitivity differs from original.
  • double Sensitivity { get; set; } – Sensitivity of SelectedChannel.
  • bool IsModifiedFilter { get; } – true if SelectedFilter differs from original.
  • IFilterClass SelectedFilter { get; set; } – Software filter applied to SelectedChannel.
  • T0Mode T0Mode { get; set; } – Adjustment mode for T0 (type T0Mode not defined in provided sources).
  • DataFlag SelectedDataFlag { get; set; } – Data flag for SelectedChannel.
  • bool IsModifiedDataFlag { get; } – true if SelectedDataFlag differs from original.
  • bool IsModified { get; } – true if any channel property has been modified.
• Methods:
  • bool ValidateT0() – Returns true if T0 is within the valid time range of the dataset; false otherwise.

---

3. Invariants

• SelectedChannel must be non-null for ITestModificationModel to function meaningfully (all IsModified* properties and value getters depend on it).
• IsModified* properties are read-only indicators of whether the corresponding property differs from the original value of SelectedChannel (not necessarily the current in-memory value).
• IsModified is a logical OR of all IsModified* properties (inferred from documentation).
• ValidateT0() must evaluate T0 against the dataset’s time bounds (exact bounds unspecified).
• UseISOCodeFilterMapping and UseZeroForUnfiltered only affect behavior when SelectedFilter is modified and ISO code synchronization is enabled (implementation detail not specified).

---

4. Dependencies

This Module Depends On:

• DTS.Common.Base namespace: Provides IBaseView, IBaseViewModel, IBaseModel.
• DTS.Common.Interface.Sensors.SoftwareFilters: Provides IFilterClass.
• DTS.Common.Interface: Contains ITestChannel, DataFlag, and T0Mode (not shown in source but referenced).

This Module Is Used By:

• Likely consumed by higher-level modules (e.g., test configuration UI, channel editor) that instantiate and wire ITestModificationViewModel and ITestModificationModel.
• ITestModificationView implies integration with a UI framework (e.g., WPF) via IBaseView.

---

5. Gotchas

• IsModifiedLineFit is the only IsModified* property defined as get; set; (others are get; only). This suggests it may be settable externally (e.g., to force marking line fit as modified without changing T1/T2), which is inconsistent with other flags.
• SelectedFilter uses IFilterClass (comment notes: "FB 13120 Use IFilterClass instead of CFCFilter"), indicating a refactor history. Ensure no legacy code still assumes CFCFilter.
• T0Mode and DataFlag types are referenced but not defined in the provided sources; their semantics and valid values are unknown here.
• ValidateT0()’s behavior is underspecified: "within the dataset" is ambiguous (e.g., dataset start/end? sample timestamps? configuration bounds?).
• No explicit event or notification mechanism is defined for change tracking (e.g., INotifyPropertyChanged). Assumed to be provided via IBaseViewModel/IBaseModel or external mechanisms.
• None of the IsModified* properties are resettable—once true, they remain true unless the value is reverted to the original (implementation-dependent).

None identified beyond the above.