davidfrantz/force

FORCE Docker镜像文档

镜像概述和主要用途

FORCE（Framework for Operational Radiometric Correction for Environmental Monitoring）是用于环境监测的业务化辐射校正框架。本Docker镜像提供了FORCE的便捷部署方案，封装了框架运行所需的完整依赖环境，支持多版本选择，适用于科研与业务场景中的辐射校正任务。

更多关于FORCE的详细信息，请访问GitHub仓库：https://github.com/davidfrantz/force

核心功能和特性

• 环境封装：整合FORCE运行所需的全部依赖，无需手动配置系统环境
• 多版本支持：提供灵活的版本选择策略，满足不同场景需求：
  • latest：主分支最新稳定版，经过充分测试，推荐生产环境使用
  • 版本标签（如3.6.2）：主分支历史发行版，保障旧版本兼容性
  • dev：开发分支前沿版，包含待发布功能，适合测试验证
• 跨平台兼容：基于Docker容器化技术，支持主流操作系统（Linux、Windows、macOS）

使用场景和适用范围

适用场景

• 卫星遥感数据的辐射校正处理
• 环境监测业务系统中的标准化数据预处理
• 遥感算法开发与验证（使用dev版本测试新功能）
• 历史项目复现（使用特定旧版本标签）

适用用户

• 环境监测领域科研人员
• 遥感数据处理工程师
• 需要标准化辐射校正流程的业务团队

使用方法和配置说明

前提条件

• 已安装Docker Engine（参考https://docs.docker.com/engine/install/%EF%BC%89
• 网络环境可访问Docker镜像仓库（如Docker Hub）

镜像拉取

根据需求选择以下命令拉取对应版本镜像（将<image-name>替换为实际镜像名称）：

bash
# 拉取最新稳定版（推荐生产环境）
docker pull <image-name>:latest

# 拉取特定历史版本（如3.6.2）
docker pull <image-name>:3.6.2

# 拉取开发版（测试新功能）
docker pull <image-name>:dev

容器运行

基础交互模式

启动交互式终端以手动执行FORCE命令：

bash
docker run -it --rm <image-name>:latest /bin/bash

• -it：启用交互模式并分配伪终端
• --rm：容器退出后自动清理文件系统
• /bin/bash：启动Bash shell（可替换为/bin/sh等）

挂载数据卷（推荐）

挂载本地数据目录至容器，实现数据持久化与共享：

bash
docker run -it --rm -v /local/data:/container/data <image-name>:latest \
  force-cmd --input /container/data/input.tif --output /container/data/output.tif

• -v /local/data:/container/data：将本地/local/data目录挂载到容器内/container/data

版本标签说明

配置参数与环境变量

当前镜像暂未定义强制环境变量，FORCE框架的详细配置请参考官方文档：
https://github.com/davidfrantz/force/blob/main/doc/config.md

注意事项

1. 性能优化：处理大规模遥感数据时，建议分配足够的CPU/内存资源（通过--cpus、--memory参数）
2. 版本选择：生产环境优先使用latest标签，避免直接使用dev版本
3. 数据安全：敏感数据建议通过数据卷挂载而非内置容器，避免镜像分发导致数据泄露