磁强计时间序列模拟器：为神经网络训练生成高保真合成磁数据

一个专为神经网络磁源定位训练设计的高保真模拟器，支持多种磁源类型和噪声模型，可生成静态样本和时间序列数据。

• 原作者/维护者：Stridasaurus
• 来源平台：github
• 原始标题：magnetometer-time-series-simulator
• 原始链接：https://github.com/Stridasaurus/magnetometer-time-series-simulator
• 来源发布时间/更新时间：2026-06-14T14:44:11Z

原作者与来源

• 原作者/维护者：Stridasaurus
• 来源平台：github
• 原始标题：magnetometer-time-series-simulator
• 原始链接：https://github.com/Stridasaurus/magnetometer-time-series-simulator
• 来源发布时间/更新时间：2026-06-14T14:44:11Z 原作者与来源\n\n- 原作者/维护者: Strider Settgast (Stridasaurus)\n- 来源平台: GitHub\n- 原始标题: magnetometer-time-series-simulator\n- 原始链接: https://github.com/Stridasaurus/magnetometer-time-series-simulator\n- 发布时间: 2026年6月\n\n---\n\n项目概述\n\n在机器学习和深度学习领域，高质量的训练数据往往决定了模型的最终性能。然而，在磁源定位这类物理驱动的应用场景中，获取真实世界的标注数据既昂贵又困难。Strider Settgast 开发的这个磁强计时间序列模拟器正是为了解决这一痛点而生——它提供了一个高保真的合成数据生成引擎，专为训练神经网络进行磁源定位而设计。\n\n该模拟器基于经典的磁偶极子物理模型，能够精确计算多个传感器位置处的磁场分布。通过配置不同的磁源参数、传感器阵列布局和噪声模型，研究人员可以快速生成大量多样化的训练数据，而无需部署昂贵的物理实验设备。\n\n---\n\n支持的磁源类型\n\n模拟器目前支持多种磁源类型，每种类型对应不同的物理模型和应用场景：\n\n磁偶极子 (Dipole)\n这是最基础的磁源模型，模拟地球磁场中常见的偶极子辐射模式。在物理上，偶极子是磁性材料最基本的单元，其磁场分布遵循著名的偶极子方程。该模型适用于模拟大多数自然和人工磁源。\n\n磁单极子 (Monopole)\n虽然在真实物理世界中磁单极子尚未被实验证实，但在模拟环境中引入单极子模型具有重要的测试价值。它提供了一个简单的基准场景，帮助验证神经网络是否能够学习最基本的磁场衰减规律（与距离平方成反比）。\n\n四极子 (Quadrupole)\n四极子模型目前标记为"计划扩展"，它将模拟更复杂的磁场分布模式，适用于需要更高精度磁源建模的高级应用场景。\n\n---\n\n噪声模型与数据真实性\n\n真实世界的传感器数据从来不是完美的。为了训练出鲁棒的神经网络，模拟器提供了三种噪声模型：\n\n高斯噪声 (Gaussian)\n这是最常用的噪声模型，模拟传感器电子热噪声等随机误差。噪声服从正态分布，可通过标准差参数精细控制噪声强度。\n\n均匀噪声 (Uniform)\n均匀分布噪声与高斯噪声具有相同的方差，但分布形状不同。这种模型有助于测试神经网络对非高斯噪声的适应能力。\n\n混合噪声 (Mixed)\n这是最接近真实场景的模型，结合了高斯背景噪声和极端异常值（outliers）。异常值的比例可配置，模拟传感器故障、环境干扰等突发情况，对于训练鲁棒的磁源定位模型至关重要。\n\n---\n\n核心功能与使用方式\n\n传感器配置\n用户可以通过 sensor_positions 参数定义任意三维传感器阵列。每个传感器记录磁场在 X、Y、Z 三个方向的分量，因此对于 N 个传感器，每次测量产生 3N 个特征值。\n\n静态样本生成\ngenerate_static_dataset 方法可批量生成独立的静态磁源样本。每个样本包含随机的磁源位置和磁矩方向，适用于训练基础的定位模型。\n\n动态时间序列生成\ngenerate_time_series 方法是该模拟器的亮点功能。它支持定义自定义轨迹函数 trajectory_func 和磁矩变化函数 moment_func，模拟移动磁源在传感器阵列周围的运动。时间步长 dt 可配置，默认 0.01 秒。如果不提供轨迹函数，模拟器会自动生成受边界约束的随机游走轨迹。\n\n数据归一化与保存\n模拟器内置了输出归一化选项，可将目标位置映射到 [-1, 1] 范围，这对神经网络的训练稳定性很有帮助。生成的数据集可通过 save_dataset 方法保存为压缩的 NPZ 格式，包含特征矩阵、目标标签、传感器位置和完整配置信息。\n\n---\n\n物理原理与数学基础\n\n模拟器的核心计算基于静磁学的偶极子公式。对于位于 source_pos 的磁偶极子，其在 sensor_pos 处产生的磁场 B 由以下公式决定：\n\n\nB = (μ₀/4π) * [3(m·r̂)r̂ - m] / r³\n\n\n其中：\n- μ₀/4π 是磁常数（默认可配置为 1e-7 SI单位）\n- m 是磁矩向量\n- r 是源到传感器的距离向量\n- r̂ 是单位方向向量\n\n该实现严格遵循物理定律，确保合成数据与真实磁场具有相同的统计特性，这是训练有效神经网络的关键前提。\n\n---\n\n应用场景与价值\n\n这个模拟器在多个领域具有实用价值：\n\n地质勘探: 模拟地下矿藏产生的磁场异常，训练神经网络识别特定地质结构。\n\n安防检测: 生成各种隐藏金属物体的磁场特征，用于训练安检设备的智能识别系统。\n\n生物医学: 模拟人体器官（如心脏、大脑）产生的微弱磁场，为医学磁成像算法提供训练数据。\n\n机器人导航: 为室内定位系统生成磁场地图，帮助机器人学习利用环境磁场进行定位。\n\n---\n\n技术亮点与可配置性\n\n该项目的配置系统 SimulatorConfig 采用 Python 的 dataclass 实现，提供了丰富的可调参数：\n\n- 磁源边界: 通过 default_source_bounds 限制随机磁源的生成范围\n- 磁矩范围: default_moment_range 控制磁矩大小的随机范围\n- 随机种子: random_seed 确保实验可重复\n- SNR 计算: 内置信噪比计算功能，帮助评估数据质量\n- 统计元数据: compute_statistics 方法提供生成数据的完整统计信息\n- 3D 可视化: plot_sensors_3d 方法支持传感器阵列的三维可视化\n\n这种高度模块化的设计使得研究人员可以快速迭代实验，测试不同的传感器配置、噪声水平和网络架构。\n\n---\n\n总结\n\nStridasaurus 的磁强计时间序列模拟器是一个精心设计的科研工具，它将物理仿真与机器学习数据生成完美结合。通过提供高保真的合成数据，它大大降低了磁源定位研究的门槛，使更多研究者能够在这个领域进行探索。\n\n对于正在开发磁源定位神经网络的工程师和研究人员来说，这个工具不仅节省了大量的数据采集成本，更重要的是提供了一个可控的、可重复的实验环境——这在真实世界数据收集中往往是难以实现的。