C# ScottPlot Add.Scatter() 配置和参数

在 ScottPlot 库中，Add.Scatter() 方法用于在图表中添加散点图。它提供了多种配置参数，允许你自定义散点图的外观和行为。以下是 Add.Scatter() 的主要配置参数及其说明：
________________________________________
1. 基本参数
参数名    类型    说明
xs    double[]    数据点的 X 坐标数组。
ys    double[]    数据点的 Y 坐标数组。
label    string    图例中显示的标签（可选）。
color    System.Drawing.Color    散点图的颜色（包括线条和标记）。
lineWidth    double    线条的宽度（以像素为单位）。
markerSize    double    标记的大小（以像素为单位）。
________________________________________
2. 线条样式
参数名    类型    说明
lineStyle    ScottPlot.LineStyle    线条样式，例如实线、虚线、点线等。
smooth    bool    是否启用平滑曲线（默认 false）。
onNaN    ScottPlot.Plottable.Scatter.NanBehavior    处理 NaN 值的行为（例如跳过或断开连接）。
________________________________________
3. 标记样式
参数名    类型    说明
markerShape    ScottPlot.MarkerShape    标记的形状，例如圆形、方形、十字形等。
markerFill    bool    是否填充标记（默认 true）。
markerLineWidth    double    标记边框的宽度（以像素为单位）。
________________________________________
4. 其他配置
参数名    类型    说明
stepDisplay    bool    是否启用阶梯图模式（默认 false）。
errorX    double[]    X 方向的误差线数据（可选）。
errorY    double[]    Y 方向的误差线数据（可选）。
________________________________________
示例代码
以下是一个完整的示例，展示如何使用 Add.Scatter() 的配置参数：
csharp
复制
using System;
using System.Drawing;
using ScottPlot;
using ScottPlot.Plottable;

namespace ScottPlotExample
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();

            // 创建示例数据
            double[] xs = { 1, 2, 3, 4, 5 };
            double[] ys = { 1, 4, 9, 16, 25 };

            // 添加散点图
            var scatterPlot = formsPlot1.Plot.Add.Scatter(xs, ys);

            // 配置散点图
            scatterPlot.Label = "示例数据"; // 设置图例标签
            scatterPlot.Color = Color.Red; // 设置颜色
            scatterPlot.LineWidth = 2; // 设置线条宽度
            scatterPlot.MarkerSize = 10; // 设置标记大小
            scatterPlot.MarkerShape = MarkerShape.Circle; // 设置标记形状
            scatterPlot.LineStyle = LineStyle.Dash; // 设置线条样式为虚线
            scatterPlot.Smooth = true; // 启用平滑曲线
            scatterPlot.MarkerFill = true; // 填充标记
            scatterPlot.MarkerLineWidth = 1; // 设置标记边框宽度

            // 添加图例
            formsPlot1.Plot.Legend();

            // 刷新图表
            formsPlot1.Refresh();
        }
    }
}
________________________________________
常用枚举值
LineStyle
•    Solid：实线
•    Dash：虚线
•    Dot：点线
•    DashDot：点划线
•    None：无线条
MarkerShape
•    Circle：圆形
•    Square：方形
•    Cross：十字形
•    Triangle：三角形
•    FilledCircle：填充圆形
•    FilledSquare：填充方形
NanBehavior
•    Gap：在 NaN 处断开连接
•    ThrowException：遇到 NaN 时抛出异常
________________________________________
总结
Add.Scatter() 提供了丰富的配置参数，允许你灵活地自定义散点图的外观和行为。通过调整线条样式、标记形状、颜色等参数，可以创建出符合需求的图表。