mundialis/grass-py3-pdal

GRASS GIS Docker镜像

镜像概述和主要用途

GRASS GIS（地理资源分析支持系统）是一款开源地理信息系统（GIS），用于地理空间数据管理与分析、图像处理、地图制作、空间建模及可视化。本Docker镜像基于Alpine、Debian或Ubuntu系统构建，集成Python 3、GDAL和PDAL等工具，提供便捷的地理空间数据处理环境，适用于开发、研究和生产场景。

核心功能和特性

• 完整GIS功能：支持地理空间数据管理、空间分析、raster和vector数据处理、地图可视化
• 工具集成：内置Python 3、GDAL（地理数据抽象库）、PDAL（点云数据处理库）
• 多系统支持：基于Alpine、Debian或Ubuntu构建，适应不同环境需求
• 双版本支持：提供无图形界面（wxGUI）和带图形界面两种镜像版本
• 开发友好：支持通过Jupyter Notebooks使用Python API进行二次开发（可通过Binder在线启动）

使用场景和适用范围

• 地理空间数据分析：批处理地理数据、执行空间分析算法
• 开发环境：GRASS GIS Python API开发与测试
• 教学与研究：地理信息系统教学、学术研究中的空间数据处理
• 自动化工作流：集成到地理数据处理管道，实现自动化地图生成和分析

使用方法和配置说明

构建Docker镜像

A. 无图形界面（wxGUI）镜像

在源代码目录执行以下命令构建基础镜像：

bash
docker build -t grassgis .

B. 带图形界面（wxGUI）镜像

使用专用Dockerfile构建带GUI支持的镜像：

bash
docker build -t grassgis -f docker/ubuntu_wxgui/Dockerfile .

运行Docker容器

1. 无GUI镜像运行示例

前提：需准备GRASS GIS测试数据，可从https://grass.osgeo.org/sampledata/north_carolina/nc_basic_spm_grass7.zip%E4%B8%8B%E8%BD%BD%E3%80%82

场景1：在grassdata目录中启动

bash
# 在grassdata目录中执行
docker run -it --rm --user=$(id -u):$(id -g) --volume $(pwd):/data \
    --env HOME=/data/ docker.xuanyuan.run/grassgis grass --text nc_basic_spm_grass7/user1 \
        --exec g.region -p

场景2：在任意位置启动

bash
docker run -it --rm --user=$(id -u):$(id -g) \
    --volume /your/test/grassdata/:/data --env HOME=/data/ docker.xuanyuan.run/grassgis \
        grass /data/nc_basic_spm_grass7/PERMANENT --exec g.region -p

说明：命令中第一个grassgis为镜像名称，第二个grass为GRASS GIS可执行程序。

2. 运行测试用例

bash
docker run -it --rm --user=$(id -u):$(id -g) \
    --volume /your/test/grassdata/:/data --env HOME=/data/ -w /code/grass \
        docker.xuanyuan.run/grassgis grass /data/nc_basic_spm_grass7/PERMANENT --exec \
            python -m grass.gunittest.main \
                --location nc_basic_spm_grass7 --location-type nc

3. 带GUI镜像运行示例

bash
# 允许容器访问本地X11显示
xhost local:$(id -u)

# 启动带wxGUI的容器
docker run -it --privileged --user=$(id -u):$(id -g) --rm \
    --volume="$(pwd)/:/data" --volume="/tmp/.X11-unix:/tmp/.X11-unix:rw" \
    --env HOME=/data/ --env DISPLAY=$DISPLAY \
    --device="/dev/dri/card0:/dev/dri/card0" \
    docker.xuanyuan.run/grassgis grass --gui

注意事项

• 若本地已编译过GRASS GIS源代码，构建Docker镜像前需清理编译文件，避免冲突：

  bash
  make distclean
  

• 可通过Binder在线实验GRASS GIS Python API：https://mybinder.org/badge_logo.svg](https://mybinder.org/v2/gh/OSGeo/grass/main?urlpath=lab%2Ftree%2Fdoc%2Fnotebooks%2Fjupyter_example.ipynb)