Integration

SPC analysis results are plain .NET objects. They can be mapped to a charting library, serialized to JSON and stored, returned from a web-API endpoint, or cached between requests. This page describes the common integration patterns: plotting, service integration, JSON round-trip, and the trade-off between persisting results and recomputing them on demand.

Any charting library that can draw line series and reference lines is sufficient to visualize a control chart. The mapping from the SPC result model to chart primitives is always the same:

double[] data = {
    10.5, 11.2, 10.8, 11.5, 10.3, 11.8, 10.1, 11.4,
    10.9, 11.1, 10.6, 11.3, 10.7, 11.0, 10.4
};
IndividualsMovingRangeChartSet chart =
    new IndividualsMovingRangeChartSet(Vector.Create(data));
chart.Analyze();

FixedLimitSeries iSeries = chart.IndividualsSeries;

// Build a plotting model (pseudocode — use your own charting library)
// var model = new ChartModel();
// model.AddSeries("Individuals", iSeries.Values);
// model.AddConstantLine("CL",  iSeries.CenterLine,  lineStyle: Solid);
// model.AddConstantLine("UCL", iSeries.UpperControlLimit, lineStyle: Dashed);
// model.AddConstantLine("LCL", iSeries.LowerControlLimit, lineStyle: Dashed);
Console.WriteLine($"Ready to render {iSeries.Values.Count} points.");

Dim data As Double() = {
    10.5, 11.2, 10.8, 11.5, 10.3, 11.8, 10.1, 11.4,
    10.9, 11.1, 10.6, 11.3, 10.7, 11.0, 10.4
}
Dim chart As New IndividualsMovingRangeChartSet(Vector.Create(data))
chart.Analyze()

Dim iSeries As FixedLimitSeries = chart.IndividualsSeries
Console.WriteLine($"Ready to render {iSeries.Values.Count} points.")

No code example is currently available or this language may not be supported.

let data = [|
    10.5; 11.2; 10.8; 11.5; 10.3; 11.8; 10.1; 11.4
    10.9; 11.1; 10.6; 11.3; 10.7; 11.0; 10.4
|]
let chart = new IndividualsMovingRangeChartSet(Vector.Create(data))
chart.Analyze()

let iSeries = chart.IndividualsSeries
printfn "Ready to render %d points." iSeries.Values.Count

Because fitted chart objects contain only immutable vectors and values, scalar doubles, and nested plain objects, they serialize cleanly without circular references or opaque handles. Typical patterns in a service layer are:

• REST API response DTO — map a ControlChart or its ControlSeries payload directly to a JSON response body. The default System.Text.Json serializer handles the public properties without additional configuration.

• SignalR / WebSocket push — for Phase II monitoring, serialize a deployed chart and store it; when new observations arrive, call Apply(Vector<Double>) and push the serialized fitted result to connected clients.

• Background job output — serialize the result to a message-queue payload; a downstream consumer deserializes it for display without needing access to the raw data.

Result types in the SPC API are designed to round-trip through standard .NET JSON serializers. ControlChart and all ControlSeries subtypes expose only public properties with public getters, making them compatible with both System.Text.Json.JsonSerializer and Newtonsoft.Json.JsonConvert without custom converters.

double[] data = {
    10.5, 11.2, 10.8, 11.5, 10.3, 11.8, 10.1, 11.4,
    10.9, 11.1, 10.6, 11.3, 10.7, 11.0, 10.4
};

IndividualsMovingRangeChartSet chart =
    new IndividualsMovingRangeChartSet(Vector.Create(data));
chart.Analyze();

// Deploy the chart to freeze parameters, then serialize
IndividualsMovingRangeChartSet deployed = chart.Deploy();
string json = deployed.ToJson();
Console.WriteLine($"JSON length: {json.Length} chars");

Dim data As Double() = {
    10.5, 11.2, 10.8, 11.5, 10.3, 11.8, 10.1, 11.4,
    10.9, 11.1, 10.6, 11.3, 10.7, 11.0, 10.4
}
Dim chart As New IndividualsMovingRangeChartSet(Vector.Create(data))
chart.Analyze()

Dim deployed As IndividualsMovingRangeChartSet = chart.Deploy()
Dim json As String = deployed.ToJson()
Console.WriteLine($"JSON length: {json.Length} chars")

No code example is currently available or this language may not be supported.

let data = [|
    10.5; 11.2; 10.8; 11.5; 10.3; 11.8; 10.1; 11.4
    10.9; 11.1; 10.6; 11.3; 10.7; 11.0; 10.4
|]
let chart = new IndividualsMovingRangeChartSet(Vector.Create(data))
chart.Analyze()

let deployed = chart.Deploy()
let json = deployed.ToJson()
printfn "JSON length: %d chars" json.Length

To deserialize a stored result:

// Deserialize a previously stored deployed chart
string json = "/* previously serialized JSON */";

IndividualsMovingRangeChartSet restored =
    IndividualsMovingRangeChartSet.FromJson(json);

Console.WriteLine(
    $"Restored CL = {restored.IndividualsSeries.CenterLine:F4}");

Dim json As String = "/* previously serialized JSON */"
Dim restored As IndividualsMovingRangeChartSet =
    IndividualsMovingRangeChartSet.FromJson(json)
Console.WriteLine($"Restored CL = {restored.IndividualsSeries.CenterLine:F4}")

No code example is currently available or this language may not be supported.

let json = "{ /* previously serialized JSON */ }"
let restored = IndividualsMovingRangeChartSet.FromJson(json)
printfn "Restored CL = %g" restored.IndividualsSeries.CenterLine

SPC results are immutable and self-contained. Once computed, a fitted chart object fully describes the state of the control chart at the time the analysis was run. No re-analysis is required to render the chart or evaluate rules later.

Other Resources