← Gallery

Tile Map

Temperature by state

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

Preview
Temperature by stateChart tile map for Temperature on United States states with 7 filled regions and 44 missing regions.Temperature by stateAbsolute color anchors use uneven numeric intervalsTemperatureAKMEVTNHWAMTNDMNWIMINYMARIORIDSDIAILINOHPANJCTCANVWYNEMOKYWVVAMDDEAZUTCOKSARTNNCSCDCHINMOKLAMSALGATXFLCold · -20Warm · 40Freezing 0No data
Temperature by state
Temperature by stateChart tile map for Temperature on United States states with 7 filled regions and 44 missing regions.Temperature by stateAbsolute color anchors use uneven numeric intervalsTemperatureAKMEVTNHWAMTNDMNWIMINYMARIORIDSDIAILINOHPANJCTCANVWYNEMOKYWVVAMDDEAZUTCOKSARTNNCSCDCHINMOKLAMSALGATXFLCold · -20Warm · 40Freezing 0No data
Temperature by state
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 = TileMapPositionedColorScaleRecipe.Create("positioned-color-scale", mode);
var context = new VisualRenderContext(
    new VisualLayoutOptions(new VisualSize(800, 440)), theme, mode,
    new VisualFrame("Temperature by state", "Absolute color anchors use uneven numeric intervals", 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>Creates a tile map whose temperature scale has authored numeric color stops.</summary>
public static class TileMapPositionedColorScaleRecipe {
    /// <summary>Creates the source model for a gallery variant without choosing an export backend.</summary>
    public static Chart Create(string variant = "positioned-color-scale", VisualThemeMode mode = VisualThemeMode.Light) {
        if (variant is not ("positioned-color-scale" or "compact-positioned-color-scale"))
            throw new ArgumentOutOfRangeException(nameof(variant));

        var colors = VisualTheme.Graphite().Resolve(mode);
        var codes = new[] { "CA", "TX", "NY", "FL", "WA", "IL", "CO" };
        var values = new[] { 0d, 2.5, 5, 10, 22.5, 40, 55 };
        var scale = ChartColorScale.Diverging(new[] {
            new ChartColorStop(-20, ChartColor.FromHex("#2166AC")), new ChartColorStop(-3, ChartColor.FromHex("#67A9CF"))
        }, new ChartColorStop(0, ChartColor.FromHex("#D1D5DB")), new[] {
            new ChartColorStop(5, ChartColor.FromHex("#D9A441")), new ChartColorStop(40, ChartColor.FromHex("#B2182B"))
        }).WithLabels("Cold", "Freezing", "Warm").WithNoDataColor(colors.Border);
        return Chart.Create().AddTileMap("Temperature", ChartTileMapCatalog.Get("us-states"),
                codes.Select((code, index) => new ChartRegionMapItem(code, values[index])), id: new ChartSeriesId("state-temperatures"))
            .WithMapLabels().WithMapColorScale(scale)
            .WithValueFormat(ChartValueFormat.Number("0.##", System.Globalization.CultureInfo.InvariantCulture));
    }
}
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 = TileMapPositionedColorScaleRecipe.Create("positioned-color-scale", mode);
var context = new VisualRenderContext(
    new VisualLayoutOptions(new VisualSize(800, 440)), theme, mode,
    new VisualFrame("Temperature by state", "Absolute color anchors use uneven numeric intervals", 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>Creates a tile map whose temperature scale has authored numeric color stops.</summary>
public static class TileMapPositionedColorScaleRecipe {
    /// <summary>Creates the source model for a gallery variant without choosing an export backend.</summary>
    public static Chart Create(string variant = "positioned-color-scale", VisualThemeMode mode = VisualThemeMode.Light) {
        if (variant is not ("positioned-color-scale" or "compact-positioned-color-scale"))
            throw new ArgumentOutOfRangeException(nameof(variant));

        var colors = VisualTheme.Graphite().Resolve(mode);
        var codes = new[] { "CA", "TX", "NY", "FL", "WA", "IL", "CO" };
        var values = new[] { 0d, 2.5, 5, 10, 22.5, 40, 55 };
        var scale = ChartColorScale.Diverging(new[] {
            new ChartColorStop(-20, ChartColor.FromHex("#2166AC")), new ChartColorStop(-3, ChartColor.FromHex("#67A9CF"))
        }, new ChartColorStop(0, ChartColor.FromHex("#D1D5DB")), new[] {
            new ChartColorStop(5, ChartColor.FromHex("#D9A441")), new ChartColorStop(40, ChartColor.FromHex("#B2182B"))
        }).WithLabels("Cold", "Freezing", "Warm").WithNoDataColor(colors.Border);
        return Chart.Create().AddTileMap("Temperature", ChartTileMapCatalog.Get("us-states"),
                codes.Select((code, index) => new ChartRegionMapItem(code, values[index])), id: new ChartSeriesId("state-temperatures"))
            .WithMapLabels().WithMapColorScale(scale)
            .WithValueFormat(ChartValueFormat.Number("0.##", System.Globalization.CultureInfo.InvariantCulture));
    }
}