rio-viz 项目教程
rio-vizVisualize Cloud Optimized GeoTIFF in browser项目地址:https://gitcode.com/gh_mirrors/ri/rio-viz
项目介绍
rio-viz
是一个由 developmentseed
开发的 Rasterio 插件,旨在浏览器中可视化 Cloud Optimized GeoTIFF(COG)。该项目允许用户通过简单的命令行接口(CLI)快速启动一个 Web 服务器,以便在浏览器中查看和探索 GeoTIFF 文件。rio-viz
支持多种自定义读取器,并且可以在 Jupyter Notebook 环境中使用。
项目快速启动
安装
首先,确保你已经安装了 pip
,然后使用以下命令安装 rio-viz
:
pip install rio-viz
启动服务器
安装完成后,你可以使用以下命令启动一个 Web 服务器来查看你的 GeoTIFF 文件:
rio viz path/to/your/file.tif
默认情况下,服务器会在 http://127.0.0.1:8080
上启动,并自动打开一个网页供你浏览文件。如果你只想启动服务器而不打开网页,可以使用 --server-only
选项:
rio viz path/to/your/file.tif --server-only
示例代码
以下是一个简单的示例,展示如何在 Jupyter Notebook 中使用 rio-viz
:
import time
import httpx
from folium import Map, TileLayer
from rio_viz.app import Client
# 创建 rio-viz 客户端(使用 server-thread 启动后台任务)
client = Client("https://data.geo.admin.ch/ch.swisstopo.swissalti3d/swissalti3d_2019_2573-1085/swissalti3d_2019_2573-1085_0.5_2056_5728.tif")
# 给服务器一些时间来设置
time.sleep(1)
# 获取 tilejson
r = httpx.get(f"{client.endpoint}/tilejson.json", params={"rescale": "1600,2000", "colormap_name": "terrain"})
data = r.json()
# 获取边界
bounds = data["bounds"]
# 创建地图
m = Map(location=((bounds[1] + bounds[3]) / 2, (bounds[0] + bounds[2]) / 2), zoom_start=data["minzoom"])
aod_layer = TileLayer(tiles=data["tiles"][0], opacity=1, attr="Yo")
aod_layer.add_to(m)
m
应用案例和最佳实践
应用案例
rio-viz
可以用于多种场景,例如:
- 地理数据可视化:在浏览器中快速查看和分析 GeoTIFF 文件。
- 数据共享:通过 Web 服务器共享地理数据,便于团队成员或公众访问。
- 教学和演示:在教学或演示中展示地理数据,无需复杂的 GIS 软件。
最佳实践
- 使用 COG 格式:确保你的 GeoTIFF 文件是 Cloud Optimized GeoTIFF 格式,以获得最佳性能和兼容性。
- 配置选项:根据需要使用
--minzoom
、--maxzoom
和--port
等选项自定义服务器设置。 - 安全考虑:在公共网络中使用时,确保服务器的安全性,避免未授权访问。
典型生态项目
rio-viz
作为 Rasterio 生态系统的一部分,与其他相关项目协同工作,例如:
- Rasterio:一个用于读写栅格数据的 Python 库。
- rio-tiler:一个用于从 COG 文件中读取瓦片的库。
- Folium:一个用于在 Python 中创建交互式地图的库。
这些项目共同构成了一个强大的地理数据处理和可视化工具集,适用于各种地理信息系统(GIS)应用。
rio-vizVisualize Cloud Optimized GeoTIFF in browser项目地址:https://gitcode.com/gh_mirrors/ri/rio-viz