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

Dieses Tutorial richtet sich an Anfänger, die die Integration zweier leistungsstarker Bibliotheken erkunden möchten: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.

Installieren 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 von NuGet Package Manager:

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.

Hinzufügen von Daten zum Plot: Verwenden Sie die Klasse LinePlot 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.

Displaying the Chart: Fügen Sie das Liniendiagramm zur 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

Balkenplot: Ideal für die Anzeige 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 für die 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

Schrittweiser Plot: Wird für Daten verwendet, die aufeinanderfolgende Abszissenwerte enthalten, 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 auch direkt in Ihr Projekt einbinden, indem Sie die DLL-Datei verwenden. Laden Sie die ZIP-Datei, die die DLL enthält, von derIronPDF Download-Seite. 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 Surface initiieren: Beginnen Sie mit der Erstellung einer PlotSurface2D-Instanz.

2. Daten vorbereiten: Erfassen 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 der "PlotSurface2D" so viele Flächen hinzufügen, wie Sie möchten.

3. Instantiate a Scatter Plot: Verwenden Sie die Klasse PointPlot oder ScatterPlot von NPlot, um Ihr Diagramm mit Ihren Plot-Objekten zu erstellen.

4. Das Diagramm anpassen: Wenden Sie verschiedene Anpassungen an, wie z. B. die Einstellung der Punktstile, 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: Konvertieren Sie zunächst Ihr NPlot-Diagramm in ein Bildformat. Dies kann durch Zeichnen der "PlotSurface2D" auf eine Bitmap geschehen.

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 IronPDFsKostenlose Probelizenz, verfügbar über $749.