.NET 帮助

NPlot C#（开发者工作原理）

发布 2024年一月28日

本教程专为热衷于探索如何整合两个强大库的初学者而设计：NPlot和 IronPDF。它们共同构成了一个强大的工具包，用于在 C# 应用程序中创建和导出图表。

NPlot 是 .NET Framework 中的一个多功能图表库，是生成各种图形和绘图的理想工具。从简单的折线图到复杂的散点图，无论是处理小型数据集还是超大型数据集，NPlot 都能出色地显示基于样本的数据并生成动态图表。

IronPDF 可将这些图表转换为 PDF 文档，是对 NPlot 的补充。无论您处理的是 HTML 电子邮件内容还是特定的情节类，IronPDF 都能将它们呈现为高质量的 PDF。

这一功能对于需要生成报告或记录分析数据的应用程序尤其有用。

NPlot 入门

.NET Framework 中的 NPlot 简介

NPlot 是专为 .NET Framework 设计的动态图表库，可满足广泛的数据可视化需求。无论您是在开发桌面应用程序还是基于网络的解决方案，NPlot 都能提供以图形方式清晰、有效地表示数据的功能。

在您的 C# 项目中安装 NPlot

要开始在 C# 项目中使用 NPlot，您需要安装它。以下是如何轻松将 NPlot 添加到您的应用程序中：

使用 NuGet 软件包管理器：

在 Visual Studio 中，转到 "工具">"NuGet 包管理器">"管理解决方案的 NuGet 包..."。
搜索 "NPlot "并将其安装到您的项目中。

使用 NPlot 的第一步

安装 NPlot 后，您就可以开始创建图表了。 NPlot 易于使用，非常适合初学者，只需几行代码即可创建绘图。

创建基本图表

让我们创建一个简单的折线图作为第一个图表：

设置绘图表面：创建一个 PlotSurface2D 对象。这将成为您创作的画布。设置一些显示属性以自定义其外观，如背景颜色和标题。

向绘图添加数据：使用 NPlot 的 LinePlot 类创建折线图。添加属于一个或多个类别的数据值。这些数据点将绘制在图表上。

显示图表：将折线图添加到绘图表面。在表单或用户控件中渲染绘图表面，以便显示。

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#（如何为开发人员工作）：图 2

使用 NPlot 的高级制图技术

在掌握基本图表之后，NPlot 还提供了一系列更复杂的图表类型，以增强您的数据可视化能力。这些工具包括条形图、散点图和阶梯图，分别适用于不同类型的数据表示。

利用条形图和散点图

Bar Plot：非常适合显示一个或多个类别中的数据值。每个条形代表一个数据值，其高度表示该值的大小。

散点图：非常适合可视化数据集，其中每个数据点都是独立的。它将数据点绘制在二维图形上，以便分析模式或趋势。

实现阶梯图

阶梯图：用于涉及连续缺省值的数据，如时间序列数据。它创建了一个类似楼梯的表示方法，清晰地显示了连续数据点之间的变化。

将 NPlot 与 IronPDF 相集成

NPlot 与 IronPDF 的集成可以将图表无缝转换为 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 安装

另外，您也可以使用 IronPdf 的 dll 文件将其直接集成到您的项目中。从以下网站下载包含 DLL 的 ZIP 文件IronPDF 下载页面. 解压缩，并将 DLL 包含到您的项目中。

使用 NPlot 生成动态图表

NPlot 擅长在 C# 应用程序中创建动态和具有视觉吸引力的图表。本节将指导您生成一个散点图，这是显示包含两个变量的数据的典型用例。

散点图在可视化变量之间的关系方面尤为有效。按照以下步骤创建散点图：

启动绘图表面：首先创建一个 PlotSurface2D 实例。
准备数据：收集您希望绘制的数据值。散点图绘制的是单个点，因此需要两个数值数组：一个用于 x 坐标，另一个用于 y 坐标。您可以在 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 来实现。
Create PDF with IronPDF：使用 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#