GraphVG 0.1.0

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

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.

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

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

• Design notes: DESIGN.md
• Requirements/backlog: REQUIREMENTS.md
• Developer guidance: CLAUDE.md
• Contributing guide: CONTRIBUTING.md
• Security policy: SECURITY.md

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)

• @ChrisNikkel