ILNumerics.Drawing.Platforms 7.0.230-rc02

ILNumerics Ultimate VS

This package is part of ILNumerics Ultimate VS - a powerful framework for technical application development on .NET.

General Info about ILNumerics: (specific info about this package are found at the end)

ILNumerics provides packages for the convenient authoring of:

• Fast numerical algorithms in Matlab(R) and numpy style
  • Efficient n-d array classes: ILNumerics.Computing (online docu)
  • Large selection of fundamental, mathematical array functions
• Toolboxes for
  • Interpolation: ILNumerics.Toolboxes.Interpolation (online docu)
  • Optimization: ILNumerics.Toolboxes.Optimization (online docu)
  • Statistics: ILNumerics.Toolboxes.Statistics (online docu)
  • HDF5: ILNumerics.IO.HDF5 (online docu)
• Flexible, good looking, fast and robust 2D and 3D visualizations.
  • ILNumerics Visualization Engine: ILNumerics.Drawing: (online docu)
    • Scene graph based rendering of line-, scatter-, XY-, contour-, surface plots.
    • Compose complex scenes built of simple point-, lines-, and triangle-shapes.
    • Output to common image formats and SVG.
  • Windows Forms Controls: ILNumerics.Drawing.Platforms
    • Interactivity on Windows.Forms: ILNumerics.Drawing.Panel
    • Hardware acceleration (OpenGL)
    • Fully featured GDI+ fallback.
  • ILNumerics Drawing Extensions: ILNumerics.Toolboxes.Drawing2
    • Bar-, spline-, region-, error-, candlestick-, fill area-, stacked area-, box plots.
    • More and faster surfaces, smooth surface.
• Visual Studio Tools: get the free Array Visualizer from MS Marketplace

Compatibility

ILNumerics is compatible with all .NET runtimes since .NET Framework 4.6.1., including .NET Core, .NET 5.0, .NET 6.0.

We've invested great effort to translate and keep up to date the quasi standard algorithms for all computational routines, including linear algebra, FFT and optimization methods. These purely managed implementations are the first to bring professional robustness and precision to .NET. Hence, ILNumerics runs efficiently on any platform supported by .NET! Optionally, native libraries can be used to replace the managed default implementation. For the Windows platform, such native, optimized libraries are provided, too.

Performance

ILNumerics apps are typically much faster than alternatives: faster to implement and faster during execution. With ILNumerics the size of your data is not limited by the managed heap. ILNumerics n-dimensional Array<T> bridges the gap from high-level mathematical expressions down to native memory robustly, efficiently, and transparently. It allows to connect your data to any 3rd party without hassle. Further, it is able to host your data on any computational resource found, including CPUs and GPUs - key for heterogeneous, parallel computing.

Visualization Engine (dynamic controls)

Start with this package for authoring of interactive professional, technical visualizations in 2D and 3D. This package enables one to utilize any scene graph configured with ILNumerics Visualization Engine to be displayed inside a specialized Windows.Forms control: ILNumerics.Drawing.Panel. Hardware accelerated rendering (OpenGL) ensures fast interactions even for large data. The control can be used on Windows in .NET Framework, .NET Core / .NET5... applications within in Windows Forms and WPF (via WinformsHost control) projects.

For robust distribution on legacy machines a fully featured fallback renderer based on GDI+ is included. Mouse eventing (bubbling) and picking is supported as well as standard mouse interace: rotation, panning, zoom. All scenes and parts of it are designed to be dynamically updatable.

For static visualizations and offscreen rendering on any platform start with ILNumerics.Drawing.

For more / faster / more complex plotting types see the ILNumerics.Toolboxes.Drawing2 package.

In order to write efficient algorithms, use the Computing Engine package. While not being a requirement, it is often handy for data pre-processing.

General Preparation

• install the ILNumerics Visual Studio extension
• download your trial license.
• activate your seat.

Quick Start - in Visual Studio

• Create a new C# Windows Forms application.

• reference the ILNumerics.Drawing.Platforms package in your project.

• reference the Computing Engine package in your project.

• Include the following 'using' directives (C#) on top of your Form1.cs file:

    using ILNumerics;
    using ILNumerics.Drawing;
    using ILNumerics.Drawing.Plotting;
    using static ILNumerics.ILMath;
    using static ILNumerics.Globals; 
  

• Add the following code to the Form1 class:

    ILNumerics.Drawing.Panel m_panel; 
    protected override void OnLoad(EventArgs e) {
        base.OnLoad(e);
        // create and wire up a new 3D panel: 
        m_panel = new ILNumerics.Drawing.Panel();
        m_panel.Load += M_panel_Load;
        Controls.Add(m_panel);
        // any size is fine: 
        m_panel.Dock = DockStyle.Fill;
    }
  
    private void M_panel_Load(object sender, EventArgs e) {
        // simple example data
        Array<float> A = tosingle(ILNumerics.SpecialData.sinc(30, 20));
        // a new 3D surface 
        var surf = new Surface(A, colormap: Colormaps.Copper);
        // add a colorbar
        surf.Add(new Colorbar());
        // add a plot cube and insert the surface
        m_panel.Scene.Add(new PlotCube(twoDMode: false) { surf }); 
    }
  

• Hit F5, resize and rotate the scene.

• read the beginners guide and start writing more visualizations!

Documentation

• https://ilnumerics.net/general-usage_v5.html#
• https://ilnumerics.net/Visualization-API.html
• https://ilnumerics.net/offscreen-rendering.html

Examples

ILNumerics example collection