WebExport

Export functionality for ILNumerics (http://ilnumerics.net/) scene graphs and plot cubes to Plotly (interactive data visualization package). WebExport converts ILNumerics scene graphs (for example a PlotCube containing LinePlot objects) into a standalone HTML fragment or file that uses the Plotly JavaScript Open Source Graphing Library to produce interactive charts.

About Plotly JavaScript Library

Plotly (https://plotly.com/javascript/) is an open source, high-level JavaScript graphing library that produces interactive, publication-quality graphs. It supports many chart types (scatter, line, bar, heatmap, 3D charts, and more) and provides features like hover labels, zooming, panning, and responsive layouts. WebExport produces Plotly-compatible markup so the resulting HTML can be embedded in a web page or opened directly to present an interactive chart.

Features

• Convert ILNumerics scene graphs / plot cubes into Plotly charts
• Output as a standalone HTML string or write directly to a file

Supported plot types

As of March 2025 (only) the following plot types are supported:

• LinePlot

Getting started

Install the NuGet package:

dotnet add package ILNumerics.Community.WebExport

Basic usage examples

Two main entry points are provided:

• ExportString(scene) - returns the HTML fragment as a string
• ExportFile(scene, filePath) - writes the HTML to a file (usually with .html extension)

Examples

1. Export scene to a string

   // Create or obtain an ILNumerics scene (pseudocode)
   // var scene = new Scene() { ... };
   
   string html = WebExport.ExportString(scene);

2. Export scene to a file

   string filePath = "webplot.html";
   WebExport.ExportFile(scene, filePath);
   // The file 'webplot.html' now contains the HTML page

Notes and limitations

• If the provided Scene cannot be converted into any Plotly traces (for example no supported primitives present), the ExportString method returns an empty string and ExportFile will write an empty file.
• The project currently focuses on LinePlot conversion. Other ILNumerics primitives may not be supported yet.
• The generated HTML relies on the Plotly JavaScript library; the exporter embeds the necessary markup for Plotly so the resulting file is standalone.

Contributing

Contributions, bug reports and feature requests are welcome. Please open an issue or a pull request on the GitHub repository.

License

ILNumerics.Community.WebExport is licensed under the terms of the MIT license (http://opensource.org/licenses/MIT, see LICENSE.txt).