NPlot C# (開発者向けの仕組み)

.NET フレームワークにおける NPlot の紹介

NPlot は、.NET フレームワーク用に設計された動的なチャートライブラリで、幅広いデータ視覚化のニーズに対応します。 デスクトップアプリケーションでも Web ベースのソリューションでも、NPlot はデータをグラフィカルに分かりやすく効果的に表現する機能を提供します。

C# プロジェクトへの NPlot のインストール

C# プロジェクトで NPlot を使用するには、インストールが必要です。 アプリケーションに NPlot を簡単に追加する方法は次の通りです。

NuGet パッケージマネージャーを使用:

1. Visual Studio で"ツール"＞"NuGet パッケージマネージャー"＞"ソリューションの NuGet パッケージの管理"を開きます。
2. "NPlot"を検索し、プロジェクトにインストールします。

NPlotでの初期ステップ

NPlot をインストールしたら、チャートを作成し始めることができます。 NPlot の使用のしやすさは、初心者にとって理想的で、数行のコードでプロットを作成できるようになります。

基本チャートの作成

最初のチャートとして、単純な線グラフを作成しましょう。

プロットサーフェスの設定: PlotSurface2D オブジェクトを作成します。 これはプロットのキャンバスとして機能します。 背景色やタイトルなどの表示プロパティを設定して、外観をカスタマイズします。

データのプロットへの追加: NPlot の LinePlot クラスを使用して、ラインプロットを作成します。 1つまたは複数のカテゴリに属するデータ値を追加します。 これらのデータポイントがグラフにプロットされます。

チャートの表示: ラインプロットをプロットサーフェスに追加します。 プロットサーフェスをフォームやユーザーコントロールでレンダリングして表示します。

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

こちらが出力プロット画像です。

バーグラフと散布図の利用

バーグラフ: 1つまたは複数のカテゴリ内のデータ値を表示するのに理想的です。 各バーはデータ値を表し、その高さは値の大きさを示します。

散布図: 各データポイントが独立しているデータセットの視覚化に最適です。 2次元グラフ上にデータポイントをプロットし、パターンやトレンドの分析を可能にします。

ステッププロットの実装

ステッププロット: 時系列データのように連続した横軸の値を含むデータに使用します。 階段状の表現を作成し、連続したデータポイント間の変化を明確に示します。

IronPDFの使用開始

NuGet パッケージマネージャーを使用してインストール

NuGet パッケージマネージャーを使用して IronPDF を NPlot C# プロジェクトに統合するには、次の手順に従います。

1. Visual Studio を開き、ソリューションエクスプローラーでプロジェクトを右クリックします。
2. コンテキストメニューから"NuGetパッケージの管理…"を選択します。
3. "参照"タブに移動し、IronPDF を検索します。
4. 検索結果から IronPDF ライブラリを選んで"インストール"ボタンをクリックします。
5. ライセンス契約のプロンプトを承諾します。

パッケージマネージャーコンソール経由で IronPDF をプロジェクトに含める場合は、次のコマンドをパッケージマネージャーコンソールで実行します。

Install-Package IronPdf

プロジェクトに IronPDF を取得してインストールします。

NuGet ウェブサイトを使ってインストール

機能、互換性、追加のダウンロードオプションを含む IronPDF の詳細な概要については、NuGet ウェブサイトの IronPDF ページを訪れてください。https://www.nuget.org/packages/IronPdf。

DLLを介してインストール

または、DLLファイルを使用してIronPDFをプロジェクトに直接組み込むこともできます。 IronPDF ダウンロードページからDLLを含むZIPファイルをダウンロードしてください。 それを解凍し、プロジェクトにDLLを含めます。

NPlotで動的なチャートを生成

NPlot は、C# アプリケーション内で動的で視覚的に魅力的なチャートを作成することに優れています。 このセクションでは、2変数のデータを表示するための典型的なユースケースである散布図の生成について案内します。

散布図は、変数間の関係を視覚化するのに特に効果的です。 散布図を作成するには、次のステップに従ってください。

1. プロットサーフェスの開始: PlotSurface2D インスタンスの作成を開始します。
2. データを準備: プロットしたいデータ値を収集します。 散布図では個々のポイントをプロットするため、x座標用の値の配列とy座標用の配列が必要です。 PlotSurface2D に好きなだけプロットを追加できます。
3. 散布図の作成: NPlot の PointPlot または ScatterPlot クラスを使用して、プロットオブジェクトと共にチャートを作成します。
4. チャートのカスタマイズ: ポイントスタイル、色、軸プロパティを設定するなどして、チャートを情報豊かで魅力的にするためにさまざまなカスタマイズを適用します。

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

IronPDF を使用したチャートのPDF変換

NPlot でチャートを作成したら、IronPDF を使用してこのチャートを PDF ドキュメントに変換できます。 このプロセスには、チャートを画像としてレンダリングし、IronPDF を使用してこの画像を PDF に埋め込むことが含まれます。 チャートをPDFに変換するには、次の手順に従ってください。

1. 画像としてチャートをレンダリング: まず、NPlot のチャートを画像形式に変換します。 これは、PlotSurface2D をビットマップに描画することで行うことができます。
2. IronPDFでPDFを作成: IronPDF の API を使用して新しい 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");
    }
}

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