Metadata-Version: 2.1
Name: plateaukit
Version: 0.12.1
Summary: Python library and converter for 3D city models by MLIT Project PLATEAU
Home-page: https://ozekik.github.io/plateaukit/
License: MIT
Author: Kentaro Ozeki
Author-email: 32771324+ozekik@users.noreply.github.com
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Provides-Extra: all
Provides-Extra: citygml
Provides-Extra: quantized-mesh
Requires-Dist: bidict (>=0.22.1,<0.23.0)
Requires-Dist: click (>=8.1.3,<9.0.0)
Requires-Dist: flatgeobuf (>=0.3.0,<0.4.0)
Requires-Dist: fs (>=2.4.16,<3.0.0)
Requires-Dist: geojson (>=3.1.0,<4.0.0)
Requires-Dist: geopandas (>=0.14.0,<0.15.0)
Requires-Dist: ipydeck (>=0.3.0,<0.4.0)
Requires-Dist: ipython (>=8.22.2,<9.0.0)
Requires-Dist: ipywidgets (>=8.1.2,<9.0.0)
Requires-Dist: loguru (>=0.6.0,<0.7.0)
Requires-Dist: lxml (>=4.9.2,<5.0.0)
Requires-Dist: normalize-japanese-addresses (>=0.0.9,<0.0.10)
Requires-Dist: numpy (>=1.26.0,<2.0.0)
Requires-Dist: platformdirs (>=3.10.0,<4.0.0)
Requires-Dist: prettytable (>=3.6.0,<4.0.0)
Requires-Dist: pydantic (>=1,<3)
Requires-Dist: pydeck (>=0.8.0,<0.9.0)
Requires-Dist: pyodide-http (>=0.2.1,<0.3.0) ; sys_platform == "emscripten"
Requires-Dist: pyogrio (>=0.7.2,<0.8.0) ; (sys_platform != "emscripten") and (extra == "all" or extra == "citygml")
Requires-Dist: pyproj (>=3.4.1,<4.0.0)
Requires-Dist: quantized-mesh-encoder (>=0.4.3,<0.5.0) ; extra == "quantized-mesh"
Requires-Dist: requests (>=2.28.2,<3.0.0)
Requires-Dist: rich[jupyter] (>=13.7.0,<14.0.0)
Project-URL: Repository, https://github.com/ozekik/plateaukit
Description-Content-Type: text/markdown

# PlateauKit + PlateauLab

[![PyPI](https://img.shields.io/pypi/v/plateaukit.svg)](https://pypi.org/project/plateaukit/)
[![build](https://github.com/ozekik/plateaukit/actions/workflows/ci.yaml/badge.svg)](https://github.com/ozekik/plateaukit/actions/workflows/ci.yaml)
[![Coverage Status](https://codecov.io/gh/ozekik/plateaukit/branch/master/graph/badge.svg)](https://codecov.io/gh/ozekik/plateaukit)
[![PyPI downloads](https://img.shields.io/pypi/dm/plateaukit.svg)](https://pypistats.org/packages/plateaukit)

> Python library and utility for programming 3D city models by MLIT Project PLATEAU

**PlateauKit** は、<a href="https://www.mlit.go.jp/plateau/" target="_blank">国土交通省PLATEAUプロジェクト</a>の3D都市モデルを利用するための変換ツールおよびPythonライブラリです。

**PlateauLab** は、<a href="https://jupyter.org" target="_blank">JupyterLab / Jupyter Notebook</a>上でPLATEAU都市モデルを扱うコーディング環境を実現するためのPythonライブラリです。 現在はPlateauKitの一部として提供しています。

**ドキュメント Documentation:** <https://ozekik.github.io/plateaukit/>\
**ブラウザで試す (試験版) Try in Your Browser (Experimental):** <https://ozekik.github.io/plateaukit/jupyterlite/notebooks/?path=demo.ipynb>

<div><video controls src="https://github.com/ozekik/plateaukit/assets/32771324/ea02df34-82f9-462a-b2e7-3f71dd3201ea" muted="false"></video></div>

## 機能 Features

- [x] PLATEAUデータセットのインストール・管理
- [x] GeoJSON / CityJSONへの変換
    - Java製の外部ライブラリ (citygml4j, citygml-tools) 非依存
    - 並列処理による変換速度の向上
    - 圧縮ファイルのまま変換可能 (省容量)
- [x] JupyterLab / Jupyer Notebookでの3D都市モデル表示 (LOD1)

## インストール Installation

```sh
pip install plateaukit
```

## ロードマップ Roadmap

- [x] ドキュメントの整備
- [x] 最小限のテストの整備
- [x] [ipydeck](https://github.com/ozekik/ipydeck)対応
- [x] JupyterLiteサポート
- [ ] LOD2サポート (WIP)
- [ ] CityJSON変換の高速化
- [ ] 軽量版データセットの提供
- [ ] 標高データの可視化
- [ ] テストの拡充
- [ ] [ibis](https://github.com/ibis-project/ibis) (+geospatial) 対応の検討

## その他のツール・ライブラリ Alternatives

- [Awesome PLATEAU](https://japan-opendata.github.io/awesome-plateau/)

### Python

- [plateaupy](https://github.com/AcculusSasao/plateaupy)
  - [rhenerose/plateaupy](https://github.com/rhenerose/plateaupy)
- [plateau-geo-tools](https://github.com/raokiey/plateau-geo-tools)

### その他

- Blender: [Plateau-Blender-Importer](https://github.com/nneri-hin/Plateau-Blender-Importer)
- Unreal Engine: [PLATEAU SDK for Unreal](https://github.com/Project-PLATEAU/PLATEAU-SDK-for-Unreal)
- Unity: [PLATEAU SDK for Unity](https://github.com/Project-PLATEAU/PLATEAU-SDK-for-Unity)

## クレジット Credits

- `tests/fixtures/30422_taiji-cho_2021_citygml_2_op.zip`: PLATEAUデータセット ([国土交通省 Project PLATEAU](https://www.mlit.go.jp/plateau/site-policy/), [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/deed.ja))

## ライセンス License

MIT License

PLATEAUデータセットの利用については、[国土交通省 Project PLATEAU](https://www.mlit.go.jp/plateau/site-policy/) の利用規約に従ってください。

