PASS 文档（中文）

欢迎使用 PASS 粒子加速器模拟平台。

模块介绍

• 输入文件生成（命令行模式）
  • 简介
  • 架构概览
  • 快速开始
    • 最简示例
  • JSON 文件结构
  • 核心组件
    • MainConfig（全局参数）
    • BunchConfig（束团参数）
    • Sequence（序列容器）
  • Lattice来源
    • 方式一：从 MADX twiss 文件读取
    • 方式二：从 MADX twiss 文件读取为元件
    • 方式三：平滑近似 twiss
    • 混合模式
  • 外部数据文件转换
    • 四步流水线
    • 一步到位
    • 预置封装
    • 分步调用
  • API 参考
  • 完整示例
• 注入粒子生成（Injection）
  • 接口参数
  • 束团参数
    • 横向参数
    • 纵向参数
    • 束流参数
    • 分布参数
    • 偏移参数
  • 粒子分布类型简介
  • 横向粒子分布
  • 纵向粒子分布
    • 多束团纵向偏移
    • 束团填充方案
    • 色散耦合
    • 动量偏差
  • 输入文件
  • 运行命令
  • 1D 投影理论曲线
  • 模拟结果
• 元件（Element）
  • 标记（Marker）
    • 物理说明
    • 接口参数
    • 使用示例
    • 应用场景
  • 漂移节（Drift）
    • 物理推导
    • 接口参数
    • 使用示例
    • 应用场景
  • 二极铁（Dipole / SBend）
    • 坐标约定
    • 整体追踪流程
    • 主体：DKD-exact 模型
    • 入口边缘：YRotation
    • 入口边缘：边缘场（Fringe Field）
    • 入口边缘：Wedge（边缘角）
    • 边缘角正负号定义
    • 参数列表
    • 使用示例
    • 参考文献
  • 四极铁（Quadrupole）
    • 坐标约定
    • 四极磁场与归一化强度
    • 整体追踪流程
    • 物理推导
    • 色品效应
    • 接口参数
    • 使用示例
    • 应用场景
    • 参考文献
  • 六极铁（Sextupole）
    • 坐标约定
    • 六极磁场与归一化强度
    • 整体追踪流程
    • 物理推导
    • 色品校正
    • 自然包含的高阶效应
    • 接口参数
    • 使用示例
    • 应用场景
    • 参考文献
  • 八极铁（Octupole）
    • 坐标约定
    • 八极磁场与归一化强度
    • 整体追踪流程
    • 物理推导
    • 振幅依赖 tune 移
    • 自然包含的高阶效应
    • 接口参数
    • 使用示例
    • 应用场景
    • 参考文献
  • 多极铁（Multipole）
    • 坐标约定
    • 多极磁场与归一化强度
    • 整体追踪流程
    • 物理推导
    • Horner 嵌套求值
    • 精确漂移映射
    • 辛积分器
    • 自然包含的效应
    • 与 Xsuite 的差异：hxl 曲率修正
    • 接口参数
    • 使用示例
    • 应用场景
    • 参考文献
  • 螺线管（Solenoid）
    • 坐标约定
    • 螺线管磁场与归一化强度
    • 物理推导
    • 为什么螺线管没有薄透镜模式
    • 多极场叠加与 SKS 积分器
    • 整体追踪流程
    • 色品效应
    • 接口参数
    • 使用示例
    • 应用场景
  • 冲击磁铁（Kicker）
    • 坐标约定
    • 物理推导
    • 整体追踪流程
    • 精确漂移映射
    • 辛积分器
    • 接口参数
    • 使用示例
    • 应用场景
    • 参考文献
  • 静电偏转板（ElSeparator）
    • 坐标约定
    • 物理推导
    • 薄透镜模式
    • 厚透镜模式（DKD）
    • 薄透镜与厚透镜的 kick 一致性
    • Septum 逻辑
    • Tilt 旋转
    • 整体追踪流程
    • 接口参数
    • 使用示例
    • 应用场景
    • 参考文献
  • 激励器（Exciter）
    • 物理推导
    • 粒子到达时间
    • 频率输入模式
    • 激励模式
    • 各模式完整公式
    • Kick 的施加
    • 参数列表
    • 使用示例
  • 高频加速腔（RFCavity）
    • 坐标约定
    • 物理推导
    • 跟踪流程
    • 接口参数
    • Ramping 数据文件
    • 使用示例
    • 应用场景
    • 验证测试
• 监视器（Monitor）
  • 统计监视器（StatMonitor）
    • 简介
    • 工作原理
    • 接口参数
    • 输出文件
    • 使用示例
    • 应用场景
  • 粒子监视器（ParticleMonitor）
    • 简介
    • 粒子选择机制
    • 记录圈数范围
    • 预分配策略
    • 接口参数
    • 输出文件
    • 使用示例
    • 应用场景
• 束团重整（ReorganizeBunch）
  • 接口参数
  • 物理说明
    • 索引分配方式
  • 使用示例
  • 应用场景
• 孔径（Aperture）
  • 接口参数
  • 丢失粒子处理
  • 各孔径类型详解
    • off（关闭）
    • default（默认矩形）
    • circle（圆形）
    • rectangle（矩形）
    • ellipse（椭圆）
    • rectcircle（矩形内切圆）
    • rectellipse（矩形内切椭圆）
    • racetrack（跑道形）
    • octagon（八角形）
    • polygon（多边形）
  • 参数总览表
  • 使用示例
• Twiss 传输（Twiss）
  • 简介
  • 物理推导
    • 纵向传输
    • 色散处理
    • 横向传输矩阵
    • 色品修正
    • z 坐标回旋折叠
    • t0 更新
  • 接口参数
    • 位置参数
    • 横向参数
    • 纵向参数
    • 色散与色品
    • 孔径参数
  • 使用示例
  • 应用场景