ZenSVI 开源项目最佳实践

1. 项目介绍

ZenSVI 是一个全面的 Python 包，用于下载、清洗和分析街景图像。该项目由 Koichi Ito（新加坡国立大学）开发，并提供了详尽的 API 文档和使用案例。ZenSVI 支持多种数据源，包括 Mapillary、KartaView、Amsterdam 和 NUS Global Streetscapes 数据集，使得用户能够轻松地获取和处理街景图像。

2. 项目快速启动

在开始使用 ZenSVI 之前，请确保您已经安装了必要的依赖项。以下是快速启动项目的步骤：

首先，安装 ZenSVI：

pip install zensvi

接下来，根据您需要的数据源安装相应的下载器：

from zensvi.download import MLYDownloader

mly_api_key = "YOUR_OWN_MLY_API_KEY"  # 请注册并获取您自己的 Mapillary API 密钥
downloader = MLYDownloader(mly_api_key=mly_api_key)

# 以下是一个使用 Mapillary 数据源的例子
downloader.download_svi("path/to/output_directory", lat=1.290270, lon=103.851959)

上述代码将会从 Mapillary 下载指定经纬度位置的街景图像到指定的输出目录。

3. 应用案例和最佳实践

下载街景图像

使用 ZenSVI，您可以轻松地从不同数据源下载街景图像。以下是一些示例：

• 从 Mapillary 下载数据：

from zensvi.download import MLYDownloader

downloader = MLYDownloader(mly_api_key="YOUR_OWN_MLY_API_KEY")
downloader.download_svi("path/to/output_directory", input_csv_file="path/to/csv_file.csv")

• 从 KartaView 下载数据：

from zensvi.download import KVDownloader

downloader = KVDownloader()
downloader.download_svi("path/to/output_directory", input_place_name="Singapore")

分析街景图像元数据

您可以使用 ZenSVI 分析图像元数据：

from zensvi.metadata import MLYMetadata

path_input = "path/to/input"
mly_metadata = MLYMetadata(path_input)
mly_metadata.compute_metadata(unit="image", indicator_list="all", path_output="path/to/output")

运行图像分割

对图像进行语义分割：

from zensvi.cv import Segmenter

segmenter = Segmenter(dataset="cityscapes", task="semantic")
segmenter.segment("path/to/input_directory", dir_image_output="path/to/image_output_directory", dir_summary_output="path/to/segmentation_summary_output")

运行场景分类

使用 Places365 进行场景分类：

from zensvi.cv import ClassifierPlaces365

classifier = ClassifierPlaces365()
classifier.classify("path/to/input_directory", dir_image_output="path/to/image_output_directory", dir_summary_output="path/to/classification_summary_output")

4. 典型生态项目

ZenSVI 作为街景图像处理工具，可以广泛应用于城市规划、交通分析、环境监测等领域。以下是一些典型的生态项目：

• 城市安全评估：使用 ZenSVI 下载街景图像，并通过图像分析评估城市不同区域的安全状况。
• 城市美化计划：通过分析街景图像，确定哪些区域需要绿化或美化，以提升城市整体形象。
• 交通流量分析：利用 ZenSVI 下载的图像，分析交通流量和车辆类型，为交通规划提供数据支持。

通过以上步骤和实践，您可以开始使用 ZenSVI 进行街景图像的下载、清洗和分析，并为各种实际应用提供支持。