usgsastro/isis

ISIS 镜像文档

镜像概述和主要用途

ISIS（Integrated Software for Imagers and Spectrometers）是由美国地质调查局（USGS）开发的行星图像处理与分析软件。该镜像提供了ISIS的容器化部署方案，旨在简化软件安装流程，确保环境一致性，主要用于处理、校准和分析来自各类太空探测任务（如Apollo、Cassini、Chandrayaan等）的图像数据，支持从原始数据到科学成果的全流程处理。

核心功能和特性

• 多任务支持：兼容Apollo、Cassini、Chandrayaan、Clementine、Dawn等多种行星探测任务数据
• 全面数据处理：提供辐射校准、地图投影、相机模型构建、图像配准等核心功能
• SPICE Web服务：支持通过网络获取SPICE数据，大幅减少本地数据存储需求
• 容器化优势：通过Docker实现环境隔离，避免依赖冲突，简化跨平台部署
• 灵活数据管理：支持外部数据区域挂载，可按需下载特定任务数据，节省存储空间

使用场景和适用范围

• 行星科学研究：用于分析行星表面特征、地质构造、地形地貌等科学问题
• 太空任务数据分析：处理探测器传回的原始图像数据，生成科学可用的标准产品
• 学术研究与教育：高校和研究机构用于行星遥感教学、科研项目开发
• 数据预处理流水线：作为行星图像数据处理的基础工具，集成到自动化分析流程中

详细使用方法和配置说明

Docker镜像获取与构建

方法一：使用DockerHub预构建镜像

bash
docker run -it usgsastro/isis bash

方法二：本地构建镜像

1. 下载生产环境Dockerfile：

   bash
   curl -O https://raw.githubusercontent.com/USGS-Astrogeology/ISIS3/main/docker/production.dockerfile
   

2. 构建镜像：

   bash
   docker build -t isis -f production.dockerfile .
   

3. 运行镜像：

   bash
   docker run -it isis bash
   

数据区域配置

ISIS运行需要外部数据区域（包含校准文件、SPICE数据等），该数据未包含在镜像中，需单独下载并挂载。

数据下载方法

全量数据下载（约520GB，适用于所有任务）

bash
# 本地创建数据目录
mkdir -p /my/isis/data
cd /my/isis/data

# 对于ISIS 4.1.0及以上版本
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isisdata/data/ .

# 对于ISIS 4.1.0之前版本
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/ .

基础数据下载（约10GB，适用于基础功能）

bash
cd /my/isis/data
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isisdata/data/base .

特定任务数据下载（示例：Cassini任务）

bash
cd /my/isis/data
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isisdata/data/cassini .

# 使用SPICE Web服务（减少SPICE数据下载，需添加--exclude='kernels'）
rsync -azv --exclude='kernels' --delete --partial isisdist.astrogeology.usgs.gov::isisdata/data/cassini .

Docker数据挂载

运行容器时需挂载数据目录，示例：

bash
docker run -v /my/isis/data:/opt/conda/data -v /my/isis/testdata:/opt/conda/testData -it usgsastro/isis bash

• /my/isis/data：本地ISIS数据目录，挂载到容器内/opt/conda/data
• /my/isis/testdata：本地测试数据目录（可选），挂载到容器内/opt/conda/testData

环境变量配置

容器内自动配置以下关键环境变量：

• ISISROOT：ISIS安装路径（容器内固定为/opt/conda）
• ISISDATA：数据区域路径（容器内默认为/opt/conda/data，即挂载的外部数据目录）

基本使用示例

1. 激活ISIS环境（容器内自动激活）：

   bash
   conda activate isis
   

2. 验证安装：

   bash
   isis3Version
   

3. 处理示例（使用SPICE Web服务）：

   bash
   # 初始化图像SPICE信息（使用网络服务）
   spiceinit from=input.cub web=yes
   
   # 图像地图投影
   cam2map from=input.cub to=output.cub map=eqcylindrical
   

系统要求

硬件要求

• 64位(x86)处理器
• 至少2GB RAM（推荐8GB以上）
• 数据存储：基础数据约10GB，全量数据约520GB，处理空间依任务需求（10GB至数TB）

支持的宿主操作系统

• Linux（Ubuntu 18.04+、Fedora 28+、CentOS 7.2+等）
• macOS 10.13+
• Windows 10（通过WSL 2）

教程与引用

学习资源

ISIS官方教程可在https://github.com/USGS-Astrogeology/ISIS3/wiki/ISIS_Online_Workshops%E8%8E%B7%E5%8F%96%E3%80%82

引用规范

引用ISIS时应使用Zenodo生成的DOI，最新版本DOI为https://doi.org/10.5281/zenodo.2563341%EF%BC%8C%E5%BB%BA%E8%AE%AE%E5%BC%95%E7%94%A8%E5%85%B7%E4%BD%93%E4%BD%BF%E7%94%A8%E7%89%88%E6%9C%AC%E3%80%82