NPlot C# (jak to działa dla programistów)

Wprowadzenie do NPlot w .NET Framework

NPlot to biblioteka do tworzenia dynamicznych wykresów zaprojektowana dla platformy .NET Framework, zaspokajająca szeroki zakres potrzeb związanych z wizualizacją danych. Niezależnie od tego, czy pracujesz nad aplikacjami desktopowymi, czy rozwiązaniami internetowymi, NPlot oferuje funkcje umożliwiające graficzne, przejrzyste i skuteczne przedstawianie danych.

Instalacja NPlot w projekcie C

Aby rozpocząć korzystanie z NPlot w projekcie C#, należy go zainstalować. Oto jak w prosty sposób dodać NPlot do swojej aplikacji:

Korzystanie z menedżera pakietów NuGet:

1. W programie Visual Studio przejdź do "Narzędzia" > "Menedżer pakietów NuGet" > "Zarządzaj pakietami NuGet dla rozwiązania...".
2. Wyszukaj "NPlot" i zainstaluj go w swoim projekcie.

Pierwsze kroki z NPlot

Po zainstalowaniu NPlot można rozpocząć tworzenie wykresów. Łatwość obsługi NPlot sprawia, że jest on idealny dla początkujących, umożliwiając tworzenie wykresów za pomocą zaledwie kilku linii kodu.

Tworzenie podstawowego wykresu

Stwórzmy prosty wykres liniowy jako nasz pierwszy wykres:

Setting Up the Plot Surface: Create a PlotSurface2D object. To stanowi tło dla Twojej fabuły. Ustaw kilka właściwości wyświetlania, aby dostosować wygląd, np. kolor tła i tytuł.

Adding Data to the Plot: Use NPlot's LinePlot class to create a line plot. Dodaj wartości danych należące do jednej lub więcej kategorii. Te punkty danych zostaną naniesione na wykres.

Wyświetlanie wykresu: Dodaj wykres liniowy do obszaru wykresu. Renderuj powierzchnię wykresu w formularzu lub kontrolce użytkownika w celu wyświetlenia.

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

Oto obrazek przedstawiający wynik:

Wykorzystanie wykresów słupkowych i punktowych

Wykres słupkowy: Idealny do wyświetlania wartości danych w jednej lub kilku kategoriach. Każdy słupek reprezentuje wartość danych, a jego wysokość wskazuje wielkość tej wartości.

Wykres punktowy: Idealny do wizualizacji zbiorów danych, w których każdy punkt danych jest niezależny. Wyświetla punkty danych na dwuwymiarowym wykresie, umożliwiając analizę wzorców lub trendów.

Wdrażanie wykresu krokowego

Wykres krokowy: Stosowany w przypadku danych zawierających kolejne wartości na osi odciętych, takich jak dane szeregów czasowych. Tworzy to reprezentację przypominającą schody, wyraźnie pokazującą zmiany między kolejnymi punktami danych.

Rozpocznij pracę z IronPDF

Instalacja za pomocą menedżera pakietów NuGet

Aby zintegrować IronPDF z projektem NPlot C# za pomocą menedżera pakietów NuGet, wykonaj następujące kroki:

1. Otwórz Visual Studio i w eksploratorze rozwiązań kliknij prawym przyciskiem myszy na swój projekt.
2. Wybierz "Zarządzaj pakietami NuGet…" z menu kontekstowego.
3. Przejdź do zakładki "Przeglądaj" i wyszukaj IronPDF.
4. Wybierz bibliotekę IronPDF z wyników wyszukiwania i kliknij przycisk instalacji.
5. Zaakceptuj wszelkie monity dotyczące Umowy licencyjnej.

Jeśli chcesz dołączyć IronPDF do swojego projektu za pomocą konsoli menedżera pakietów, wykonaj następujące polecenie w konsoli menedżera pakietów:

Install-Package IronPdf

Pobierze i zainstaluje IronPDF w Twoim projekcie.

Instalacja za pomocą NuGet Strona internetowa

For a detailed overview of IronPDF, including its features, compatibility, and additional download options, visit the IronPDF page on the NuGet website at https://www.nuget.org/packages/IronPdf.

Instalacja za pomocą biblioteki DLL

Alternatywnie można włączyć IronPDF bezpośrednio do projektu, korzystając z pliku DLL. Pobierz plik ZIP zawierający bibliotekę DLL ze strony pobierania IronPDF. Rozpakuj plik i dołącz bibliotekę DLL do swojego projektu.

Generowanie dynamicznych wykresów za pomocą NPlot

NPlot wyróżnia się możliwością tworzenia dynamicznych i atrakcyjnych wizualnie wykresów w aplikacjach napisanych w języku C#. W tej sekcji dowiesz się, jak wygenerować wykres punktowy, który jest typowym przykładem wyświetlania danych z dwiema zmiennymi.

Wykresy punktowe są szczególnie skuteczne w wizualizacji relacji między zmiennymi. Aby utworzyć wykres punktowy, wykonaj następujące kroki:

1. Initiate Plot Surface: Start by creating a PlotSurface2D instance.
2. Przygotuj dane: Zbierz wartości danych, które chcesz przedstawić na wykresie. Wykresy punktowe przedstawiają pojedyncze punkty, więc potrzebne będą dwie tablice wartości: jedna dla współrzędnych x, a druga dla współrzędnych y. You can add as many plots as you want to the PlotSurface2D.
3. Instantiate a Scatter Plot: Use NPlot's PointPlot or ScatterPlot class to create your chart with your plot objects.
4. Dostosuj wykres: zastosuj różne opcje dostosowywania, takie jak ustawienie stylów punktów, kolorów i właściwości osi, aby wykres był czytelny i atrakcyjny.

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

Konwersja wykresów do formatu PDF za pomocą IronPDF

Po utworzeniu wykresu za pomocą NPlot można użyć IronPDF do konwersji tego wykresu na dokument PDF. Proces ten polega na renderowaniu wykresu jako obrazu, a następnie użyciu IronPDF do osadzenia tego obrazu w pliku PDF. Aby przekonwertować wykresy do formatu PDF, wykonaj następujące kroki:

1. Renderowanie wykresu jako obrazu: Najpierw przekonwertuj wykres NPlot do formatu obrazu. This can be done by drawing the PlotSurface2D onto a bitmap.
2. Utwórz plik PDF za pomocą IronPDF: Użyj API IronPDF, aby utworzyć nowy dokument PDF i wstawić obraz wykresu.

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