Repository navigation
This version removes C# interop from the core F# Plotly.NET library, offloading those implementations directly to the native C# lib Plotly.NET.CSharp:
Milestone link with all the fixed/closed issues
Breaking: Plotly.NET assemblies are no longer strong-named. Maintaining a strong-named build chain has caused recurring friction (see #452, #371, and the broader discussion at StephenCleary/AsyncEx#129) and forced us to maintain a re-packaged signed fork of Giraffe.ViewEngine (giraffe-fsharp/Giraffe.ViewEngine#23). Consumers that still need strong-named binaries can use brutaldev/StrongNameSigner to sign assemblies post-build.
As a consequence, the html dsl dependency switches back from Giraffe.ViewEngine.StrongName 2.0.0-alpha1 to upstream Giraffe.ViewEngine 1.4.0. The namespace is unchanged, so user code is not affected.
-
#504: Upgrade DynamicObj to
[8.0.0, 9.0.0), raising its transitive FSharp.Core minimum to 10.1.300. No Plotly.NET source adaptations were required. The upgrade includes revised hashing and equality for custom properties containing F# option values; ordinary optional chart arguments are unwrapped before storage. -
Bump bundled plotly.js to 2.28.0
-
#459: Breaking: Rename nine
ColorKeywordcases. The old names have been removed; replace usages and pattern matches using the mapping below. RGB values are unchanged, includingLightSlateGrayandLightSlateGrey, which both map to(119, 136, 153).Removed name Replacement DarkolivegreenDarkOliveGreenHoneydewHoneyDewHotpinkHotPinkLightAalmonLightSalmonLightAeaGreenLightSeaGreenLightAkyBlueLightSkyBlueLightAlateGrayLightSlateGrayLightslateGreyLightSlateGreySkyblueSkyBlue -
#477: Fix tick-font serialization for parallel categories and parallel coordinates charts, and add
StyleParam.Shape.HSplinefor horizontal spline paths in parallel categories plots. -
#441: Encoded typed array support — plotly.js 2.28 introduced a base64 representation for numeric arrays. Plotly.NET supports it for selected trace fields and chart constructors:
-
New
EncodedTypedArraytype (inPlotly.NET) carrying a base64 payload (bdata), a dtype tag (dtype), and an optional shape for multi-dimensional data. Supported dtypes:Float64,Float32,Int32,UInt32,Int16,UInt16,Int8,UInt8,UInt8Clamped. -
Convenience constructors:
EncodedTypedArray.ofFloat64Array,ofFloat32Array,ofInt32Array,ofUInt32Array,ofInt16Array,ofUInt16Array,ofInt8Array,ofUInt8Array,ofUInt8ClampedArray— all accept a 1-D .NET array and an optionalshapeparameter for multi-dimensional layouts. -
Encoded fields added across the trace style modules (
Trace2DStyle,Trace3DStyle,TracePolarStyle,TraceGeoStyle,TraceMapboxStyle,TraceTernaryStyle,TraceCarpetStyle,TraceDomainStyle,TraceSmithStyle), covering data arrays (XEncoded,YEncoded,ZEncoded, etc.), metadata arrays (IdsEncoded,CustomDataEncoded,MultiTextEncoded,SelectedPointsEncoded), error bar arrays (ArrayEncoded,ArrayminusEncoded), and trace-specific fields (e.g.Q1Encoded/MedianEncoded/Q3Encodedon BoxPlot,OpenEncoded/HighEncoded/LowEncoded/CloseEncodedon OHLC/Candlestick,OpacityScaleEncodedon Surface/Volume/IsoSurface,IntensityEncoded/IEncoded/JEncoded/KEncodedon Mesh3D, dimensionValuesEncodedon Splom/ParallelCoord). -
Encoded overloads added to selected F#
Chartroot functions (e.g.Chart.Scatter,Chart.Bar,Chart.Waterfall,Chart.Histogram,Chart.BoxPlot,Chart.Violin,Chart.OHLC,Chart.Candlestick,Chart.Splom,Chart.Histogram2D,Chart.Heatmap,Chart.Contour,Chart.Scatter3D,Chart.Surface,Chart.Mesh3D,Chart.Cone,Chart.StreamTube,Chart.Volume,Chart.IsoSurface,Chart.ScatterPolar,Chart.BarPolar,Chart.ScatterGeo,Chart.ChoroplethMap,Chart.ScatterMapbox,Chart.ChoroplethMapbox,Chart.DensityMapbox,Chart.ScatterTernary,Chart.Carpet,Chart.ScatterCarpet,Chart.ContourCarpet,Chart.ScatterSmith,Chart.Pie,Chart.FunnelArea,Chart.Sunburst,Chart.Treemap,Chart.Icicle) and selected derived convenience helpers (e.g.Chart.Point,Chart.Line,Chart.Spline,Chart.Bubble,Chart.Area,Chart.SplineArea,Chart.StackedArea,Chart.Range,Chart.Funnel,Chart.Histogram,Chart.StackedBar,Chart.PointDensity,Chart.PointPolar,Chart.PointGeo,Chart.PointMapbox,Chart.PointTernary,Chart.PointSmith,Chart.PointCarpet,Chart.Doughnut). -
Shared Sankey node/link objects accept encoded positions, source/target/value, and supported numeric metadata. Encoded values replace corresponding plain values when both are supplied in the same init/style call. Labels remain plain strings.
-
One-dimensional samples do not need a shape; matrix inputs use an explicitly shaped flat payload. Strings, arbitrary objects, decimal, and 64-bit integer encoding are outside the supported dtype set. Image pixels and helpers that compute from plain inputs (such as Pareto, Residual, and AnnotatedHeatmap) have no direct encoded overload.
-
The C# package exposes a selected subset of direct chart conveniences, documented in its release notes and the encoded-array guide. This release does not claim all-chart parity or measured encoding performance gains.
-
-
Sankey node alignment —
StyleParam.SankeyNodeAlignsupports Left, Right, Center, and Justify throughSankeyNodesand the F# / C# chart conveniences. -
Virtual-WebGL — existing
DisplayOptions.AdditionalHeadTagscan load the optional WebGL 1 virtualization script before plotly.js; the encoded-array guide shows the script ordering. -
#500: Internal refactor — split the monolithic
Chart.fsinto per-chart-family files (Chart2D_Scatter.fs,Chart2D_Bar.fs, etc.) for better maintainability. No API changes. -
Set comparison charts — new composite charts for visualizing set membership and intersections (in
ChartComposite):Chart.Venndraws a Venn diagram comparing two or three sets (set1,set2, optionalSet3), annotating each region with its member count. Axes are locked to a 1:1 pixel ratio so the circles always render round, and colors/labels/text font are customizable.Chart.UpSetdraws an UpSet plot for an arbitrary number of sets: an intersection matrix, an intersection-size bar chart, and a set-size bar chart, with optional per-intersection attribute plots viaSetData/SetDataChartsTitle.- Both take plain
#seq<string>/#seq<#seq<string>>set inputs (treated as sets internally; duplicates ignored) and support the standardUseDefaultsparameter.
New Contributors
- @gvwilson made their first contribution in #478
- @LibraChris made their first contribution in #493
Full Changelog: 5.1.0...6.0.0
Additional extension package releases::