← 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 stageThe same data in a compact viewReceivedQualifiedReviewedVerifiedApprovedComplete34.83Completion
Completion by delivery stage
Completion by delivery stageChart with 1 data series: Completion.Completion by delivery stageThe same data in a compact viewReceivedQualifiedReviewedVerifiedApprovedComplete34.83Completion
Completion by delivery stage
360 × 360 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("compact", mode);
var context = new VisualRenderContext(
    new VisualLayoutOptions(new VisualSize(360, 360)), theme, mode,
    new VisualFrame("Completion by delivery stage", "The same data in a compact view", 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("compact", mode);
var context = new VisualRenderContext(
    new VisualLayoutOptions(new VisualSize(360, 360)), theme, mode,
    new VisualFrame("Completion by delivery stage", "The same data in a compact view", 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;
    }
}