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

Dieses Tutorial ist für Anfänger gedacht, die daran interessiert sind, die Integration von zwei leistungsstarken Bibliotheken zu erkunden: NPlot und IronPDF. Zusammen bilden sie ein robustes Toolkit zum Erstellen und Exportieren von Diagrammen in C#-Anwendungen.

NPlot ist eine vielseitige Diagrammbibliothek im .NET-Framework, die sich ideal für die Erstellung einer breiten Palette von Diagrammen und Plots eignet. Von einfachen Liniendiagrammen bis hin zu komplexen Punktdiagrammen - NPlot eignet sich hervorragend für die Anzeige von stichprobenbasierten Daten und die Erstellung dynamischer Diagramme, unabhängig davon, ob Sie mit kleinen oder sehr großen Datensätzen arbeiten.

IronPDF ergänzt NPlot, indem es die Konvertierung dieser Diagramme in PDF-Dokumente ermöglicht. Egal, ob es sich um HTML-E-Mail-Inhalte oder bestimmte Plot-Klassen handelt, IronPDF kann sie in hochwertige PDFs umwandeln.

Diese Funktion ist besonders nützlich für Anwendungen, die die Erstellung von Berichten oder die Dokumentation der analysierten Daten erfordern.

Erste Schritte mit NPlot

Einführung in NPlot im .NET-Framework

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

Installation von NPlot in Ihrem C#-Projekt

Um NPlot in Ihrem C#-Projekt verwenden zu können, müssen Sie es installieren. Hier erfahren Sie, wie Sie NPlot ganz einfach zu Ihrer Anwendung hinzufügen können:

Verwendung des NuGet-Paket-Managers:

1. Gehen Sie in Visual Studio zu "Tools" > "NuGet Package Manager" > "Manage NuGet Packages for Solution...".

2. Suchen Sie nach 'NPlot' und installieren Sie es in Ihrem Projekt.

   

Erste Schritte mit NPlot

Sobald NPlot installiert ist, können Sie mit der Erstellung von Diagrammen beginnen. NPlot ist aufgrund seiner Benutzerfreundlichkeit ideal für Anfänger, da es die Erstellung von Diagrammen mit nur wenigen Zeilen Code ermöglicht.

Erstellen eines Basisdiagramms

Als erstes Diagramm erstellen wir ein einfaches Liniendiagramm:

Einrichten der Plot-Oberfläche: Erstellen Sie ein PlotSurface2D-Objekt. Dieser dient als Leinwand für Ihre Handlung. Legen Sie einige Anzeigeeigenschaften fest, um das Erscheinungsbild anzupassen, z. B. die Hintergrundfarbe und den Titel.

Daten zum Diagramm hinzufügen: Verwenden Sie die LinePlot-Klasse von NPlot, um ein Liniendiagramm zu erstellen. Fügen Sie Datenwerte hinzu, die zu einer oder mehreren Kategorien gehören. Diese Datenpunkte werden in das Diagramm eingezeichnet.

Diagramm anzeigen: Fügen Sie das Liniendiagramm der Diagrammoberfläche hinzu. Rendering der Plotfläche in einem Formular oder einem Benutzersteuerelement zur Anzeige.

using System;
using NPlot;

// Create a new bitmap plot surface
var plotSurface = new NPlot.Bitmap.PlotSurface2D(800, 600);

// Create a line plot
var linePlot = new LinePlot();
linePlot.AbscissaData = new double [] { 1, 2, 3, 4, 5 };
linePlot.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;

// Create a new bitmap plot surface
var plotSurface = new NPlot.Bitmap.PlotSurface2D(800, 600);

// Create a line plot
var linePlot = new LinePlot();
linePlot.AbscissaData = new double [] { 1, 2, 3, 4, 5 };
linePlot.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

' Create a new bitmap plot surface
Private plotSurface = New NPlot.Bitmap.PlotSurface2D(800, 600)

' Create a line plot
Private linePlot = New LinePlot()
linePlot.AbscissaData = New Double () { 1, 2, 3, 4, 5 }
linePlot.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")

Hier ist das Ausgabebild:

Erweiterte Charting-Techniken mit NPlot

Nachdem Sie die grundlegenden Diagramme beherrschen, bietet NPlot eine Reihe von komplexeren Diagrammtypen, mit denen Sie Ihre Datenvisualisierungsmöglichkeiten erweitern können. Dazu gehören Balkendiagramme, Punktdiagramme und Stufendiagramme, die sich jeweils für unterschiedliche Arten der Datendarstellung eignen.

Verwendung 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 Größe des Wertes angibt.

Streudiagramm: Ideal zur Visualisierung von Datensätzen, bei denen jeder Datenpunkt unabhängig ist. Sie stellt Datenpunkte in einem zweidimensionalen Diagramm dar und ermöglicht so die Analyse von Mustern oder Trends.

Implementierung eines Step Plots

Stufenplot: Wird für Daten verwendet, die aufeinanderfolgende Abszissenwerte betreffen, wie z.B. Zeitreihendaten. Es entsteht eine treppenartige Darstellung, die Veränderungen zwischen aufeinanderfolgenden Datenpunkten deutlich macht.

Integration von NPlot in IronPDF

Die Integration von NPlot in IronPDF ermöglicht die nahtlose Umwandlung von Diagrammen in PDF-Dokumente. IronPDF ist eine leistungsstarke Bibliothek, die das Rendering von HTML-Inhalten und Plot-Klassen in hochwertige PDF-Dateien ermöglicht. Diese Integration ist besonders nützlich für Anwendungen, bei denen Berichte erstellt oder analysierte Daten dokumentiert werden müssen.

Erste Schritte mit IronPDF

Beginnen Sie noch heute mit der Verwendung von IronPDF in Ihrem Projekt mit einer kostenlosen Testversion.

Erster Schritt:

Kostenloser Start

IronPDF-Bibliothek installieren

Installation mit NuGet-Paketmanager

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

1. Öffnen Sie Visual Studio und klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt.

2. Wählen Sie "NuGet-Pakete verwalten..." aus dem Kontextmenü.

3. Gehen Sie auf die Registerkarte Durchsuchen und suchen Sie nach IronPDF.

4. Wählen Sie die IronPDF-Bibliothek aus den Suchergebnissen aus und klicken Sie auf die Schaltfläche Installieren.

5. Akzeptieren Sie die Aufforderung zu einer Lizenzvereinbarung.

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

Install-Package IronPdf

Es wird IronPDF in Ihr Projekt holen und installieren.

Installation über die NuGet-Website

Einen detaillierten Überblick über IronPDF, einschließlich seiner Funktionen, Kompatibilität und zusätzlicher Download-Optionen, finden Sie auf der 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, die die DLL enthält, von der IronPDF-Download-Seite herunter. Entpacken Sie die Datei, und binden Sie die DLL in Ihr Projekt ein.

Erzeugen von dynamischen Diagrammen mit NPlot

NPlot eignet sich hervorragend für die Erstellung dynamischer und visuell ansprechender Diagramme in C#-Anwendungen. Dieser Abschnitt führt Sie durch die Erstellung eines Punktdiagramms, einem typischen Anwendungsfall für die Anzeige von Daten mit zwei Variablen.

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

1. Plot-Oberfläche initiieren: Beginnen Sie mit der Erstellung einer PlotSurface2D-Instanz.

2. Daten vorbereiten: Sammeln Sie die Datenwerte, die Sie darstellen möchten. Da in Punktdiagrammen einzelne Punkte dargestellt werden, benötigen Sie zwei Wertefelder: eines für die x-Koordinaten und eines für die y-Koordinaten. Sie können dem PlotSurface2D so viele Plots hinzufügen, wie Sie möchten.

3. Ein Streudiagramm instanziieren: Verwenden Sie die NPlot-Klasse PointPlot oder ScatterPlot, um Ihr Diagramm mit Ihren Grafikobjekten zu erstellen.

4. Diagramm anpassen: Wenden Sie verschiedene Anpassungen an, wie z.B. das Festlegen von Punktstilen, Farben und Achseneigenschaften, um das Diagramm informativ und ansprechend zu gestalten.

var plotSurface = new NPlot.Windows.PlotSurface2D();
var scatterPlot = new PointPlot();
scatterPlot.AbscissaData = new double [] { /* x-coordinates */ };
scatterPlot.OrdinateData = new double [] { /* y-coordinates */ };
plotSurface.Add(scatterPlot);
// Additional code to render the plotSurface

var plotSurface = new NPlot.Windows.PlotSurface2D();
var scatterPlot = new PointPlot();
scatterPlot.AbscissaData = new double [] { /* x-coordinates */ };
scatterPlot.OrdinateData = new double [] { /* y-coordinates */ };
plotSurface.Add(scatterPlot);
// Additional code to render the plotSurface

Dim plotSurface = New NPlot.Windows.PlotSurface2D()
Dim scatterPlot = New PointPlot()
scatterPlot.AbscissaData = New Double () {}
scatterPlot.OrdinateData = New Double () {}
plotSurface.Add(scatterPlot)
' Additional code to render the plotSurface

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 zu konvertieren. Bei diesem Verfahren wird das Diagramm als Bild gerendert und dann mit IronPDF in ein PDF-Dokument eingebettet. Mit den folgenden Schritten können Sie Diagramme in PDF konvertieren:

1. Diagramm als Bild rendern: Zuerst konvertieren Sie Ihr NPlot-Diagramm in ein Bildformat. Dies kann durch Zeichnen der PlotSurface2D auf eine 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.

// Assuming 'chartImage' is the Bitmap of your NPlot chart
var imageFiles = new string [] { chartImagePath };
ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("Chart.pdf");

// Assuming 'chartImage' is the Bitmap of your NPlot chart
var imageFiles = new string [] { chartImagePath };
ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("Chart.pdf");

' Assuming 'chartImage' is the Bitmap of your NPlot chart
Dim imageFiles = New String () { chartImagePath }
ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("Chart.pdf")

Schlussfolgerung

In diesem Tutorial haben wir uns mit der Integration zweier leistungsstarker Bibliotheken in C# beschäftigt: NPlot zur Erstellung dynamischer, datengesteuerter Diagramme aus datenabhängigen Elementen und IronPDF zur Konvertierung dieser Diagramme in PDF-Dokumente.

Diese Kombination bietet ein umfassendes Toolkit für C#-Entwickler, mit dem sie Daten effektiv visualisieren und anschließend nahtlos in ein gemeinsam nutzbares Archivierungsformat überführen können.

Beginnen Sie mit der kostenlosen Testlizenz von IronPDF, erhältlich ab $749.