NPlot C# (Comment ça marche pour les développeurs)

Ce didacticiel est conçu pour les débutants désireux d'explorer l'intégration de deux bibliothèques puissantes : NPlot et IronPDF. Ensemble, ils constituent une solide boîte à outils pour la création et l'exportation de graphiques dans les applications C#.

NPlot est une bibliothèque graphique polyvalente dans le Framework .NET, idéale pour générer une large gamme de graphiques et de tracés. Des simples tracés linéaires aux diagrammes de dispersion complexes, NPlot excelle dans l'affichage de données basées sur des échantillons et dans la génération de diagrammes dynamiques, que vous travailliez avec de petits ou de très grands ensembles de données.

IronPDF complète NPlot en permettant la conversion de ces graphiques en documents PDF. Qu'il s'agisse de contenu de courrier électronique en HTML ou de classes d'intrigues spécifiques, IronPDF peut les transformer en PDF de haute qualité.

Cette fonctionnalité est particulièrement utile pour les applications qui nécessitent la génération de rapports ou la documentation des données analysées.

Démarrer avec NPlot

Introduction à NPlot dans le Framework .NET

NPlot est une bibliothèque graphique dynamique conçue pour le Framework .NET, qui répond à un large éventail de besoins en matière de visualisation de données. Que vous travailliez sur des applications de bureau ou des solutions basées sur le web, NPlot offre les fonctionnalités nécessaires pour représenter les données de manière graphique, claire et efficace.

Installation de NPlot dans votre projet C

Pour commencer à utiliser NPlot dans votre projet C#, vous devez l'installer. Voici comment vous pouvez facilement ajouter NPlot à votre application :

Utilisation du gestionnaire de packages NuGet :

1. Dans Visual Studio, allez dans "Outils" > "NuGet Package Manager" > "Gérer les paquets NuGet pour la solution...".

2. Recherchez 'NPlot' et installez-le dans votre projet.

   

Premiers pas avec NPlot

Une fois NPlot installé, vous pouvez commencer à créer des graphiques. La facilité d'utilisation de NPlot en fait un outil idéal pour les débutants, car il permet de créer des tracés avec seulement quelques lignes de code.

Création d'un graphique de base

Créons un simple tracé linéaire comme premier graphique :

Configuration de la surface du tracé : Créez un objet PlotSurface2D. Il s'agit de la toile de fond de votre intrigue. Définissez quelques propriétés d'affichage pour personnaliser son apparence, telles que la couleur d'arrière-plan et le titre.

Ajout de données au graphique : Utilisez la classe LinePlot de NPlot pour créer un graphique en ligne. Ajouter des valeurs de données appartenant à une ou plusieurs catégories. Ces points de données seront reportés sur le graphique.

Affichage du graphique : Ajoutez le tracé en ligne à la surface du graphique. Rendre la surface de l'intrigue dans un formulaire ou un contrôle utilisateur pour l'afficher.

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

Voici l'image du tracé de sortie :

Techniques graphiques avancées avec NPlot

Après avoir maîtrisé les tracés de base, NPlot propose une gamme de types de graphiques plus complexes pour améliorer vos capacités de visualisation de données. Il s'agit notamment de diagrammes à barres, de diagrammes de dispersion et de diagrammes en escalier, chacun convenant à différents types de représentation des données.

Utilisation de diagrammes à barres et de diagrammes de dispersion

Diagramme en barres : Idéal pour afficher les valeurs de données dans une ou plusieurs catégories. Chaque barre représente une valeur de données, sa hauteur indiquant l'ampleur de la valeur.

Nuage de points : Parfait pour visualiser les ensembles de données où chaque point de données est indépendant. Il trace des points de données sur un graphique à deux dimensions, ce qui permet d'analyser des modèles ou des tendances.

Mise en œuvre d'un graphe à étages

Graphique en marches : Utilisé pour les données qui impliquent des valeurs d'abscisse successives, comme les séries chronologiques. Il crée une représentation en forme d'escalier, montrant clairement les changements entre les points de données successifs.

Intégration de NPlot avec IronPDF

L'intégration de NPlot avec IronPDF permet la conversion transparente des graphiques en documents PDF. IronPDF est une bibliothèque puissante qui permet le rendu du contenu HTML et des classes de tracé dans des fichiers PDF de haute qualité. Cette intégration est particulièrement utile pour les applications qui nécessitent de générer des rapports ou de documenter les données analysées.

Commencez avec IronPDF

Commencez à utiliser IronPDF dans votre projet dès aujourd'hui avec un essai gratuit.

Première étape :

Commencer gratuitement

Installer la bibliothèque IronPDF

Installation à l'aide du gestionnaire de paquets NuGet

Pour intégrer IronPDF à votre projet C# de NPlot à l'aide du gestionnaire de paquets NuGet, procédez comme suit :

1. Ouvrez Visual Studio et, dans l'explorateur de solutions, faites un clic droit sur votre projet.

2. Choisissez "Gérer les paquets NuGet..." dans le menu contextuel.

3. Allez dans l'onglet Parcourir et recherchez IronPDF.

4. Sélectionnez la bibliothèque IronPDF dans les résultats de la recherche et cliquez sur le bouton d'installation.

5. Accepter tout accord de licence.

   Si vous souhaitez inclure IronPDF dans votre projet via la console du gestionnaire de paquets, exécutez la commande suivante dans la console du gestionnaire de paquets :

Install-Package IronPdf

Il récupérera et installera IronPDF dans votre projet.

Installation à l'aide du site NuGet

Pour une présentation détaillée d'IronPDF, notamment de ses caractéristiques, de sa compatibilité et des options de téléchargement supplémentaires, visitez la page IronPDF sur le site Web de NuGet à l'adresse https://www.nuget.org/packages/IronPdf.

Installation par DLL

Alternativement, vous pouvez intégrer IronPDF directement dans votre projet en utilisant son fichier dll. Téléchargez le fichier ZIP contenant la DLL depuis la page de téléchargement d'IronPDF. Décompressez-la et incluez la DLL dans votre projet.

Générer des graphiques dynamiques avec NPlot

NPlot excelle dans la création de graphiques dynamiques et visuellement attrayants au sein des applications C#. Cette section vous guidera dans la création d'un diagramme de dispersion, un cas d'utilisation typique pour l'affichage de données comportant deux variables.

Les diagrammes de dispersion sont particulièrement efficaces pour visualiser la relation entre les variables. Suivez les étapes suivantes pour créer un diagramme de dispersion :

1. Initier la surface du graphique : Commencez par créer une instance de PlotSurface2D.

2. Préparer les données : Rassemblez les valeurs de données que vous souhaitez tracer. Les diagrammes de dispersion représentent des points individuels. Vous aurez donc besoin de deux tableaux de valeurs : un pour les coordonnées x et un autre pour les coordonnées y. Vous pouvez ajouter autant de graphiques que vous le souhaitez au PlotSurface2D.

3. Instancier un graphique de dispersion : Utilisez la classe PointPlot ou ScatterPlot de NPlot pour créer votre graphique avec vos objets de tracé.

4. Personnaliser le graphique : Appliquez diverses personnalisations telles que le réglage des styles de points, des couleurs et des propriétés des axes pour rendre le graphique informatif et attrayant.

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

Convertir des graphiques en PDF avec IronPDF

Une fois que vous avez créé un graphique avec NPlot, vous pouvez utiliser IronPDF pour convertir ce graphique en document PDF. Ce processus consiste à rendre le graphique sous forme d'image, puis à utiliser IronPDF pour intégrer cette image dans un PDF. Vous pouvez suivre les étapes suivantes pour convertir des graphiques en PDF :

1. Rendre le graphique en image : Tout d'abord, convertissez votre graphique NPlot en un format d'image. Cela peut être fait en dessinant le PlotSurface2D sur une image bitmap.

2. Créer un PDF avec IronPDF : Utilisez l'API d'IronPDF pour créer un nouveau document PDF et insérer l'image du graphique.

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

Conclusion

Tout au long de ce tutoriel, nous avons exploré l'intégration de deux puissantes bibliothèques en C# : NPlot pour créer des graphiques dynamiques à partir d'éléments dépendant des données, et IronPDF pour convertir ces graphiques en documents PDF.

Cette combinaison offre une boîte à outils complète aux développeurs C#, leur permettant de visualiser les données de manière efficace et de les transférer de manière transparente dans un format d'archivage partageable.

Commencez avec la Licence d'essai gratuite d'IronPDF, disponible à partir de $749.