# 全库检测、前十矿物排序与并行计算说明

版本：local-v3.0-top10。日期：2026-11-16。所有网站文件与计算结果在本地。

## 1. 百分比口径

**矿物候选像素占比 = 该矿物通过筛查的候选像素数 ÷ 当前选择范围的整图总像素数 × 100%。**

两箱合计的分母是 1,089,792；第 4 箱是 544,512；第 5 箱是 545,280。分母包括托盘、背景、未确定和未进入前十的矿物候选。单选矿物只改变着色，不改变分母或排名。

每个像素只计入最高匹配且通过阈值的一个参考名称，不重复计数。其他候选、未确定、背景均单独保留；这些部分与前十的未舍入比例合计为 100%。本指标为图像分类面积占比，不是质量百分比、品位、体积含量或混合像元解混丰度。

默认单像素分析。4×4 对照模式按单元实际覆盖的原始像素数加权计数，第 4 箱最底部单元只计 2 行像素，仍以原图总像素数为分母。

## 2. 所有类型先检测，再取前十

子库全部 115 条参考谱、32 个参考名称都参与评分；不再预先剔除低特异性对照，也不先选十种再检测。先计算全部参考分数，然后按参考名称互斥归类，再统计排序，最后取当前范围最多十种有候选像素的名称着色。

部分名称本身是矿物组／系列名称，例如 Chlorite、Hornblende，不能把 32 个参考名称直接说成已精确区分 32 个矿物种。同一矿物的多个样品谱不会重复增加像素计数。

弱特征参考也进入评分矩阵。如果最高分参考的匹配窗口吸收深度低于 0.015，保留“参考特征不足”而不赋阳性标签，也不转而采用第二候选强行命名。因此“全库参与”不等于所有类型都能在本仪器波段里可靠识别。

当前从矿物组升级为具体参考名称，竞争分差和 12／18／24 nm 带宽一致性也按名称比较。这比仅比较组间差异更细，结果不应与旧版矿物组计数直接相加或沿用。

## 3. 当前单像素前十结果

本次共有 13 个参考名称保留了候选像素，合计 37,871 像素，占整图 3.475067%。前十合计 37,855 像素，占整图 3.473599%。

| 排名 | 矿物候选参考名称 | 候选像素数 | 占整图总像素 |
| --- | --- | --- | --- |
| 1 | 角闪石 · Hornblende | 12,439 | 1.141410% |
| 2 | 三水铝石 · Gibbsite | 11,729 | 1.076260% |
| 3 | 阳起石 · Actinolite | 9,473 | 0.869248% |
| 4 | 白云石 · Dolomite | 2,942 | 0.269960% |
| 5 | 绿泥石 · Chlorite | 523 | 0.047991% |
| 6 | 伊利石 · Illite | 394 | 0.036154% |
| 7 | 蒙脱石 · Montmorillonite | 236 | 0.021656% |
| 8 | 金云母 · Phlogopite | 67 | 0.006148% |
| 9 | 纤蛇纹石 · Chrysotile | 28 | 0.002569% |
| 10 | 白云母 · Muscovite | 24 | 0.002202% |

另有 16 个其他候选像素；未确定 451,057 个，包络外／背景 600,864 个。百分比显示可能舍入为 0.00%，低占比项使用更多小数；CSV 保留 8 位百分比小数。零候选保留在全库表中，不为凑足十种伪造阳性。

默认使用“全库光谱候选”。高级设置可叠加原参考样品家族留出检查的类别库筛选，所有参考仍参与评分，仅最终保留门槛不同。库内筛选证据尚不能当作客户岩心识别准确率。

## 4. 并行计算程序

程序为 `scripts/compute_minerals.py`。针对这两份 ENVI/BIL 数据包读取原始 RAW、暗／白参考及 BPR 图，使用内存映射分块读取。每个像素只提取一次匹配特征，再用 NumPy 矩阵运算同时与全部 115 条谱比较，避免为每种矿物重复读取整图。

空间分块由进程池并行处理。默认 4 个工作进程，每个进程限制 BLAS／OpenMP 为 1 个线程，避免进程池和数值库同时扩张线程数。主进程按固定位置写入标签和分数，任务返回顺序不会改变空间坐标。

| 尺度 | 工作进程 | 分块数 | 本机本次实测耗时 | 串并行一致性抽检 |
| --- | --- | --- | --- | --- |
| 单像素 | 4 | 46 | 10.617 秒 | 2 块标签、分数完全一致 |
| 4×4 | 4 | 12 | 2.319 秒 | 2 块标签、分数完全一致 |

这是当前机器及这两份数据上的一次运行记录，含参考与校准加载、计算和结果写入，且包含额外串行抽检；不是服务器性能承诺，也未据此宣称几倍加速。

在项目或解压部署包根目录运行（分析依赖单独安装，静态网站浏览无需这些依赖）：

```sh
python3 -m pip install -r scripts/requirements-compute.txt
python3 scripts/compute_minerals.py --source /实际路径/调整后目标 --cell 1 --workers 4
python3 scripts/compute_minerals.py --source /实际路径/调整后目标 --cell 4 --workers 4
```

本导入器明确针对所提供 B4／B5 的 ENVI/BIL、273 波段布局；并非已实现任意仪器通用导入。重新计算应在本地工作副本进行，生成完整结果并验证后，再部署同一版本。

## 5. 页面布局与导出

左侧排名面板展示前十名称、候选像素数、百分比及排行条；点击某项进入该矿物单图，点击“前十综合图”合并显示。中间主图区展示两箱或单箱地图，原始／叠加／分类图可切换。桌面端将点位光谱和判别证据固定在地图右侧，选点原位更新，不滚动页面；窄屏使用可收起的侧边抽屉。地图和证据内部各自滚动，参考样本与筛查详情折叠收纳；“专注阅图”可展开整个工作区。

前十以外的候选在综合图中不着色，但在完整统计和点位判别中保留。当前图像 PNG 导出带名称、颜色、占比范围和分母；排名 CSV 包含全部 32 个名称、是否入前十、像素数和分母。切换箱号后重新按对应范围排序；单选不重算排名。

## 6. 解释边界

光谱沿用暗／白归一化、BPR 屏蔽、2050–2450 nm 的 73 波段吸收形状比较，阈值为相似度 ≥0.92、名称间分差 ≥0.025、残差 ≤0.40、像素吸收深度 ≥0.03、主吸收位置差 ≤12 nm、亮度 0.06–0.85、缺失匹配通道 ≤10%，并要求三种假设带宽下最近参考名称一致。

人工岩心包络保持原设置，包络外只标背景，不进行矿物诊断。包络内可能仍有裂隙、阴影和少量托盘。带宽未实测、反射率未完成绝对校准、参考样品说明待进一步复核；目前没有 XRD／岩相真值。尤其对三水铝石等扩展候选，应结合全波段差异、地质合理性及独立检测复核。

图像扫描行没有映射到逐点深度，不将本图称为已标定的地层柱状图。参考来源为 [USGS Spectral Library Version 7](https://www.usgs.gov/data/usgs-spectral-library-version-7-data)。
