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

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.

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' > '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 de 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 tracé 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é en ligne à la surface de tracé. 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

Voici l'image du graphique de sortie :

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

Tracé en barre : 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'amplitude de la valeur.

Graphique de dispersion : Parfait 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

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

Commencer avec IronPDF

Installer en utilisant le Gestionnaire de Packages NuGet

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éparer les données : Rassemblez les valeurs de données que vous souhaitez tracer. 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 tracés que vous le souhaitez à la PlotSurface2D.
3. Instancier un graphique de dispersion : Utilisez les classes PointPlot ou ScatterPlot de NPlot pour créer votre graphique avec vos objets de tracé.
4. Personnaliser le graphique : Appliquez diverses personnalisations comme définir les styles de points, les couleurs et les 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

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. Rendre le graphique en tant qu'image : Tout d'abord, convertissez votre graphique NPlot en un format d'image. Cela peut être fait en dessinant le PlotSurface2D sur un 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