Class
ChartDifferencePoints
ChartForgeX.Core
Materializes typed paired observations from nullable sample slots without synthesizing values.
Inheritance
- object
- ChartDifferencePoints
Methods
public static ChartDifferenceAlignment Align(ChartSeries first, ChartSeries second, ChartMissingDataPolicy missingDataPolicy = Gap, CancellationToken cancellationToken = default) #Captures two independent ordinary connected series and aligns only equal authored X coordinates.
Parameters
- first ChartForgeX.Core.ChartSeries
- First Line/StepLine/Area/StepArea source, with globally increasing unique X.
- second ChartForgeX.Core.ChartSeries
- Second source under the same exact-coordinate contract.
- missingDataPolicy ChartForgeX.Core.ChartMissingDataPolicy = Gap
- Gap breaks after an unmatched union slot; Connect joins surviving pairs. Explicit source breaks always propagate.
- cancellationToken System.Threading.CancellationToken = default
- Cancellation checked through capture and merge; no source/chart is changed.
Returns
ChartDifferenceAlignment Detached raw sources, identity maps and complete matched pairs. No zero, interpolated value or pair ID is synthesized.public static ChartDifferencePoint[] FromXY(IEnumerable<double> x, IEnumerable<double?> first, IEnumerable<double?> second, ChartMissingDataPolicy missingDataPolicy = Gap, CancellationToken cancellationToken = default) #Omits incomplete pairs. Gap starts a new segment after a missing slot; Connect joins the surviving pairs.
Parameters
- x System.Collections.Generic.IEnumerable<double>
- Finite X positions, including positions whose pair is incomplete.
- first System.Collections.Generic.IEnumerable<double?>
- Nullable finite first values.
- second System.Collections.Generic.IEnumerable<double?>
- Nullable finite second values.
- missingDataPolicy ChartForgeX.Core.ChartMissingDataPolicy = Gap
- The explicit missing-slot policy. No policy interpolates or inserts source values.
- cancellationToken System.Threading.CancellationToken = default
- Cancellation checked during materialization; no series is changed on failure.
Returns
ChartDifferencePoint[] Complete typed pairs in source order. Observation indices address these returned pairs.