mcpField
G
geospatial-viewers

geospatial-viewers

github.com/isaaccorley数据与数据库7958 次安装12 周前更新
代码仓库

关于 geospatial-viewers

geospatial-viewers 是用于快速查看地理空间数据的工具集，适合需要检查栅格、矢量及表格数据的人。它包含交互式 Qt 查看器和可在终端内预览的命令行工具，并通过 uvx 运行。

主要功能

  1. 01交互式栅格查看
  2. 02交互式矢量查看
  3. 03终端内联预览
  4. 04CSV 和 Parquet 分析
  5. 05矢量表格查看与筛选

适用场景

  1. 01检查 GeoTIFF、HDF 或 NetCDF 栅格
  2. 02交互浏览矢量数据集
  3. 03在终端预览 CSV 或 Parquet
  4. 04通过 SSH 查看地理数据

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/isaaccorley/geospatial-skills --skill geospatial-viewers

安装后在 Claude Code 中输入/geospatial-viewers确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
viewgeom.md
viewinline.md
viewtif.md

详细介绍

地理空间查看器

用于快速预览地理空间数据的 3 个 CLI 工具。请始终通过 uvx 运行它们，以便自动安装，同时不污染项目环境。

工具用途PyPI
viewtif用于栅格数据（GeoTIFF、HDF、NetCDF、FileGDB）的交互式 Qt 查看器uvx viewtif
viewgeom用于矢量数据集的交互式 Qt 查看器uvx viewgeom
viewinline非交互式终端内嵌查看器（栅格、矢量、CSV、Parquet）uvx viewinline

选择合适的工具

  • 需要交互式缩放／平移／对比度调整？ 使用 viewtif（栅格）或 viewgeom（矢量）。
  • 要在 iTerm2/WezTerm/Konsole 中快速预览？ 使用 viewinline（无需 GUI 窗口，直接在终端中渲染）。
  • CSV/Parquet 分析（统计数据、直方图、SQL）？ 使用 viewinline。
  • 将矢量文件作为表格查看（描述、筛选、排序）？ 使用 viewinline --table。
  • 无头服务器／SSH／HPC？ 使用 viewinline（在本地终端中渲染，无需 X11）。

使用 uvx 运行

请始终在命令前加上 uvx，以自动安装并运行，且不修改本地环境：

uvx viewtif file.tif
uvx viewgeom boundaries.geojson
uvx viewinline file.tif

如需可选扩展，请使用 --from 标志：

uvx --from "viewtif[geo]" viewtif raster.tif --shapefile overlay.shp
uvx --from "viewtif[netcdf]" viewtif data.nc
uvx --from "viewgeom[parquet]" viewgeom data.geoparquet

快速参考

# Raster inspection
uvx viewtif image.tif
uvx viewtif image.tif --shapefile boundaries.shp
uvx viewtif image.tif --rgb 4 3 2
uvx viewtif image.tif --vmin 280 --vmax 320
uvx viewtif huge_raster.tif --scale 10

# NetCDF / HDF
uvx --from "viewtif[netcdf]" viewtif data.nc --subset 1 --timestep 100

# FileGDB raster
uvx viewtif "OpenFileGDB:/path/to.gdb:RasterName"

# Remote files
AWS_NO_SIGN_REQUEST=YES uvx --from "viewtif[geo]" viewtif s3://bucket/raster.tif --shapefile local.shp

# Vector inspection
uvx viewgeom boundaries.geojson
uvx viewgeom landuse.shp --column area_sqkm
uvx viewgeom earthquake.geojson --filter "mag > 5"
uvx viewgeom earthquake.geojson --duckdb "SELECT * FROM data WHERE mag > 5"
uvx viewgeom earthquake.geojson --duckdb "SELECT mag FROM data WHERE mag > 5" --save filtered.geojson

# Terminal-inline preview
uvx viewinline file.tif --colormap
uvx viewinline sentinel2.tif --rgb 4 3 2
uvx viewinline boundaries.geojson --color-by population
uvx viewinline file.nc --subset 1 --timestep 10

# CSV / Parquet analysis
uvx viewinline data.csv --describe
uvx viewinline data.csv --hist area_km2 --bins 30
uvx viewinline data.csv --scatter longitude latitude
uvx viewinline data.csv --sql "SELECT State, AVG(Income) FROM data GROUP BY State"

# Vector as table
uvx viewinline counties.shp --table --describe
uvx viewinline data.geoparquet --table --where "POP > 100000" --sort POP --desc

# Image gallery
uvx viewinline outputs/ --gallery 4x3

参考资料

  • references/viewtif.md
  • references/viewgeom.md
  • references/viewinline.md

评论

支持 Markdown