Ce tutoriel est conçu pour les débutants souhaitant explorer l'intégration de deux puissantes bibliothèques : NPlot et IronPDF. Ensemble, elles forment une boîte à outils robuste pour créer et exporter des graphiques dans des applications C#.

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

IronPDF complète NPlot en permettant la conversion de ces graphiques en documents PDF. Que vous traitiez des contenus d'e-mails HTML ou des classes de tracés spécifiques, IronPDF peut les rendre en PDF de haute qualité.

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

Pour commencer avec NPlot

Introduction à NPlot dans le Framework .NET

NPlot est une bibliothèque dynamique de graphiques conçue pour le Framework .NET, répondant à une large gamme de besoins en visualisation de données. Que vous travailliez sur des applications de bureau ou des solutions basées sur le web, NPlot offre la fonctionnalité de représenter graphiquement des données de manière claire et efficace.

Installer 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' > 'Gestionnaire de packages NuGet' > 'Gérer les packages 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 choix idéal pour les débutants, permettant la création de graphiques avec seulement quelques lignes de code.

Création d'un graphique de base

Créons un tracé en ligne simple comme notre premier graphique :

Configuration de la surface du tracé : Créez un objet PlotSurface2D. Cela sert de toile pour votre tracé. Définissez quelques propriétés d'affichage pour personnaliser son apparence, comme la couleur de fond et le titre.

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

Affichage du graphique : Ajoutez le tracé linéaire à la surface du graphique. Rendez la surface de tracé dans un formulaire ou un contrôle utilisateur pour affichage.

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

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

Voici l'image du graphique de sortie :

Techniques avancées de création de graphiques avec NPlot

Après avoir maîtrisé les tracés de base, NPlot offre une gamme de types de graphiques plus complexes pour améliorer vos capacités de visualisation de données. Celles-ci incluent les tracés en barres, les graphiques de dispersion, et les tracés en escalier, chacun adapté à différents types de représentation de données.

Utilisation des tracés en barres et des graphiques de dispersion

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

Nuage de points : idéal pour visualiser des ensembles de données où chaque point de données est indépendant. Il trace les points de données sur un graphique bidimensionnel, permettant l'analyse de motifs ou de tendances.

Mise en œuvre d'un tracé en escalier

Graphique en escalier : utilisé pour les données comportant des valeurs d'abscisse successives, telles que les données de séries chronologiques. Il crée une représentation en 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 fluide de graphiques en documents PDF. IronPDF est une bibliothèque puissante qui permet le rendu de contenu HTML et de classes de tracés en fichiers PDF de haute qualité. Cette intégration est particulièrement utile pour les applications qui nécessitent la génération de rapports ou la documentation de données analysées.

Commencer avec IronPDF

Installer la bibliothèque IronPDF

Installer via NuGet Package Manager

Pour intégrer IronPDF dans votre projet NPlot C# en utilisant le gestionnaire de packages NuGet, suivez ces étapes :

1. Ouvrez Visual Studio et dans l'explorateur de solutions, faites un clic droit sur votre projet.
2. Choisissez "Gérer les packages NuGet..." dans le menu contextuel.
3. Allez à l'onglet de navigation et recherchez IronPDF.
4. Sélectionnez la bibliothèque IronPDF dans les résultats de recherche et cliquez sur le bouton d'installation.
5. Acceptez tout accord de licence s'il y en a.

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

Install-Package IronPdf

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

Installer en utilisant le site NuGet

Pour une vue d'ensemble détaillée d'IronPDF, y compris ses fonctionnalités, compatibilités, et autres options de téléchargement, visitez la page IronPDF sur le site NuGet à https://www.nuget.org/packages/IronPdf.

Installer via DLL

Alternativement, vous pouvez incorporer 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 IronPDF. Décompressez-le, et incluez le DLL dans votre projet.

Génération de graphiques dynamiques avec NPlot

NPlot excelle dans la création de graphiques dynamiques et visuellement attrayants dans les applications C#. Cette section vous guidera dans la génération d'un graphique de dispersion, un cas d'utilisation typique pour afficher des données avec deux variables.

Les graphiques de dispersion sont particulièrement efficaces pour visualiser la relation entre les variables. Suivez ces étapes pour créer un tracé de dispersion :

1. Initier la surface de tracé : Commencez par créer une instance PlotSurface2D.
2. Préparation des données : Rassemblez les valeurs de données que vous souhaitez représenter graphiquement. Les graphiques de dispersion tracent 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. Instanciez 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 la définition des styles de points, des couleurs et des propriétés des axes pour rendre le graphique informatif et attrayant.

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

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

Conversion de 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 implique de rendre le graphique sous forme d'image, puis d'utiliser IronPDF pour intégrer cette image dans un PDF. Vous pouvez suivre ces étapes pour convertir des graphiques en PDF :

1. Afficher le graphique sous forme d'image : Commencez par convertir votre graphique NPlot en format 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 y insérer l'image du graphique.

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

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

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 et orientés données à partir d'éléments dépendants des données, et IronPDF pour convertir ces graphiques en documents PDF.

Cette combinaison fournit une boîte à outils complète pour les développeurs C#, leur permettant de visualiser les données efficacement et de passer ensuite sans encombre ces données dans un format partageable et archivable.

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