# 环境说明（遥感论文项目）

> 最后更新：2026-10-22　自检结果：**5/5 PASS**

## 一、怎么用（三条命令）

```bash
cd "/vol1/ai/home/hermes-workspace/remote sense"

# 1) 启用环境（每个新终端执行一次）
source 06-环境/env.sh

# 2) 健康检查（会真的去读一颗卫星影像验证网络与栅格读取）
06-环境/venv/bin/python 02-代码/python/check_env.py

# 3) 环境损坏时重建（幂等，可反复执行）
bash 06-环境/setup.sh
```

**不要**直接 `pip install xxx`：系统 Python 是 PEP 668 externally-managed，会被拒绝；本项目一律用 `06-环境/venv/bin/pip`。

## 二、装了什么

| 组件 | 版本 | 用途 |
|---|---|---|
| Python | 3.11.2 | 解释器 |
| numpy | 2.4.6 | 数组/时序计算 |
| pandas | 3.0.6 | 特征表、CSV |
| scipy | 1.17.1 | **S-G 滤波、find_peaks 寻峰** |
| scikit-learn | 1.9.1 | 随机森林、消融实验、交叉验证 |
| matplotlib | 3.11.2 | 论文配图（Fig 2–8） |
| rasterio | 1.4.4 | 远程 COG 读取（/vsicurl） |
| pyproj | 3.7.2 | 投影换算 WGS84 ↔ UTM |
| shapely | 2.2.0 | 研究区与地块几何 |
| pystac-client | 0.9.0 | 公开 STAC 检索 |
| python-docx / openpyxl | 1.2.0 / 3.1.5 | 出 Word / Excel 汇报材料 |

完整锁定版本见 `06-环境/requirements.txt`（65 行，pip freeze）。

## 三、四个本机已踩过的坑（重要）

| # | 坑 | 现象 | 已采用的解法 |
|---|---|---|---|
| 1 | **清华 pip 镜像失效** | `/etc/pip.conf` 指向 `pypi.tuna.tsinghua.edu.cn`，连接直接失败（curl 返回 000） | 全部安装显式加 `-i https://mirrors.aliyun.com/pypi/simple/`（阿里云实测 200） |
| 2 | **PEP 668 外部管理环境** | `pip install` 报 "externally-managed-environment" | 不使用系统 Python，统一走 `06-环境/venv` |
| 3 | **`~/.config` 不可写** | matplotlib 每次启动报警并退化到 `/tmp`，导致缓存不持久 | 在 venv 的 `site-packages` 放 `zz_mplcache.pth`，启动即注入 `MPLCONFIGDIR=06-环境/mplcache`。**注意：不能用 `sitecustomize.py`**，会被 `/usr/lib/python3.11/sitecustomize.py` 抢先加载 |
| 4 | **磁盘不在那块 5.5T 盘上** | 工作区挂在 `nvme0n1p3`，**共 359 GB / 可用 231 GB**（`/vol1` 的 5.2 TB 是另一个文件系统） | 数据下载预算按 **≤200 GB** 规划；优先窗口化读取，不整幅下载 |

## 四、数据源可用性实测（2026-10-22）

| 源 | 需要账号 | 实测 | 用途 |
|---|---|---|---|
| `earth-search.aws.element84.com/v1` | **否** | ✅ 200，可检索可读 | **主数据源**（Sentinel-2 L2A COG） |
| `sentinel-cogs.s3.us-west-2.amazonaws.com` | 否 | ✅ 200 | COG 直读（/vsicurl） |
| `planetarycomputer.microsoft.com/api/stac/v1` | 否 | ✅ 200 | 备选 STAC |
| `catalogue.dataspace.copernicus.eu/stac` | 否 | ✅ 200 | 备选 STAC |
| `code.earthengine.google.com` | 是（GEE 账号） | ⚠️ 302（可达，未登录） | 论文主表述轨，待账号 |
| `www.mdpi.com` / `tandfonline.com` | 否 | ❌ 403（Cloudflare 挡爬虫） | **用户浏览器可正常打开**，机器抓不了 |
| `tcsae.org` 全文 PDF | 否 | ❌ 滑块验证码 | 浏览器手动过验证码可下 |

> 结论：**GEE 账号没批也不影响开工**——公开 STAC 已经能拿到同源 Sentinel-2 L2A 数据。

## 五、已验证的数据底数

金昌 AOI（102.10–102.30°E, 38.45–38.60°N）2024-03-01～11-30：
- Sentinel-2 L2A 共 **74 景**，其中 **61 景云量 < 30%**
- 跨 MGRS 瓦片 **47SQC / 48STH**
- 印证了"西北旱区纯光学可用、无需融合雷达"的判断

## 六、目录约定

```
02-代码/python/   分析脚本（fetch_cube.py 拉时序立方、check_env.py 自检）
03-数据/interim/  中间产物（.npz 时序立方）
03-数据/processed/ 特征矩阵、分类结果
04-图表/          论文配图
06-环境/          venv、requirements、setup.sh、mplcache
```
