.NET ヘルプ

NPlot C#（開発者向けの使用方法）

公開済み 2024年1月28日

共有:

このチュートリアルは、2つの強力なライブラリの統合に興味がある初心者向けに設計されています。NPlotおよびIronPDF。一緒に、これらはC#アプリケーションでチャートを作成およびエクスポートするための強力なツールキットを形成します。

NPlotは、.NETフレームワーク内で多用途に使用できるチャートライブラリであり、幅広い種類のグラフやプロットの生成に最適です。シンプルな折れ線グラフから複雑な散布図まで、NPlotはサンプルベースのデータを表示し、動的なチャートを生成する点で優れており、小規模なデータセットでも大規模なデータセットでも使用できます。

IronPDFは、これらのチャートをPDFドキュメントに変換することで、NPlotを補完します。 HTMLメールのコンテンツや特定のプロットクラスを扱う場合でも、IronPDFはそれらを高品質なPDFにレンダリングできます。

この機能は、レポート生成や解析済みデータの文書化を必要とするアプリケーションに特に有用です。

NPlotでの始め方

.NET FrameworkにおけるNPlotの紹介

NPlotは、幅広いデータ可視化のニーズに応えるために設計された、.NET Framework向けの動的チャーティングライブラリです。デスクトップアプリケーションやWebベースのソリューションに取り組む際、NPlotはデータをグラフィカルに、明確に、そして効果的に表現する機能を提供します。

C#プロジェクトにNPlotをインストールする

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

NuGetパッケージマネージャーを使用する：

Visual Studioで、「ツール」 > 「NuGet パッケージマネージャー」 > 「ソリューションの NuGet パッケージの管理...」に移動します。
「NPlot」を検索し、プロジェクトにインストールしてください。

NPlotの最初のステップ

NPlotがインストールされると、チャートの作成を開始できます。 NPlotの使いやすさは初心者にとって理想的で、数行のコードでプロットを作成することができます。

基本的なチャートの作成

最初のグラフとしてシンプルな線グラフを作成しましょう:

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

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

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

using System;
using NPlot;

// Create a new bitmap plot surface
var plotSurface = new NPlot.Bitmap.PlotSurface2D(800, 600);

// Create a line plot
var linePlot = new LinePlot();
linePlot.AbscissaData = new double [] { 1, 2, 3, 4, 5 };
linePlot.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;

// Create a new bitmap plot surface
var plotSurface = new NPlot.Bitmap.PlotSurface2D(800, 600);

// Create a line plot
var linePlot = new LinePlot();
linePlot.AbscissaData = new double [] { 1, 2, 3, 4, 5 };
linePlot.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

' Create a new bitmap plot surface
Private plotSurface = New NPlot.Bitmap.PlotSurface2D(800, 600)

' Create a line plot
Private linePlot = New LinePlot()
linePlot.AbscissaData = New Double () { 1, 2, 3, 4, 5 }
linePlot.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")

VB C#

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

NPlot C#（エヌプロット C#）(開発者向けの使い方): 図2

NPlot を使用した高度なチャーティング技術

基本的なプロットを習得した後、NPlotはデータ可視化の能力を強化するために、より複雑なチャートタイプの幅広い選択肢を提供します。これらには、棒グラフ、散布図、ステッププロットが含まれ、それぞれ異なる種類のデータ表現に適しています。

バープロットと散布図の活用

棒グラフ (Bar Plot): 一つまたは複数のカテゴリーにおけるデータ値を表示するのに最適。各バーはデータ値を表しており、高さはその値の大きさを示しています。

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

段階プロットの実装

ステッププロット: 連続する横軸の値、例えば時系列データを扱う際に使用されます。それは階段のような表現を作成し、順次データポイント間の変化を明確に示します。

IronPDFとNPlotの統合

IronPDFとの統合により、NPlotのチャートをシームレスにPDFドキュメントに変換することができます。 IronPDFは、HTMLコンテンツおよびプロットクラスを高品質なPDFファイルにレンダリングすることを可能にする強力なライブラリです。この統合は、レポートを生成したり、分析されたデータを記録する必要があるアプリケーションに特に役立ちます。

IronPDFを始めましょう

今日から無料トライアルでIronPDFをあなたのプロジェクトで使い始めましょう。

最初のステップ:

IronPDFライブラリのインストール

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

NuGetパッケージマネージャを使ってIronPDFをNPlot C#プロジェクトに統合するには、以下の手順に従ってください：

Visual Studioを開き、ソリューション・エクスプローラーでプロジェクトを右クリックします。
コンテキストメニューから「NuGetパッケージの管理...」を選択してください。
「参照」タブに移動して、「IronPDF」を検索してください。
検索結果からIronPDFライブラリを選択し、インストールボタンをクリックしてください。
ライセンス契約のプロンプトをすべて受け入れます。

プロジェクトにIronPDFをパッケージマネージャーコンソール経由で含めたい場合は、パッケージマネージャーコンソールで以下のコマンドを実行してください:

Install-Package IronPdf

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

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

IronPDFの機能、互換性、その他のダウンロードオプションに関する詳細な概要については、NuGetウェブサイトのIronPDFページ https://www.nuget.org/packages/IronPdf をご覧ください。

DLLを使ってインストール

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

NPlotを使用した動的チャートの生成

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

散布図は、変数間の関係を視覚化するのに特に効果的です。以下の手順に従って散布図を作成してください：

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

var plotSurface = new NPlot.Windows.PlotSurface2D();
var scatterPlot = new PointPlot();
scatterPlot.AbscissaData = new double [] { /* x-coordinates */ };
scatterPlot.OrdinateData = new double [] { /* y-coordinates */ };
plotSurface.Add(scatterPlot);
// Additional code to render the plotSurface

var plotSurface = new NPlot.Windows.PlotSurface2D();
var scatterPlot = new PointPlot();
scatterPlot.AbscissaData = new double [] { /* x-coordinates */ };
scatterPlot.OrdinateData = new double [] { /* y-coordinates */ };
plotSurface.Add(scatterPlot);
// Additional code to render the plotSurface

Dim plotSurface = New NPlot.Windows.PlotSurface2D()
Dim scatterPlot = New PointPlot()
scatterPlot.AbscissaData = New Double () {}
scatterPlot.OrdinateData = New Double () {}
plotSurface.Add(scatterPlot)
' Additional code to render the plotSurface

VB C#

IronPDFを使用してチャートをPDFに変換する方法

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

チャートを画像としてレンダリングする: まず、NPlotチャートを画像形式に変換します。これは、PlotSurface2Dをビットマップ上に描画することによって実行できます。
IronPDFでPDFを作成: IronPDFのAPIを使用して新しいPDFドキュメントを作成し、チャート画像を挿入します。

// Assuming 'chartImage' is the Bitmap of your NPlot chart
var imageFiles = new string [] { chartImagePath };
ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("Chart.pdf");

// Assuming 'chartImage' is the Bitmap of your NPlot chart
var imageFiles = new string [] { chartImagePath };
ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("Chart.pdf");

' Assuming 'chartImage' is the Bitmap of your NPlot chart
Dim imageFiles = New String () { chartImagePath }
ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("Chart.pdf")

VB C#