geospatial-viewers

地理空間ビューアー

地理空間データを手早く確認するための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