NPlot C# (Wie es für Entwickler funktioniert)

Einführung in NPlot im .NET Framework

NPlot ist eine dynamische Diagrammbibliothek, die speziell für das .NET Framework entwickelt wurde und eine breite Palette an Datenvisualisierungsanforderungen erfüllt. Egal, ob Sie an Desktop-Anwendungen oder webbasierten Lösungen arbeiten, NPlot bietet die Funktionalität, um Daten grafisch, klar und effektiv darzustellen.

Installation von NPlot in Ihrem C#-Projekt

Um NPlot in Ihrem C#-Projekt zu verwenden, müssen Sie es installieren. So fügen Sie NPlot Ihrer Anwendung ganz einfach hinzu:

Verwendung des NuGet-Paketmanagers:

1. Gehen Sie in Visual Studio zu 'Tools' > 'NuGet-Paketmanager' > 'NuGet-Pakete für die Lösung verwalten...'.
2. Suchen Sie nach 'NPlot' und installieren Sie es in Ihrem Projekt.

Erste Schritte mit NPlot

Nach der Installation von NPlot können Sie Diagramme erstellen. Die Benutzerfreundlichkeit von NPlot macht es ideal für Anfänger und ermöglicht die Erstellung von Diagrammen mit nur wenigen Codezeilen.

Erstellen eines einfachen Diagramms

Lassen Sie uns ein Liniendiagramm als erstes Diagramm erstellen:

Einrichten der Diagrammfläche: Erstellen Sie ein PlotSurface2D-Objekt. Dies dient als Leinwand für Ihr Diagramm. Stellen Sie einige Anzeigeeigenschaften ein, um das Erscheinungsbild anzupassen, wie z.B. die Hintergrundfarbe und den Titel.

Hinzufügen von Daten zum Diagramm: Verwenden Sie die LinePlot-Klasse von NPlot, um ein Liniendiagramm zu erstellen. Fügen Sie Datenwerte hinzu, die einer oder mehreren Kategorien angehören. Diese Datenpunkte werden im Diagramm dargestellt.

Anzeige des Diagramms: Fügen Sie das Liniendiagramm zur Diagrammfläche hinzu. Rendern Sie die Diagrammfläche in einem Formular oder einer Benutzersteuerung zur Anzeige.

using System;
using NPlot;

class Program
{
    static void Main()
    {
        // Create a new bitmap plot surface
        var plotSurface = new NPlot.Bitmap.PlotSurface2D(800, 600);

        // Create a line plot
        var linePlot = new LinePlot
        {
            AbscissaData = new double[] { 1, 2, 3, 4, 5 },
            OrdinateData = new double[] { 1, 4, 9, 16, 25 }
        };

        // Add the line plot to the plot surface
        plotSurface.Add(linePlot);

        // Customize the plot (e.g., titles, labels)
        plotSurface.Title = "Sample Plot";
        plotSurface.XAxis1.Label = "X-Axis";
        plotSurface.YAxis1.Label = "Y-Axis";

        // Refresh the plot to render it
        plotSurface.Refresh();

        // Save the plot as a PNG image
        plotSurface.Bitmap.Save("c://plot.png", System.Drawing.Imaging.ImageFormat.Png);

        Console.WriteLine("Plot saved as plot.png");
    }
}

using System;
using NPlot;

class Program
{
    static void Main()
    {
        // Create a new bitmap plot surface
        var plotSurface = new NPlot.Bitmap.PlotSurface2D(800, 600);

        // Create a line plot
        var linePlot = new LinePlot
        {
            AbscissaData = new double[] { 1, 2, 3, 4, 5 },
            OrdinateData = new double[] { 1, 4, 9, 16, 25 }
        };

        // Add the line plot to the plot surface
        plotSurface.Add(linePlot);

        // Customize the plot (e.g., titles, labels)
        plotSurface.Title = "Sample Plot";
        plotSurface.XAxis1.Label = "X-Axis";
        plotSurface.YAxis1.Label = "Y-Axis";

        // Refresh the plot to render it
        plotSurface.Refresh();

        // Save the plot as a PNG image
        plotSurface.Bitmap.Save("c://plot.png", System.Drawing.Imaging.ImageFormat.Png);

        Console.WriteLine("Plot saved as plot.png");
    }
}

Imports System
Imports NPlot

Friend Class Program
	Shared Sub Main()
		' Create a new bitmap plot surface
		Dim plotSurface = New NPlot.Bitmap.PlotSurface2D(800, 600)

		' Create a line plot
		Dim linePlot As New LinePlot With {
			.AbscissaData = New Double() { 1, 2, 3, 4, 5 },
			.OrdinateData = New Double() { 1, 4, 9, 16, 25 }
		}

		' Add the line plot to the plot surface
		plotSurface.Add(linePlot)

		' Customize the plot (e.g., titles, labels)
		plotSurface.Title = "Sample Plot"
		plotSurface.XAxis1.Label = "X-Axis"
		plotSurface.YAxis1.Label = "Y-Axis"

		' Refresh the plot to render it
		plotSurface.Refresh()

		' Save the plot as a PNG image
		plotSurface.Bitmap.Save("c://plot.png", System.Drawing.Imaging.ImageFormat.Png)

		Console.WriteLine("Plot saved as plot.png")
	End Sub
End Class

Hier ist das ausgegebene Diagrammbild:

Nutzung von Balken- und Streudiagrammen

Balkendiagramm: Ideal zur Darstellung von Datenwerten in einer oder mehreren Kategorien. Jeder Balken stellt einen Datenwert dar, wobei seine Höhe die Magnitude des Wertes angibt.

Streudiagramm: Perfekt zur Visualisierung von Datensätzen, bei denen jeder Datenpunkt unabhängig ist. Es plottet Datenpunkte auf einem zweidimensionalen Diagramm und ermöglicht die Analyse von Mustern oder Trends.

Implementierung eines Step Plots

Treppendiagramm: Wird für Daten verwendet, die aufeinanderfolgende Abszissenwerte betreffen, wie zum Beispiel Zeitreihendaten. Es erstellt eine treppenartige Darstellung, die Änderungen zwischen aufeinanderfolgenden Datenpunkten deutlich zeigt.

Einstieg in IronPDF

Installation mit NuGet Package Manager

Um IronPDF in Ihr NPlot-C#-Projekt mithilfe des NuGet-Paketmanagers zu integrieren, gehen Sie folgendermaßen vor:

1. Öffnen Sie Visual Studio und klicken Sie im Lösungsexplorer mit der rechten Maustaste auf Ihr Projekt.
2. Wählen Sie im Kontextmenü "NuGet-Pakete verwalten…" aus.
3. Gehe zum Durchsuchen-Tab und suche nach IronPDF.
4. Wählen Sie die IronPDF-Bibliothek aus den Suchergebnissen aus und klicken Sie auf die Schaltfläche Installieren.
5. Akzeptieren Sie alle Lizenzvereinbarungen.

Wenn Sie IronPDF über die Paketverwaltungskonsole in Ihr Projekt einbinden möchten, führen Sie folgenden Befehl in der Paketverwaltungskonsole aus:

Install-Package IronPdf

Es wird IronPDF in Ihr Projekt holen und installieren.

Installation über NuGet Website

Für einen detaillierten Überblick über IronPDF, einschließlich seiner Funktionen, Kompatibilität und zusätzlicher Download-Optionen, besuchen Sie die IronPDF-Seite auf der NuGet-Website unter https://www.nuget.org/packages/IronPdf.

Installation über DLL

Alternativ können Sie IronPDF direkt in Ihr Projekt integrieren, indem Sie die DLL-Datei verwenden. Laden Sie die ZIP-Datei mit der DLL von der IronPDF Download-Seite herunter. Entpacken Sie es und nehmen Sie die DLL in Ihr Projekt auf.

Erstellen von dynamischen Diagrammen mit NPlot

NPlot ist hervorragend geeignet, um dynamische und visuell ansprechende Diagramme innerhalb von C#-Anwendungen zu erstellen. Dieser Abschnitt führt Sie durch die Erstellung eines Streudiagramms, ein typisches Anwendungsbeispiel zur Darstellung von Daten mit zwei Variablen.

Streudiagramme sind besonders effektiv bei der Visualisierung der Beziehung zwischen den Variablen. Befolgen Sie diese Schritte, um ein Streudiagramm zu erstellen:

1. Diagrammfläche einrichten: Erstellen Sie eine PlotSurface2D-Instanz.
2. Vorbereitung der Daten: Sammeln Sie die Datenwerte, die Sie darstellen möchten. Streudiagramme plotten einzelne Punkte, daher benötigen Sie zwei Arrays von Werten: eins für die x-Koordinaten und ein weiteres für die y-Koordinaten. Sie können der PlotSurface2D beliebig viele Diagramme hinzufügen.
3. Instanziierung eines Streudiagramms: Verwenden Sie die PointPlot- oder ScatterPlot-Klasse von NPlot, um Ihr Diagramm mit Ihren Diagrammobjekten zu erstellen.
4. Anpassung des Diagramms: Wenden Sie verschiedene Anpassungen an, z.B. das Festlegen von Punktstilen, Farben und Achseneigenschaften, um das Diagramm informativ und ansprechend zu gestalten.

using NPlot;

class Program
{
    static void Main()
    {
        var plotSurface = new NPlot.Windows.PlotSurface2D();

        // Prepare data for the scatter plot
        var scatterPlot = new PointPlot
        {
            AbscissaData = new double[] { /* x-coordinates */ },
            OrdinateData = new double[] { /* y-coordinates */ }
        };

        // Add the scatter plot to the plot surface
        plotSurface.Add(scatterPlot);

        // Customize the chart and render the plotSurface
        plotSurface.Refresh();
    }
}

using NPlot;

class Program
{
    static void Main()
    {
        var plotSurface = new NPlot.Windows.PlotSurface2D();

        // Prepare data for the scatter plot
        var scatterPlot = new PointPlot
        {
            AbscissaData = new double[] { /* x-coordinates */ },
            OrdinateData = new double[] { /* y-coordinates */ }
        };

        // Add the scatter plot to the plot surface
        plotSurface.Add(scatterPlot);

        // Customize the chart and render the plotSurface
        plotSurface.Refresh();
    }
}

Imports NPlot

Friend Class Program
	Shared Sub Main()
		Dim plotSurface = New NPlot.Windows.PlotSurface2D()

		' Prepare data for the scatter plot
		Dim scatterPlot = New PointPlot With {
			.AbscissaData = New Double() { },
			.OrdinateData = New Double() { }
		}

		' Add the scatter plot to the plot surface
		plotSurface.Add(scatterPlot)

		' Customize the chart and render the plotSurface
		plotSurface.Refresh()
	End Sub
End Class

Konvertierung von Diagrammen in PDF mit IronPDF

Sobald Sie ein Diagramm mit NPlot erstellt haben, können Sie IronPDF verwenden, um dieses Diagramm in ein PDF-Dokument umzuwandeln. Dieser Vorgang umfasst das Rendern des Diagramms als Bild und dann die Verwendung von IronPDF, um dieses Bild in ein PDF einzubinden. Folgen Sie diesen Schritten, um Diagramme in PDFs umzuwandeln:

1. Diagramm als Bild rendern: Wandeln Sie zunächst Ihr NPlot-Diagramm in ein Bildformat um. Dies kann durch das Zeichnen der PlotSurface2D auf ein Bitmap erfolgen.
2. PDF mit IronPDF erstellen: Verwenden Sie die API von IronPDF, um ein neues PDF-Dokument zu erstellen und das Diagrammbild einzufügen.

using IronPdf;

class Program
{
    static void Main()
    {
        // Assuming 'chartImagePath' is the path to the Bitmap image of your NPlot chart
        var imageFiles = new string[] { "chartImagePath" };

        // Convert image files to PDF and save the output
        ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("Chart.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main()
    {
        // Assuming 'chartImagePath' is the path to the Bitmap image of your NPlot chart
        var imageFiles = new string[] { "chartImagePath" };

        // Convert image files to PDF and save the output
        ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("Chart.pdf");
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main()
		' Assuming 'chartImagePath' is the path to the Bitmap image of your NPlot chart
		Dim imageFiles = New String() { "chartImagePath" }

		' Convert image files to PDF and save the output
		ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("Chart.pdf")
	End Sub
End Class