← Gallery

Progress Ring

Completion by delivery stage

Explore the example, download the output or use the C# source in your own project.

Preview
Completion by delivery stageChart with 1 data series: Completion.Completion by delivery stageExplore the data, then download the chartReceivedQualifiedReviewedVerifiedApprovedComplete34.83Completion
Completion by delivery stage
Completion by delivery stageChart with 1 data series: Completion.Completion by delivery stageExplore the data, then download the chartReceivedQualifiedReviewedVerifiedApprovedComplete34.83Completion
Completion by delivery stage
800 × 440 pixels

Create this example

Create a console project, add the ChartForgeX package, and replace Program.cs with this source. Run it to write SVG, PNG and HTML with the default system fonts.

For the same typography as the gallery, download the gallery-font recipe and copy the gallery’s fonts directory beside your program.

using System;
using System.Collections.Generic;
using System.Globalization;
using System.IO;
using System.Linq;
using ChartForgeX.Core;
using ChartForgeX.Primitives;
using ChartForgeX.Rendering;
using ChartForgeX.Themes;
using ChartForgeX.Topology;
using ChartForgeX.Typography;
using ChartForgeX.VisualArtifacts;
using ChartForgeX.VisualBlocks;

var mode = VisualThemeMode.Light;
var theme = VisualTheme.Graphite();
var model = ProgressRingRecipe.Create("wide", mode);
var context = new VisualRenderContext(
    new VisualLayoutOptions(new VisualSize(800, 440)), theme, mode,
    new VisualFrame("Completion by delivery stage", "Explore the data, then download the chart", showLegend: null, showSurface: false));
var prepared = model.Prepare(context);
File.WriteAllText("visual.svg", prepared.ToSvg());
File.WriteAllBytes("visual.png", prepared.ToPng());
File.WriteAllText("visual.html", prepared.ToArtifact("example", VisualArtifactKind.Chart).ToHtmlPage());

/// <summary>Delivery-stage completion values rendered as independent progress rings.</summary>
public static class ProgressRingRecipe {
    /// <summary>Creates stage completion rings; the options variant adjusts their radius and stroke.</summary>
    public static Chart Create(string variant = "wide", VisualThemeMode mode = VisualThemeMode.Light) {
        if (variant is not ("wide" or "compact" or "sparse" or "options" or "compact-options"))
            throw new ArgumentOutOfRangeException(nameof(variant));
        var points = (variant == "sparse" ? new[] { 1, 3, 6 } : Enumerable.Range(1, 6))
            .Select(index => new ChartPoint(index, 20 + index * 7 % 29));
        var completion = new ChartSeries(new ChartSeriesId("completion"), "Completion", ChartSeriesKind.ProgressRing, points);
        var chart = Chart.Create().WithXLabels("Received", "Qualified", "Reviewed", "Verified", "Approved", "Complete")
            .AddSeries(completion).WithProgressRingCenterLabel()
            .WithValueFormat(ChartValueFormat.Number("0.##", System.Globalization.CultureInfo.InvariantCulture));
        if (variant == "options") chart.WithRadialProgressRadiusScale(.85).WithRadialProgressStrokeScale(1.2);
        return chart;
    }
}
using System;
using System.Collections.Generic;
using System.Globalization;
using System.IO;
using System.Linq;
using ChartForgeX.Core;
using ChartForgeX.Primitives;
using ChartForgeX.Rendering;
using ChartForgeX.Themes;
using ChartForgeX.Topology;
using ChartForgeX.Typography;
using ChartForgeX.VisualArtifacts;
using ChartForgeX.VisualBlocks;

var mode = VisualThemeMode.Dark;
var theme = VisualTheme.Graphite();
var model = ProgressRingRecipe.Create("wide", mode);
var context = new VisualRenderContext(
    new VisualLayoutOptions(new VisualSize(800, 440)), theme, mode,
    new VisualFrame("Completion by delivery stage", "Explore the data, then download the chart", showLegend: null, showSurface: false));
var prepared = model.Prepare(context);
File.WriteAllText("visual.svg", prepared.ToSvg());
File.WriteAllBytes("visual.png", prepared.ToPng());
File.WriteAllText("visual.html", prepared.ToArtifact("example", VisualArtifactKind.Chart).ToHtmlPage());

/// <summary>Delivery-stage completion values rendered as independent progress rings.</summary>
public static class ProgressRingRecipe {
    /// <summary>Creates stage completion rings; the options variant adjusts their radius and stroke.</summary>
    public static Chart Create(string variant = "wide", VisualThemeMode mode = VisualThemeMode.Light) {
        if (variant is not ("wide" or "compact" or "sparse" or "options" or "compact-options"))
            throw new ArgumentOutOfRangeException(nameof(variant));
        var points = (variant == "sparse" ? new[] { 1, 3, 6 } : Enumerable.Range(1, 6))
            .Select(index => new ChartPoint(index, 20 + index * 7 % 29));
        var completion = new ChartSeries(new ChartSeriesId("completion"), "Completion", ChartSeriesKind.ProgressRing, points);
        var chart = Chart.Create().WithXLabels("Received", "Qualified", "Reviewed", "Verified", "Approved", "Complete")
            .AddSeries(completion).WithProgressRingCenterLabel()
            .WithValueFormat(ChartValueFormat.Number("0.##", System.Globalization.CultureInfo.InvariantCulture));
        if (variant == "options") chart.WithRadialProgressRadiusScale(.85).WithRadialProgressStrokeScale(1.2);
        return chart;
    }
}