pyFAI项目中的坐标系与图像处理规范解析

前言

在X射线衍射数据分析领域，pyFAI作为一个强大的衍射数据处理工具，其内部采用了一套严谨的坐标系和图像处理规范。理解这些规范对于正确使用pyFAI进行数据分析至关重要。本文将深入解析pyFAI中的关键规范，包括掩膜处理、像素坐标系定义、探测器方向等核心概念。

掩膜(Mask)规范

pyFAI在处理掩膜时采用了一套独特的约定：

• 零值有效原则：在pyFAI中，值为0的像素被视为有效像素（可理解为"未被屏蔽"）
• 非零屏蔽原则：任何非零值的像素都会被当作无效像素处理（即"被屏蔽"）

这与某些其他X射线分析软件（如Lima）的处理方式正好相反，后者通常将非零像素视为有效。这种差异在使用多软件协同工作时需要特别注意。

像素坐标系定义

pyFAI采用了一套精确的像素坐标定义系统：

坐标系基础

• 原点位置：位于像素矩阵的角落（具体为左下角）
• 像素编号：每个像素n的坐标范围从n（包含）到n+1（不包含）
• 中心位置：任何像素的中心位于半整数坐标位置

与其他系统的对比

• 与matplotlib的差异：pyFAI的坐标系与matplotlib有半个像素的偏移。在matplotlib中，像素通常从n-½延伸到n+½
• 显示注意事项：在使用matplotlib显示图像时（如确定光束中心位置），需要特别注意这半个像素的偏移

观察视角规范

pyFAI采用了两项特殊约定：

1. 观察方向：从样品看向探测器（与"相机视角"相反，后者是从相机后方观察）
2. 原点位置：位于图像底部（与"相机视角"的顶部原点相反）

有趣的是，这两种相反的约定在χ角符号上相互抵消，最终保持了符号的一致性。

探测器方向规范

自2023.12版本起，pyFAI开始支持探测器方向的定义。这一功能基于摄影领域的EXIF标签标准，使用1-8的整数值表示不同方向。

方向定义基础

摄影标准中定义了8种基本方向（1-8），其中：

• 默认方向（1）：原点位于左上角
• 其他方向：通过不同旋转和镜像组合实现

pyFAI的特殊处理

pyFAI对此标准做了两项调整：

1. 观察视角：从样品看向探测器（相当于图像的左右翻转）
2. 原点位置：位于图像底部（相当于图像的上下翻转）

这两项调整的综合效果使得pyFAI的默认方向对应于摄影标准中的"BottomRight (3)"方向。

重要特性

• 不可变性：探测器的方向属性被设计为不可变，以防止误操作
• 当前限制：目前仅支持方向1-4，旋转方向可通过校准过程中的rot3参数处理

与其他软件的兼容性

与Dioptas的转换

虽然Dioptas使用pyFAI库进行几何计算，但它允许实际翻转/旋转图像而不仅仅是屏幕显示。这带来了额外的复杂性：

• 图像加载处理：Dioptas加载图像时会进行上下翻转（原点：TopRight，方向2）
• 校准转换：要在pyFAI中处理Dioptas校准的数据集，需在PONI文件中修改detector_config项：

Detector_config: {"orientation": 2}

• 方位角方向：由于图像翻转，方位角(chi)的方向会不同，这在纹理分析时需要特别注意

厂商规范差异

不同探测器制造商遵循不同的规范：

• Dectris：方向2（TopRight）
• 其他厂商：待补充

目前所有探测器在pyFAI中默认初始化为方向3，这与pyFAI自2010年以来的传统保持一致。

总结

理解pyFAI的这些规范对于准确处理X射线衍射数据至关重要。特别是在多软件协同工作或处理不同来源的数据时，这些细节往往决定了分析结果的准确性。建议用户在开始重要分析前，先通过简单测试验证这些规范设置是否符合预期。