NPlot C# (Cómo funciona para desarrolladores)

Introducción a NPlot en .NET Framework

NPlot es una biblioteca de gráficos dinámica diseñada para el Marco de Trabajo .NET, atendiendo a una amplia gama de necesidades de visualización de datos. Ya sea que esté trabajando en aplicaciones de escritorio o en soluciones basadas en la web, NPlot ofrece la funcionalidad para representar gráficamente los datos de manera clara y efectiva.

Instalación de NPlot en su proyecto C

Para comenzar a usar NPlot en su proyecto de C#, necesita instalarlo. Aquí le mostramos cómo puede agregar fácilmente NPlot a su aplicación:

Usando el Gestor de Paquetes NuGet:

1. En Visual Studio, vaya a 'Herramientas' > 'Gestor de Paquetes NuGet' > 'Administrar Paquetes NuGet para la Solución...'.
2. Busque 'NPlot' e instálelo en su proyecto.

Primeros pasos con NPlot

Una vez que NPlot está instalado, puede comenzar a crear gráficos. La facilidad de uso de NPlot lo hace ideal para principiantes, permitiendo la creación de gráficos con solo unas pocas líneas de código.

Creación de un gráfico básico

Vamos a crear un gráfico de líneas simple como nuestro primer gráfico:

Configuración de la Superficie del Gráfico: Cree un objeto PlotSurface2D. Esto actúa como el lienzo para su gráfico. Establezca algunas propiedades de visualización para personalizar su apariencia, como el color de fondo y el título.

Agregando Datos al Gráfico: Utilice la clase LinePlot de NPlot para crear un gráfico de líneas. Agregue valores de datos pertenecientes a una o más categorías. Estos puntos de datos se trazarán en el gráfico.

Mostrando el Gráfico: Agregue el gráfico de líneas a la superficie del gráfico. Renderice la superficie del gráfico en un formulario o control de usuario para visualización.

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

Aquí está la imagen del gráfico de salida:

Utilización de gráficos de barras y de dispersión

Gráfico de Barras: Ideal para mostrar valores de datos en una o más categorías. Cada barra representa un valor de datos, con su altura indicando la magnitud del valor.

Gráfico de Dispersión: Perfecto para visualizar conjuntos de datos donde cada punto de datos es independiente. Traza puntos de datos en un gráfico bidimensional, permitiendo el análisis de patrones o tendencias.

Implementación de un Step Plot

Gráfico de Escalones: Usado para datos que involucran valores de abcisa sucesivos, como datos de series temporales. Crea una representación similar a una escalera, mostrando claramente los cambios entre puntos de datos sucesivos.

Cómo empezar con IronPDF

Instalación mediante el gestor de paquetes NuGet

Para integrar IronPDF en su proyecto de NPlot C# utilizando el gestor de paquetes NuGet, siga estos pasos:

1. Abre Visual Studio y en el explorador de soluciones, haz clic derecho en tu proyecto.
2. Elige "Administrar paquetes NuGet…" del menú contextual.
3. Ve a la pestaña de explorar y busca IronPDF.
4. Seleccione la biblioteca IronPDF de los resultados de búsqueda y haga clic en el botón instalar.
5. Acepta cualquier mensaje de acuerdo de licencia.

Si desea incluir IronPDF en su proyecto a través de la consola del gestor de paquetes, ejecute el siguiente comando en la Consola del Gestor de Paquetes:

Install-Package IronPdf

Se descargará e instalará IronPDF en tu proyecto.

Instalación mediante el sitio web de NuGet

Para una descripción detallada de IronPDF, incluyendo sus características, compatibilidad y opciones de descarga adicionales, visita la página de IronPDF en el sitio web de NuGet en https://www.nuget.org/packages/IronPdf.

Instalación mediante DLL

Alternativamente, puedes incorporar IronPDF directamente en tu proyecto utilizando su archivo dll. Descarga el archivo ZIP que contiene el DLL desde la Página de Descarga de IronPDF. Descomprímelo e incluye la DLL en tu proyecto.

Generación de gráficos dinámicos con NPlot

NPlot se destaca en la creación de gráficos dinámicos y visualmente atractivos dentro de aplicaciones C#. Esta sección le guiará a través de la generación de un gráfico de dispersión, un caso típico para mostrar datos con dos variables.

Los gráficos de dispersión son particularmente efectivos para visualizar la relación entre las variables. Siga estos pasos para crear un gráfico de dispersión:

1. Iniciar Superficie del Gráfico: Comience creando una instancia de PlotSurface2D.
2. Preparar Datos: Reúna los valores de datos que desea graficar. Los gráficos de dispersión trazan puntos individuales, así que necesitará dos matrices de valores: una para las coordenadas x y otra para las coordenadas y. Puede agregar tantos gráficos como desee a la PlotSurface2D.
3. Instanciar un Gráfico de Dispersión: Use la clase PointPlot o ScatterPlot de NPlot para crear su gráfico con sus objetos de gráfico.
4. Personalizar el Gráfico: Aplique diversas personalizaciones como configurar los estilos de puntos, colores y propiedades de ejes para hacer el gráfico informativo y atractivo.

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

Convertir gráficos a PDF con IronPDF

Una vez que haya creado un gráfico con NPlot, puede usar IronPDF para convertir este gráfico en un documento PDF. Este proceso implica renderizar el gráfico como una imagen y luego usar IronPDF para incrustar esta imagen en un PDF. Puede seguir estos pasos para convertir gráficos a PDF:

1. Renderizar Gráfico como Imagen: Primero, convierta su gráfico NPlot en un formato de imagen. Esto se puede hacer dibujando el PlotSurface2D sobre un bitmap.
2. Crear PDF con IronPDF: Use la API de IronPDF para crear un nuevo documento PDF e insertar la imagen del gráfico.

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