GraphVG 0.1.1

dotnet add package GraphVG --version 0.1.1
                    
NuGet\Install-Package GraphVG -Version 0.1.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="GraphVG" Version="0.1.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="GraphVG" Version="0.1.1" />
                    
Directory.Packages.props
<PackageReference Include="GraphVG" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add GraphVG --version 0.1.1
                    
#r "nuget: GraphVG, 0.1.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package GraphVG@0.1.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=GraphVG&version=0.1.1
                    
Install as a Cake Addin
#tool nuget:?package=GraphVG&version=0.1.1
                    
Install as a Cake Tool

GraphVG

A .NET library for F# to generate graph and chart visuals as SVG using SharpVG.

Pull requests and suggestions are greatly appreciated.

Source code on GitHub

CI

Why GraphVG?

  • Build graphs with an F#-first API instead of writing raw SVG by hand.
  • Generate clean SVG output that can be embedded anywhere HTML/SVG is supported.
  • Compose charts from reusable pieces: scales, axes, series, themes, annotations, and legends.
  • Supports common chart types out of the box: line, scatter, and area.
  • Supports linear and logarithmic scales.
  • Minimal dependency footprint: GraphVG depends on SharpVG only.

GraphVG Goals

  • Make graph generation in F# simple and pipeline-friendly.
  • Keep rendering deterministic and testable.
  • Use strong types to reduce invalid chart state.
  • Keep visual customization explicit and composable.

<table> <tr><td align="center" width="320"><img src="docs/examples/centered-axes.svg" width="280" alt="Centered Axes" /><br /><b>Centered Axes</b></td><td align="center" width="320"><img src="docs/examples/axis-styles.svg" width="280" alt="Axis Styling" /><br /><b>Axis Styling</b></td><td align="center" width="320"><img src="docs/examples/series-styles.svg" width="280" alt="Series Styling" /><br /><b>Series Styling</b></td></tr> <tr><td align="center" width="320"><img src="docs/examples/step-line.svg" width="280" alt="Step Line" /><br /><b>Step Line</b></td><td align="center" width="320"><img src="docs/examples/confidence-band.svg" width="280" alt="Confidence Band" /><br /><b>Confidence Band</b></td><td align="center" width="320"><img src="docs/examples/log-scale.svg" width="280" alt="Log Scale" /><br /><b>Log Scale</b></td></tr> <tr><td align="center" width="320"><img src="docs/examples/stacked-area.svg" width="280" alt="Stacked Area" /><br /><b>Stacked Area</b></td><td align="center" width="320"><img src="docs/examples/stacked-area-percent.svg" width="280" alt="Normalized Stacked Area" /><br /><b>Normalized Stacked Area</b></td><td align="center" width="320"><img src="docs/examples/streamgraph.svg" width="280" alt="Streamgraph" /><br /><b>Streamgraph</b></td></tr> <tr><td align="center" width="320"><img src="docs/examples/bar-chart.svg" width="280" alt="Grouped Bar Chart" /><br /><b>Grouped Bar Chart</b></td><td align="center" width="320"><img src="docs/examples/waterfall.svg" width="280" alt="Waterfall Chart" /><br /><b>Waterfall Chart</b></td><td align="center" width="320"><img src="docs/examples/pie-chart.svg" width="280" alt="Pie Chart" /><br /><b>Pie Chart</b></td></tr> <tr><td align="center" width="320"><img src="docs/examples/parallel-sets.svg" width="280" alt="Parallel Sets" /><br /><b>Parallel Sets</b></td><td align="center" width="320"><img src="docs/examples/horizontal-bar.svg" width="280" alt="Horizontal Bar Chart" /><br /><b>Horizontal Bar Chart</b></td><td align="center" width="320"><img src="docs/examples/tooltips.svg" width="280" alt="Tooltips" /><br /><b>Tooltips</b></td></tr> <tr><td align="center" width="320"><img src="docs/examples/bubble-chart.svg" width="280" alt="Bubble Chart" /><br /><b>Bubble Chart</b></td><td align="center" width="320"><img src="docs/examples/heatmap.svg" width="280" alt="Heatmap" /><br /><b>Heatmap</b></td><td align="center" width="320"><img src="docs/examples/histogram.svg" width="280" alt="Histogram" /><br /><b>Histogram</b></td></tr> <tr><td align="center" width="320"><img src="docs/examples/violin-plot.svg" width="280" alt="Violin Plot" /><br /><b>Violin Plot</b></td><td align="center" width="320"><img src="docs/examples/box-plot.svg" width="280" alt="Box Plot" /><br /><b>Box Plot</b></td><td align="center" width="320"><img src="docs/examples/radar-chart.svg" width="280" alt="Radar Chart" /><br /><b>Radar Chart</b></td></tr> <tr><td align="center" width="320"><img src="docs/examples/pie-chart-standalone.svg" width="280" alt="Pie Chart" /><br /><b>Pie Chart</b></td><td align="center" width="320"><img src="docs/examples/donut-chart.svg" width="280" alt="Donut Chart" /><br /><b>Donut Chart</b></td><td align="center" width="320"><img src="docs/examples/plot-trig.svg" width="280" alt="Trig Functions" /><br /><b>Trig Functions</b></td></tr> <tr><td align="center" width="320"><img src="docs/examples/plot-tan.svg" width="280" alt="tan(x) — Discontinuities" /><br /><b>tan(x) — Discontinuities</b></td><td align="center" width="320"><img src="docs/examples/plot-gaussian.svg" width="280" alt="Gaussian + Derivative" /><br /><b>Gaussian + Derivative</b></td><td align="center" width="320"><img src="docs/examples/theme-gameboy-green.svg" width="280" alt="Theme: Game Boy Green" /><br /><b>Theme: Game Boy Green</b></td></tr> <tr><td align="center" width="320"><img src="docs/examples/theme-crispy-commodore.svg" width="280" alt="Theme: Crispy Commodore" /><br /><b>Theme: Crispy Commodore</b></td><td align="center" width="320"><img src="docs/examples/theme-ti-hue.svg" width="280" alt="Theme: TI Hue" /><br /><b>Theme: TI Hue</b></td><td align="center" width="320"><img src="docs/examples/theme-nes.svg" width="280" alt="Theme: NES" /><br /><b>Theme: NES</b></td></tr> <tr><td align="center" width="320"><img src="docs/examples/theme-turtle.svg" width="280" alt="Theme: Turtle" /><br /><b>Theme: Turtle</b></td><td align="center" width="320"><img src="docs/examples/dual-axis.svg" width="280" alt="Dual Y-Axis" /><br /><b>Dual Y-Axis</b></td><td align="center" width="320"><img src="docs/examples/funnel-conversion.svg" width="280" alt="Funnel Chart" /><br /><b>Funnel Chart</b></td></tr> <tr><td align="center" width="320"><img src="docs/examples/funnel-pipeline.svg" width="280" alt="Sales Pipeline Funnel" /><br /><b>Sales Pipeline Funnel</b></td><td align="center" width="320"><img src="docs/examples/lollipop.svg" width="280" alt="Lollipop Chart" /><br /><b>Lollipop Chart</b></td><td align="center" width="320"><img src="docs/examples/lollipop-horizontal.svg" width="280" alt="Horizontal Lollipop" /><br /><b>Horizontal Lollipop</b></td></tr> <tr><td align="center" width="320"><img src="docs/examples/lollipop-comparison.svg" width="280" alt="Overlaid Lollipop" /><br /><b>Overlaid Lollipop</b></td><td align="center" width="320"><img src="docs/examples/treemap-portfolio.svg" width="280" alt="Treemap" /><br /><b>Treemap</b></td><td align="center" width="320"><img src="docs/examples/treemap-budget.svg" width="280" alt="Treemap (Dark)" /><br /><b>Treemap (Dark)</b></td></tr> <tr><td align="center" width="320"><img src="docs/examples/bullet-kpi.svg" width="280" alt="Bullet Chart" /><br /><b>Bullet Chart</b></td><td align="center" width="320"><img src="docs/examples/bullet-manufacturing.svg" width="280" alt="Bullet Chart (Dark)" /><br /><b>Bullet Chart (Dark)</b></td><td align="center" width="320"><img src="docs/examples/hexbin-seismic.svg" width="280" alt="Hexbin Chart" /><br /><b>Hexbin Chart</b></td></tr> <tr><td align="center" width="320"><img src="docs/examples/hexbin-collision.svg" width="280" alt="Hexbin Chart (Dark)" /><br /><b>Hexbin Chart (Dark)</b></td><td align="center" width="320"><img src="docs/examples/ridgeline-response.svg" width="280" alt="Ridgeline / Joy Plot" /><br /><b>Ridgeline / Joy Plot</b></td><td align="center" width="320"><img src="docs/examples/ridgeline-exams.svg" width="280" alt="Ridgeline / Joy Plot (Dark)" /><br /><b>Ridgeline / Joy Plot (Dark)</b></td></tr> <tr><td align="center" width="320"><img src="docs/examples/dumbbell-tutoring.svg" width="280" alt="Dumbbell Chart" /><br /><b>Dumbbell Chart</b></td><td align="center" width="320"><img src="docs/examples/dumbbell-commute.svg" width="280" alt="Dumbbell Chart (Dark)" /><br /><b>Dumbbell Chart (Dark)</b></td><td align="center" width="320"><img src="docs/examples/bump-sales.svg" width="280" alt="Bump Chart" /><br /><b>Bump Chart</b></td></tr> <tr><td align="center" width="320"><img src="docs/examples/bump-languages.svg" width="280" alt="Bump Chart (Dark)" /><br /><b>Bump Chart (Dark)</b></td><td align="center" width="320"><img src="docs/examples/sunburst-headcount.svg" width="280" alt="Sunburst Diagram" /><br /><b>Sunburst Diagram</b></td><td align="center" width="320"><img src="docs/examples/sunburst-energy.svg" width="280" alt="Sunburst Diagram (Dark)" /><br /><b>Sunburst Diagram (Dark)</b></td></tr> <tr><td align="center" width="320"><img src="docs/examples/stacked-bar-revenue.svg" width="280" alt="Stacked Bar Chart" /><br /><b>Stacked Bar Chart</b></td><td align="center" width="320"><img src="docs/examples/stacked-bar-energy.svg" width="280" alt="Normalized Stacked Bar" /><br /><b>Normalized Stacked Bar</b></td><td align="center" width="320"><img src="docs/examples/strip-plot-reaction.svg" width="280" alt="Strip Plot" /><br /><b>Strip Plot</b></td></tr> <tr><td align="center" width="320"><img src="docs/examples/strip-plot-overlay.svg" width="280" alt="Strip Plot with Box Overlay" /><br /><b>Strip Plot with Box Overlay</b></td><td align="center" width="320"><img src="docs/examples/subplots-regional.svg" width="280" alt="Subplots / Small Multiples" /><br /><b>Subplots / Small Multiples</b></td><td align="center" width="320"><img src="docs/examples/subplots-mixed.svg" width="280" alt="Subplots — Mixed Types (Dark)" /><br /><b>Subplots — Mixed Types (Dark)</b></td></tr> <tr><td align="center" width="320"><img src="docs/examples/slope-satisfaction.svg" width="280" alt="Slope Chart" /><br /><b>Slope Chart</b></td><td align="center" width="320"><img src="docs/examples/slope-energy.svg" width="280" alt="Slope Chart (Dark)" /><br /><b>Slope Chart (Dark)</b></td><td></td></tr> </table>

Examples

open GraphVG
open SharpVG

let points =
    [
        1.0, 1.0
        2.0, 1.4
        5.0, 2.0
        10.0, 2.6
        20.0, 3.2
        50.0, 4.0
        100.0, 4.7
    ]

let response =
    points
    |> Series.line
    |> Series.withLabel "Response"
    |> Series.withStrokeWidth (Length.ofFloat 3.0)

let samples =
    points
    |> Series.scatter
    |> Series.withLabel "Samples"
    |> Series.withPointRadius (Length.ofFloat 6.0)

let xScale = Scale.log (1.0, 100.0) (0.0, CommonMath.canvasSize) 10.0
let yScale = Scale.linear (0.0, 5.0) (CommonMath.canvasSize, 0.0)

let graph =
    Graph.create [ response; samples ] (1.0, 100.0) (0.0, 5.0)
    |> Graph.withXScale xScale
    |> Graph.withYScale yScale
    |> Graph.withTitle "Log Scale"
    |> Graph.withAxes
        (
            Some (Axis.create Bottom xScale |> Axis.withLabel "Input Scale"),
            Some (Axis.create Left yScale |> Axis.withLabel "Response")
        )
    |> Graph.withLegend (Legend.create LegendRight)

let svg = GraphVG.toSvg graph
let html = GraphVG.toHtml graph

Simple start:

let html =
    Graph.create [ unitCircle; lissajous ] (-1.2, 1.2) (-1.2, 1.2)
    |> Graph.withTheme Theme.light
    |> GraphVG.toHtml

Layout spacing is configurable per graph:

let spacious =
    LayoutSpacing.create 28.0 24.0 10.0 6.0

let svg =
    Graph.create [ response; samples ] (1.0, 100.0) (0.0, 5.0)
    |> Graph.withLayoutSpacing spacious
    |> GraphVG.toSvg

Building GraphVG

Clone the repository:

git clone https://github.com/ChrisNikkel/GraphVG.git
cd GraphVG

Build:

dotnet build

Run tests:

dotnet test

Run the example gallery generator:

dotnet run --project Examples/Example

Project Structure

REQUIREMENTS.md     # Planned requirements/bugs
DESIGN.md           # Architecture and design notes
GraphVG/            # Main library (net8.0)
Examples/Example/   # Executable usage demo
Tests/              # xUnit and FsCheck test suite

Documentation

Support

Please submit bugs and feature requests here.

Library License

The library is available under the MIT license. For more information see LICENSE.md.

Maintainer(s)

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.1 76 8/22/2026
0.1.0 81 8/22/2026