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:NPlotund IronPDF. Zusammen bilden sie ein robustes Toolkit zur Erstellung und zum Export von Diagrammen in C#-Anwendungen.

NPlot ist eine vielseitige Diagrammbibliothek im .NET-Framework, ideal für das Erstellen einer Vielzahl von Grafiken und Diagrammen. Von einfachen Liniendiagrammen bis zu komplexen Streudiagrammen: NPlot glänzt in der Anzeige von datenbasierten Mustern und der Erstellung dynamischer Diagramme, egal ob Sie mit kleinen oder sehr großen Datensätzen arbeiten.

IronPDF ergänzt NPlot, indem es die Umwandlung dieser Diagramme in PDF-Dokumente ermöglicht. Egal, ob Sie es mit HTML-E-Mail-Inhalten oder spezifischen Grafikklassen zu tun haben, IronPDF kann diese in hochqualitative PDFs umwandeln.

Diese Funktionalität ist besonders nützlich für Anwendungen, die die Erstellung von Berichten oder die Dokumentation analysierter 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 Vielzahl von Datenvisualisierungsanforderungen abdeckt. Ganz gleich, ob Sie an Desktop-Anwendungen oder webbasierten Lösungen arbeiten, NPlot bietet die Funktionalität, 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 einfach zu Ihrer Anwendung hinzu:

Verwendung des NuGet-Paket-Managers:

1. In Visual Studio gehen Sie zu 'Tools' > 'NuGet-Paket-Manager' > 'NuGet-Pakete für Lösung verwalten...'.

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. Die Benutzerfreundlichkeit von NPlot macht es ideal für Anfänger, da es die Erstellung von Diagrammen mit nur wenigen Codezeilen ermöglicht.

Erstellen eines Basisdiagramms

Lassen Sie uns ein einfaches Liniendiagramm als unser erstes Diagramm erstellen:

Einrichten der Plotfläche: Erstellen Sie ein PlotSurface2D-Objekt. Dies dient als Leinwand für Ihr Diagramm. Legen Sie einige Anzeigeeigenschaften fest, um das Erscheinungsbild anzupassen, wie beispielsweise 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 einer oder mehreren Kategorien angehören. Diese Datenpunkte werden im Diagramm dargestellt.

Diagramm anzeigen: Fügen Sie das Liniendiagramm zur Plot-Oberfläche hinzu. Rendern Sie die Plotoberflä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 Ausgabediagrammbild:

Fortgeschrittene Diagrammtechniken mit NPlot

Nachdem Sie die grundlegenden Diagramme gemeistert haben, bietet NPlot eine Reihe komplexerer Diagrammtypen, um Ihre Datenvisualisierungsfähigkeiten zu verbessern. Diese umfassen Balkendiagramme, Streudiagramme und Treppendiagramme, die jeweils für verschiedene Arten der Datenrepräsentation geeignet sind.

Verwendung von Balken- und Streudiagrammen

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

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

Implementierung eines Stufenplots

Stufendiagramm: Wird verwendet für Daten, die aufeinanderfolgende Abszissenwerte beinhalten, wie z. B. Zeitreihendaten. Es erzeugt eine treppenartige Darstellung, die die Änderungen zwischen aufeinanderfolgenden Datenpunkten deutlich zeigt.

Integration von NPlot mit IronPDF

Die Integration von NPlot mit IronPDF ermöglicht die nahtlose Umwandlung von Diagrammen in PDF-Dokumente. IronPDF ist eine leistungsstarke Bibliothek, die es ermöglicht, HTML-Inhalte und Diagrammklassen in hochwertige PDF-Dateien zu rendern. Diese Integration ist besonders nützlich für Anwendungen, die die Erstellung von Berichten oder die Dokumentation analysierter Daten erfordern.

IronPDF-Bibliothek installieren

Installieren mit NuGet

Install-Package IronPdf

nuget.org/packages/IronPdf/

oder

Herunterladen DLL

DLL herunterladen

Manuelle Installation in Ihr Projekt

Installieren mit NuGet

Install-Package IronPdf

nuget.org/packages/IronPdf/

oder

Herunterladen DLL

DLL herunterladen

Manuelle Installation in Ihr Projekt

Fangen Sie noch heute an, IronPDF in Ihrem Projekt mit einer kostenlosen Testversion zu verwenden.

Erster Schritt:

Kostenloser Start

Mit Nuget installieren

Schau dir an IronPDF an Nuget Für schnelle Installation und Bereitstellung. Mit über 8 Millionen Downloads verwandelt es PDF mit C#.

nuget.org/packages/IronPdf/

Install-Package IronPdf

DLL herunterladen

Erwägen Sie die Installation der IronPDF DLL direkt. Laden Sie es herunter und installieren Sie es manuell für Ihr Projekt oder die GAC-Form: IronPdf.zip

Manuelle Installation in Ihr Projekt

DLL herunterladen

Mit NuGet-Paket-Manager installieren

Um IronPDF in Ihr NPlot-C#-Projekt mithilfe des NuGet-Paketmanagers zu integrieren, befolgen Sie diese Schritte:

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

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

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 Installationsschaltfläche.

5. Akzeptieren Sie jede Lizenzvereinbarungsaufforderung.

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

Install-Package IronPdf

Es lädt IronPDF herunter und installiert es in Ihr Projekt.

Installation über die NuGet-Website

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

Über DLL installieren

Alternativ können Sie IronPDF direkt in Ihr Projekt integrieren, indem Sie dessen DLL-Datei verwenden. Laden Sie die ZIP-Datei herunter, die die DLL enthält, von diesemLink. Entpacken Sie es und fügen Sie die DLL in Ihr Projekt ein.

Erstellen dynamischer Diagramme mit NPlot

NPlot glänzt in der Erstellung dynamischer und optisch ansprechender Diagramme innerhalb von C#-Anwendungen. Dieser Abschnitt führt Sie durch die Erstellung eines Streudiagramms, einem typischen Anwendungsfall zur Darstellung von Daten mit zwei Variablen.

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

1. Initiieren Sie die Plotoberfläche: Beginnen Sie mit der Erstellung einer PlotSurface2D-Instanz.

2. Daten vorbereiten: Sammeln Sie die Datenwerte, die Sie plotten möchten. Streudiagramme plotten einzelne Punkte, daher benötigen Sie zwei Arrays von Werten: eines für die x-Koordinaten und ein weiteres für die y-Koordinaten. Sie können dem PlotSurface2D so viele Diagramme hinzufügen, wie Sie möchten.

3. Einen Streudiagramm instanziieren: Verwenden Sie die PointPlot oder ScatterPlot Klasse von NPlot, um Ihr Diagramm mit Ihren Plot-Objekten zu erstellen.

4. Diagram anpassen: Wenden Sie verschiedene Anpassungen an, wie das Festlegen 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

Diagramme mit IronPDF in PDF umwandeln

Sobald Sie mit NPlot ein Diagramm erstellt haben, können Sie IronPDF verwenden, um dieses Diagramm in ein PDF-Dokument zu konvertieren. Dieser Prozess beinhaltet das Rendern des Diagramms als Bild und dann die Verwendung von IronPDF, um dieses Bild in eine PDF einzubetten. Sie können die folgenden Schritte befolgen, um Diagramme in PDF zu konvertieren:

1. Diagram als Bild rendern: Zuerst konvertieren Sie Ihr NPlot-Diagramm in ein Bildformat. Dies kann durch das Zeichnen von 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.

// 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")

Fazit

Im Verlauf dieses Tutorials haben wir die Integration von zwei leistungsstarken Bibliotheken in C# untersucht: NPlot zum Erstellen dynamischer, datengesteuerter Diagramme aus datengesteuerten Elementen und IronPDF zum Konvertieren dieser Diagramme in PDF-Dokumente.

Diese Kombination bietet C#-Entwicklern ein umfassendes Toolkit, das es ihnen ermöglicht, Daten effektiv zu visualisieren und diese Daten nahtlos in ein freigabefähiges, archivierungsfähiges Format zu überführen.

Beginnen Sie mit IronPDF'sKostenlose Testversion, verfügbar ab $749.