ecmwf/skinnywms

skinny WMS 镜像文档

镜像概述和主要用途

skinny WMS是一个轻量级WMS（Web Map Service）服务器，专注于可视化NetCDF和Grib格式的数据。其核心原理是浏览指定目录或文件，解析NetCDF/GRIB文件的元数据，自动生成WMS服务能力文档（getCapabilities），并选择合适样式绘制数据。运行后可通过内置Leaflet客户端访问可视化界面，提供直观的数据地图展示。

核心功能和特性

支持的WMS端点

• getCapabilities：发现数据并生成XML文档，将文件中的参数作为图层展示，包含预定义样式列表（默认提供基础样式）
• getMap：根据选定的图层和样式返回地图图像
• getLegendGraphic：返回对应图层的图例图形

使用场景和适用范围

适用于需要快速可视化气象、环境科学等领域NetCDF和Grib格式数据的场景，尤其适合：

• 科研人员快速查看数据空间分布
• 开发人员集成WMS服务到应用系统
• 教学演示中展示地理空间数据

使用方法和配置说明

Docker部署示例

1. 运行演示数据

默认加载内置演示数据，使用uwsgi启动服务：

bash
docker run --rm -p 5000:5000 -it ecmwf/skinnywms

访问 http://localhost:5000/ 查看Leaflet演示界面

2. 使用本地数据

挂载本地数据目录并指定数据路径：

bash
docker run --rm -p 5000:5000 -it \
    --volume=/path/to/local/data:/container/data \
    --env SKINNYWMS_DATA_PATH=/container/data \
    ecmwf/skinnywms

通过 http://localhost:5000/ 访问包含本地数据的可视化界面

3. 高级配置

通过环境变量自定义服务参数：

bash
docker run --rm -p 5000:5000 -it \
    --volume=/path/to/local/data:/container/data \
    --env SKINNYWMS_DATA_PATH=/container/data \
    --env SKINNYWMS_HOST=0.0.0.0 \
    --env SKINNYWMS_PORT=5000 \
    --env SKINNYWMS_MOUNT=/mymodel/ \
    --env SKINNYWMS_UWSGI_WORKERS=4 \
    --env SKINNYWMS_ENABLE_DIMENSION_GROUPING=1 \
    ecmwf/skinnywms

配置后可通过 http://localhost:5000/mymodel/wms?request=GetCapabilities 访问能力文档

环境变量配置说明

限制说明

• 对元数据完善的NetCDF/GRIB文件支持更好
• 风场u/v分量需在同一GRIB文件中才能显示为向量/风羽，可使用grib_copy合并：

  bash
  grib_copy u_component.grib2 v_component.grib2 combined_wind.grib2
  

• 时间和高程维度实现遵循OGC Met Ocean WMS 1.3最佳实践，需启用维度分组
• 当前处于Alpha开发阶段