NPlot em C# (Como funciona para desenvolvedores)

Introdução ao NPlot no .NET Framework

NPlot é uma biblioteca de gráficos dinâmicos projetada para o .NET Framework, que atende a uma ampla gama de necessidades de visualização de dados. Quer você esteja trabalhando em aplicativos para desktop ou em soluções baseadas na web, o NPlot oferece a funcionalidade para representar dados de forma gráfica, clara e eficaz.

Instalando o NPlot em seu projeto C

Para começar a usar o NPlot em seu projeto C#, você precisa instalá-lo. Veja como você pode adicionar facilmente o NPlot à sua aplicação:

Utilizando o Gerenciador de Pacotes NuGet :

1. No Visual Studio, acesse 'Ferramentas' > 'Gerenciador de Pacotes NuGet ' > 'Gerenciar Pacotes NuGet para a Solução...'.
2. Procure por 'NPlot' e instale-o em seu projeto.

Primeiros passos com NPlot

Após instalar o NPlot, você pode começar a criar gráficos. A facilidade de uso do NPlot o torna ideal para iniciantes, permitindo a criação de gráficos com apenas algumas linhas de código.

Criando um gráfico básico

Vamos criar um gráfico de linhas simples como nosso primeiro gráfico:

Configurando a superfície do gráfico: Crie um objeto PlotSurface2D. Isso serve como tela para sua trama. Defina algumas propriedades de exibição para personalizar sua aparência, como a cor de fundo e o título.

Adicionando dados ao gráfico: Use a classe LinePlot do NPlot para criar um gráfico de linhas. Adicionar valores de dados pertencentes a uma ou mais categorias. Esses pontos de dados serão plotados no gráfico.

Exibição do gráfico: Adicione o gráfico de linhas à superfície de plotagem. Renderize a superfície do gráfico em um formulário ou controle de usuário para exibição.

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

Aqui está a imagem do gráfico resultante:

Utilizando gráficos de barras e de dispersão

Gráfico de barras: Ideal para exibir valores de dados em uma ou mais categorias. Cada barra representa um valor de dados, sendo sua altura indicativa da magnitude desse valor.

Gráfico de dispersão: Ideal para visualizar conjuntos de dados onde cada ponto de dados é independente. Ela representa pontos de dados em um gráfico bidimensional, permitindo a análise de padrões ou tendências.

Implementando um gráfico em degraus

Gráfico de degraus: Utilizado para dados que envolvem valores de abscissa sucessivos, como dados de séries temporais. Cria uma representação em forma de escada, mostrando claramente as mudanças entre pontos de dados sucessivos.

Comece a usar o IronPDF

Instale usando o Gerenciador de Pacotes NuGet

Para integrar o IronPDF ao seu projeto NPlot C# usando o gerenciador de pacotes NuGet , siga estes passos:

1. Abra o Visual Studio e, no explorador de soluções, clique com o botão direito do mouse no seu projeto.
2. Selecione "Gerenciar pacotes NuGet …" no menu de contexto.
3. Vá para a aba de navegação e pesquise IronPDF.
4. Selecione a biblioteca IronPDF nos resultados da pesquisa e clique no botão Instalar.
5. Aceite qualquer solicitação de contrato de licença.

Se você deseja incluir o IronPDF em seu projeto por meio do console do gerenciador de pacotes, execute o seguinte comando no console do gerenciador de pacotes:

Install-Package IronPdf

Ele irá buscar e instalar o IronPDF no seu projeto.

Instalar usando o site do NuGet

Para obter uma visão geral detalhada do IronPDF, incluindo seus recursos, compatibilidade e opções adicionais de download, visite a página do IronPDF no site do NuGet emhttps://www.nuget.org/packages/IronPdf .

Instalar via DLL

Alternativamente, você pode incorporar o IronPDF diretamente em seu projeto usando o arquivo DLL. Baixe o arquivo ZIP contendo a DLL na página de downloads do IronPDF . Descompacte o arquivo e inclua a DLL no seu projeto.

Gerando gráficos dinâmicos com NPlot

O NPlot se destaca na criação de gráficos dinâmicos e visualmente atraentes em aplicações C#. Esta seção irá orientá-lo na geração de um gráfico de dispersão, um caso de uso típico para exibir dados com duas variáveis.

Os diagramas de dispersão são particularmente eficazes para visualizar a relação entre as variáveis. Siga estes passos para criar um gráfico de dispersão:

1. Iniciar a superfície de plotagem: Comece criando uma instância de PlotSurface2D.
2. Preparar os dados: Reúna os valores de dados que deseja representar graficamente. Os gráficos de dispersão representam pontos individuais, portanto, você precisará de duas matrizes de valores: uma para as coordenadas x e outra para as coordenadas y. Você pode adicionar quantos gráficos quiser ao PlotSurface2D.
3. Instanciar um gráfico de dispersão: Use a classe PointPlot ou ScatterPlot do NPlot para criar seu gráfico com seus objetos de plotagem.
4. Personalize o gráfico: Aplique diversas personalizações, como definir os estilos dos pontos, as cores e as propriedades dos eixos para tornar o gráfico informativo e atraente.

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

Convertendo gráficos para PDF com o IronPDF

Depois de criar um gráfico com o NPlot, você pode usar o IronPDF para convertê-lo em um documento PDF. Esse processo envolve renderizar o gráfico como uma imagem e, em seguida, usar o IronPDF para incorporar essa imagem em um PDF. Você pode seguir estes passos para converter gráficos em PDF:

1. Renderizar gráfico como imagem: Primeiro, converta seu gráfico NPlot para o formato de imagem. Isso pode ser feito desenhando o PlotSurface2D em um bitmap.
2. Criar PDF com IronPDF: Utilize a API do IronPDF para criar um novo documento PDF e inserir a imagem do 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