ENVI扩展工具：中国国产卫星支持工具
1. 最近更新日志
2024.09.29
更新：新增支持一种特殊的 CBERS04 P10 数据格式。
之前支持的 P10 数据只有 1 个 3波段 tif 文件，而新增支持的数据有 3 个单波段 tif 文件，且定标系数格式有差别，需要特殊处理。
- CB04-P10-2-72-A2-YYYYMMDD-L20001234567.XML
- CB04-P10-2-72-A2-YYYYMMDD-L20001234567-2.TIF
- CB04-P10-2-72-A2-YYYYMMDD-L20001234567-3.TIF
- CB04-P10-2-72-A2-YYYYMMDD-L20001234567-4.TIF
2024.08.20
更新：新增支持一种 GF6 WFV 格式（GF06_WFI_*.meta.xml）。
GF6 WFV 命名格式为：
- GF06_WFI_123456_YYYYMMDD_ABCDE_01_000_L1A_01.meta.xml
注：由于没有 GF06 PMS 的示例数据，暂时未能支持。
2024.07.31
更新：新增支持一种 GF1 数据格式（GF01_*.meta.xml），其他已知问题修复。
GF1 命名格式为：
- GF01_MS2_123456_YYYYMMDD_ABCDE_01_000_L1A_01.meta.xml
- GF01_PA2_123456_YYYYMMDD_ABCDE_01_000_L1A_01.meta.xml
- GF01_WF2_123456_YYYYMMDD_ABCDE_01_000_L1A_01.meta.xml
注：由于只有一景 GF01_WF 测试数据，所以 GF01_MS 和 GF01_PA 的格式参考了 GF02 和 GF01_WF 的数据。
2024.05.07
更新：新增支持一种 GF2 数据格式（GF02_*.meta.xml），更新部分波谱响应函数，添加 ZY102E VNIC 定标系数。
GF2 命名格式为：
- GF02_MS2_123456_YYYYMMDD_ABCDE_01_000_L1A_01.meta.xml
- GF02_PA2_123456_YYYYMMDD_ABCDE_01_000_L1A_01.meta.xml
2024.03.11
更新：新增官方公布的 2023 年定标系数，修复其他已知问题。
2024.01.10
更新：新增支持 HJ2A/B HSI 高光谱传感器数据，点击查看详情。
2023.12.28
1. 新增支持 FY4A/B AGRI 全圆盘图像（需要 ENVI 5.5.3 及以上版本）
2. 新增支持 SuperView-2 卫星数据
3. 新增支持一种 BJ3A 数据格式
4. 重新设计菜单/工具，适配中文界面
2023.12.25
更新：新增支持 GF5A AHSI 传感器数据，点击查看详情。
2023.04.12
更新：新增 2022 年部分传感器定标系数；新增支持 ZY1-02E（ZY1F）卫星 AHSI 数据。
2022.12.28
更新：新增自动识别菜单（Auto Identify），可打开除 FY3 的其他所有已支持传感器类型。并提供如下接口：
raster = ENVIOpenChinaRaster(xmlfile)输入的必须为标准格式的 xml 文件。同时，此函数可打开 ENVI 格式、TIFF、Landsat（MTL.txt）等数据。
另外有可选关键字 error，若在调用时使用，如果遇到错误，将会把错误消息保存在 error 变量中，并返回 !null
raster = ENVIOpenChinaRaster(xmlfile, error=error)2022.11.11
更新：新增支持 GF5B AHSI/VIMI 数据。可识别 RPC、波长、定标系数等元数据。
当 AHSI 传感器数据同时包含 VN、SW 数据时，将打开 3 个数据集（如下图所示），分别为 VN 和 SW 波段组合结果、VN 图像、SW 图像。可根据需要处理不同的数据。
2022.10.08
更新：新增支持 ZY1-02E（ZY1F）卫星 VNIC 数据（包含 MUX 和 PAN）；暂时未支持 AHSI 高光谱传感器数据，因为没有样例数据。
由于没有查询到 MUX 的波长信息，考虑到 ZY1-02E 与 02D 传感器性能一致，暂时使用的是 02D 多光谱的波长设定。
2022.09.21
更新：新增 CBERS04A（ZY1-04A）卫星数据，全面支持三种传感器（WPM/MUX/WFI），其中 WPM 包含 MSS 和 PAN 两种传感器
2022.09.16
更新：新增支持一种特殊的 GF7 数据格式，文件名类似如下：
2022.09.15
更新：ENVI 5.6.2 及以上版本新增支持北京三号N星数据（BJ3N），识别RPC、时间、定标系数、波长等信息。
2022.08.19
更新1：新增支持环境二号 CCD 传感器数据（HJ-2A2B），提供波谱响应函数，识别RPC、时间、波长，添加定标系数等。2021年定标系数暂时缺少 HJ2A CCD2 和 HJ2B CCD4 传感器；
更新2：新增支持北京三号A星 PMS 传感器数据（BJ3A），识别RPC、时间、波长等信息。
更新3：新增支持吉林一号宽幅01B/C数据（JL1KF01B、JL1KF01C）
2022.01.20
更新1：优化GF7识别定标系数。当xml文件中不存在“增益模式”和“积分级数”时，使用默认项添加定标系数。2021年定标系数已不再区分“增益模式”；
更新2：优化ZY1-02D/GF-5 AHSI数据兼容性。优化对仅包含VN或SW波段的数据支持，打开时自动识别。
2. 功能介绍
ENVI 目前已原生支持高分1号、资源三号01和资源一号02c三颗卫星数据。但是一些元数据信息（如辐射定标参数）是内置在ENVI软件中的，所以在我们使用新的数据时需要手动更新这些信息，操作较为繁杂。
本工具支持卫星传感器较多，如果在使用过程中遇到问题，请将错误截图、数据情况等内容发送至 duhj@geoscene.cn
中国国产卫星支持工具，支持如下卫星传感器：
| 卫星 | 传感器 |
| GF-1 | PMS/WFV |
| GF-1B/C/D | PMS |
| GF-2 | PMS |
| GF-4 | PMS/IRS |
| GF-5 | AHSI/VIMS |
| GF-5A | AHSI |
| GF-5B | AHSI/VIMI |
| GF-6 | PMS/WFV |
| GF-7 | MUX/PAN/DLC |
| ZY3-01A | MUX/NAD/FWD/BWD |
| ZY3-02A | MUX/NAD/TMS |
| ZY1-02C | PMS/HR |
| ZY1-02D (ZY1E) | PAN/MUX |
| ZY1-02E (ZY1F) | VNIC/AHSI |
| CBERS-04 (ZY1-04) | MUX/P5M/P10/IRS |
| CBERS-04A (ZY1-04A) | WPM/MUX/WFI |
| TRIPLESAT(Beijing-2) | MS/PAN |
| BJ3A | MS/PAN |
| BJ3N | MS/PAN |
| JL1 | JL101A PMS(L1/L2)、JL1GP (JL101C、JL102C)、JL1GF、JL1KF |
| SuperView-1 | PMS(L1B/L2A) |
| SuperView-2 | PMS(L2A) |
| HJ-1A1B | CCD/HSI/IRS 【仅支持 ENVI 5.4 及以上】 |
| HJ-2A2B | CCD/HSI |
| TH01 | GFB（2米）/DGP（10米） |
| OHS (ZhuHai-1) | OHS COMS 【32波段。分辨率10米】 |
| FY-3 | FY-3A/B/C VIRR、FY-3D MERSI，1000M 【仅支持 ENVI 5.4 及以上】 |
| FY-4 | FY4A/B AGRI DISK【仅支持 ENVI 5.5.3 及以上】 |
注1：对于ZY3-01a数据，支持由中国资源卫星应用中心（CRESDA）和国家测绘地理信息局卫星测绘应用中心（SASMAC）生产的资源三号01a数据。命名格式分别为：
CRESDA：zy301a_mux_******_sec_******.xml
SASMAC：ZY3_01a_mynfavm_******_SASMAC_******.xml
注2：对于TRIPLESAT（即北京2号）数据，自动识别RPC参数。由于北京2号数据为tif/tfw格式，此工具会自动将tfw文件加后缀.bak，否则会影响北京2号数据在ENVI中的正常打开。如果其他软件需要tfw文件，请自行手动去除.bak即可。
注3：此工具自动将GF-1 WFV、GF-2、GF-4、GF-6、CBERS-04、TRIPLESAT（即北京2号）、HJ CCD
光谱响应函数路径：...\ENVI5x\resource\filterfuncs\
重要说明：凡是sli文件名中包含pms的光谱响应函数，均由PAN+多光谱组成，所以在进行FLAASH大气校正时，如果使用了本工具提供的sli文件，请将 Multispectral Setting 中的“Index to first band”设置为1。
3. 安装方法
方法1：使用 ENVI App Store 进行 ENVI 扩展工具的安装与管理。
App Store 下载地址：envi.geoscene.cn/appstore
方法2：手动下载 https://envi.geoscene.cn/appstore/chiseisort
下载 zip 压缩包并解压，将得到的 extensions、custom_code 和 resource 文件夹拷贝到如下 ENVI 安装路径，覆盖同名文件夹即可：
-
ENVI 5.3 - C:\Program Files\Exelis\ENVI53\
-
ENVI 5.4 及以上 - C:\Program Files\Harris\ENVI5x\
- ENVI 6.0 及以上 - C:\Program Files\NV5\ENVI5x\
重启 ENVI 即可使用。
4. 使用方法
4.1 数据支持工具
安装完毕后，重启 ENVI。
新增菜单：File > Open As > China Satellites > ...
新增工具：Toolbox/Extensions/China Satellites/...
4.2 用户扩展参数
在ENVI安装路径中（...\ENVI5x\extensions\ChinaSatellitesSupport\），包含几个txt文件，分别为envi_gf_support.txt、envi_zy301a_support.txt、envi_zy102c_support.txt等，里边包含了高分系列、资源三号01a、资源一号02c等的定标参数。可自行按照格式添加新的参数。
用户可前往中国资源卫星应用中心（https://www.cresda.com/zgzywxyyzx/zlxz/list/zlxz_1.html）下载最新定标参数。
4.3 光谱响应函数
安装此工具后，自动在ENVI如下安装路径中新增国产卫星多个传感器的光谱响应函数，可直接用于FLAASH大气校正。
- C:\Program Files\Exelis\ENVI53\resource\filterfuncs\
- C:\Program Files\Harris\ENVI5x\resource\filterfuncs\
注：GF1-PMS、ZY3、ZY1-02c的光谱响应函数和传感器类型已经内置在FLAASH工具中。
4.4 开放接口调用
接口介绍：
| 接口 | 功能 |
| Raster=ENVIOpenChinaRaster(xmlFile) | 支持除FY3数据之外的所有其他数据，自动识别传感器类型。 |
| Raster=ENVI_Open_GF1_Raster(xmlFile) | 打开GF-1数据，需从文件中读取定标参数 envi_gf_support.txt |
| Raster=ENVI_Open_GF2_Raster(xmlFile) | 打开GF-2数据，需从文件中读取定标参数 envi_gf_support.txt |
| Raster=ENVI_Open_GF4_Raster(xmlFile) | 打开GF-4数据，需从文件中读取定标参数 envi_gf_support.txt |
| Raster=ENVI_Open_GF5_Raster(xmlFile) | 打开GF-5数据，自动从xml文件中识别元数据信息 |
| Raster=ENVI_Open_GF5A_Raster(xmlFile) | 打开GF-5A数据，自动从xml文件中识别元数据信息 |
| Raster=ENVI_Open_GF5B_Raster(xmlFile) | 打开GF-5B数据，自动从xml文件中识别元数据信息 |
| Raster=ENVI_Open_GF6_Raster(xmlFile) | 打开GF-6数据，需从文件中读取定标参数 envi_gf6_support.txt |
| Raster=ENVI_Open_GF7_Raster(xmlFile) | 打开GF-7数据，需从文件中读取定标参数 envi_gf7_support.json |
| Raster=ENVI_Open_ZY301a_Raster(xmlFile) | 打开ZY-3-01a数据，需从文件中读取定标参数 envi_zy301a_support.txt |
| Raster=ENVI_Open_ZY302a_Raster(xmlFile) | 打开ZY-3-01a数据，需从文件中读取定标参数 envi_zy302a_support.txt |
| Raster=ENVI_Open_ZY102c_Raster(xmlFile) | 打开ZY-1-02c数据，需从文件中读取定标参数 envi_zy102c_support.txt |
| Raster=ENVI_Open_CBERS04_Raster(xmlFile) | 打开CBERS-04数据，自动从xml文件中识别元数据信息 |
| Raster=ENVI_Open_CBERS04A_Raster(xmlFile) | 打开CBERS-04A数据，需从文件中读取定标参数 envi_cb04a_support.json |
| Raster=ENVI_Open_TRIPLESAT_Raster(xmlFile) | 打开北京2号数据，自动从xml文件中识别元数据信息，自动识别RPC |
| Raster=ENVI_Open_BJ3A_Raster(xmlFile) | 打开北京3号A星数据，自动从xml文件中识别元数据信息，自动识别RPC |
| Raster=ENVI_Open_BJ3N_Raster(xmlFile) | 打开北京3号N星数据，自动从xml文件中识别元数据信息，自动识别RPC |
| Raster=ENVI_Open_JL1_Raster(xmlFile) | 打开吉林1号各种数据，自动从xml文件中识别元数据信息，自动识别RPC |
| Raster=ENVI_Open_SuperView1_Raster(xmlFile) | 打开高景1号数据，自动从xml文件中识别元数据信息，自动识别RPC |
| Raster=ENVI_Open_SuperView2_Raster(xmlFile) | 打开高景2号数据，自动从xml文件中识别元数据信息，自动识别RPC |
| Raster=ENVI_Open_HJ1A1B_Raster(xmlFile) | 打开环境卫星1A、1B 数据，自动从xml文件中识别元数据信息 |
| Raster=ENVI_Open_HJ2A2B_Raster(xmlFile) | 打开环境卫星2A、2B 数据，自动从xml文件中识别元数据信息 |
| Raster=ENVI_Open_TH01_Raster(xmlFile) | 打开天绘1号数据，自动从xml文件中识别元数据信息，自动识别RPC |
| Raster=ENVI_Open_OHS_Raster(xmlFile) | 打开珠海一号高光谱数据（OHS），需要打开B15*_meta.xml文件 |
接口使用方法：
情况1：已正确安装此工具时，只需要在IDL中启动ENVI，即可调用对应接口，如：
|
e=envi() Raster = ENVI_Open_GF1_Raster(file) |
情况2：如果没有安装此工具，只希望调用接口，则需要保证 ChinaSatellitesSupport 内文件在同一文件夹内：
|
e=envi() Restore, '.../envi_china_satellites_support.sav' ;需要sav文件完整路径 Raster = ENVI_Open_GF1_Raster(file) |
5. 更早更新日志
2021.12.23
更新1：增加2021年定标系数，官方注明为试用版
更新2：新增支持ZY3-03a数据，暂时支持的文件名格式如下：
- zy303a_mux_000000_008888_20210101000000_01_sec_0004_1212121212
- zy303a_nad_000000_008888_20210101000000_01_sec_0001_1212121212
更新3：对于GF6 WFV数据，保留一种打开方式，即合并成一张图。无论选择til文件还是xml文件，都将合并成一张图进行打开。
2021.09.02
修改定标系数获取逻辑，自动获取最近年份的系数，并将年份添加到元数据中。
更新前：当工具没有内置图像拍摄年份的定标系数时，自动尝试获取前一年定标系数，如果也没有内置，将弹出提示，并且不为图像添加定标系数元数据信息。
更新后：当工具没有内置图像拍摄年份的定标系数时，自动获取工具内置的最近一年定标系数，并将其添加到元数据中，并将年份信息添加到如下元数据中。当发现系数年份与图像拍摄年份相差较大时，请自行考虑是否使用此定标系数用于辐射校正。
更新后好处：只要工具内置了传感器定标系数，无论打开该传感器哪个年份拍摄的图像，都将自动添加定标系数。本工具也将第一时间更新官方发布的定标系数。
2021.08.16 优化识别高分系列（1/2/4/5/6/7）的太阳高度角识别方法。
2021.05.26 新增自动识别高景一号太阳辐照度元数据信息
2021.05.07 修复打开 GF1 PMS 数据时由于日期格式不规范导致的错误
2021.02.22 新增支持
2021.01.18 新增支持
2021.01.01 优化支持吉林一号数据。新增支持GF-7、ZY1-02D（AHSI）。新增太阳辐照度、2020年定标系数，新增光谱响应函数。点击此处查看详情
2020.07.21
对 FY-3 的支持要求 ENVI 5.4 及更高版本！
本次更新增加对如下卫星数据的支持：
- FY-3A/B/C VIRR，L1B数据（HDF文件）
- FY-3D MERSI，1000M，L1B数据（HDF文件）
支持输出四种数据集：
- EV_RefSB（原始观测数据）
- Reflectance（定标为反射率）
- EV_Emissive（原始观测数据）
- Brightness Temperature（定标为亮温）
并优化了对 GF2 PMS、GF5 VIMS 数据的兼容性。点击此处查看详情
2019.12.27 增加 2019 年部分卫星定标系数，主要为 GF 系列、HJ 系列、ZY102c
2019.07.10 优化对 GF1B/C/D 的支持；增加支持 GF5 VIMS 6 波段产品；修复 GF6 一个小 BUG
2019.05.08
新增高分五号支持。本次更新仅对 AHSI、VIMS 传感器进行了支持。在打开 GF5 其他传感器数据时将提示暂不支持。目前仅有 DPC、EMI 的示例数据，均为 HDF5 格式（*.h5），可以直接在 ENVI 中打开所需的数据集。调用接口为：raster=ENVI_Open_GF5_Raster(xmlfile)
新增支持吉林一号光谱星（JL101C/JL102C、JL1GP01/02）。
2019.03.18
优化对 GF6 WFV 数据的支持，提供两种打开方式：
- 打开.til文件：自动合成一张图
- 打开.xml文件：分别打开3个tiff文件
- 重要说明：分别打开3个tiff时，由于显示问题有可能会看到缝隙（其实并不存在）。将图像1:1显示时将发现3个tiff接边区域非常吻合。
注：提供的接口为 raster = ENVI_Open_GF6_Raster(file)，对于PMS数据，支持输入GF6_PMS_*-MUX.xml、GF6_PMS_*-PAN.xml文件。对于 WFV 数据，如果输入.til文件，则返回合成后Raster；如果输入.xml文件，则返回Raster数组，包含3个TIFF文件。
2019.02.21
添加 2018 年定标系数，包含GF1/2/4/6，HJ，ZY3、ZY3-02、ZY1-02c。
增加支持 GF1B、GF1C、GF1D 卫星数据。
打开菜单或工具依然是 GF1。
打开接口依然是 raster = ENVI_Open_GF1_Raster(xmlfile)
对于 GF1B/C/D 卫星数据，能够自动识别RPC信息、更新定标系数等。
如果选择打开 GF1B_PMS_*_L1A6666666666.xml，将同时打开 MUX 和 PAN 图像；
如果选择打开
重要说明：由于目前仅有 GF1B 示例数据，所有将 GF1C 和 GF1D 数据格式与 GF1B 相同对待，如有错误，请联系 duhj@geoscene.cn。
2018.12.25 修复珠海一号定标系数识别问题
2018.12.04
修复由于安装此工具导致的 JSON_PARSE BUG 错误提示。
珠海一号定标系数更新支持多个 OHS CMOS 传感器，分别为 ohs_A/C/D COMS1/2/3。
更新优化珠海一号在 ENVI 5.3 中的支持。
2018.12.03
新增：支持珠海一号高光谱数据（OHS），添加波长、定标系数等，识别 RPC 信息。需要打开 B15*_meta.xml 文件，自动对 32 个tiff文件波段组合。在打开时，自动在同目录下生成*.meta和*.hdr文件，此文件格式为ENVI索引文件，下次打开此数据时，可以直接使用 ENVI 打开 meta 文件即可，无需Open As。支持的珠海一号数据示例如下（每个波段一个tif、rpc.txt等文件）
更新：HJ CCD/HSI 数据打开可以在ENVI 5.3版本使用，HJ IRS 数据依然需要在 ENVI 5.4及更高版本中使用。并且，在打开 CCD 数据时，自动在同目录下生成*.meta和*.hdr文件，此文件格式为ENVI索引文件，下次打开此数据时，可以直接使用 ENVI 打开 meta 文件即可，无需Open As。
2018.03.20 对于 HJ CCD 数据，自动使用中国资源卫星应用中心公布的定标系数
2018.01.05 增加对天绘1号数据支持。目前仅支持2米高分辨率（GFB）和10米多光谱
2017.12.26
增加HJ-1A1B的支持，包含CCD/HSI/IRS。识别时间、波长、坐标系等信息。此功能仅支持ENVI5.4及更高版本，因为调用了新的开发接口。
对于CCD、IRS，自动识别定标系数，可使用ENVI自带工具进行定标。
对于HSI，自动添加波长、FWHM，自动添加投影坐标系信息。
增加HJ 4个CCD的波谱响应函数，存放于filterfuncs文件夹
重要：当打开HSI数据时，如果报错“Keyword ORDEREDHASH not allowed in call to:H5_PARSE”，请移除extensions和save_add文件夹中的旧版工具(envi_hj1a1b_tools.sav)，然后重启ENVI即可。因为旧版工具中编译了旧的H5_PARSE函数代码。
2017.09.04
2017.07.07
2017.06.12 增加支持 ZY3-02a 卫星传感器
2016.12.13 优化对资源三号01a卫星的支持，支持目前所见的三种数据格式
2016.12.06 优化数据获取时间转换为格林尼治时间（UTC）的方法，更科学合理
2016.12.05 已更新对吉林一号01A卫星数据支持
2016.11.04 已更新 GF-4 最新版定标系数
2016.10.10 已更新支持 GF-4 PMS、IRS 传感器数据
