# PlateauKit + PlateauLab
[](https://pypi.org/project/plateaukit/)
[](https://github.com/ozekik/plateaukit/actions/workflows/ci.yaml)
[](https://codecov.io/gh/ozekik/plateaukit)
[](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> -->
## 目次 Table of Contents
- [機能 Features](#機能-features)
- [インストール Installation](#インストール-installation)
- [活用事例・紹介 Use Cases & Mentions](#活用事例紹介-use-cases--mentions)
- [ロードマップ Roadmap](#ロードマップ-roadmap)
- [その他のツール・ライブラリ Alternatives](#その他のツールライブラリ-alternatives)
- [発表資料 Presentations](#発表資料-presentations)
- [クレジット Credits](#クレジット-credits)
- [ライセンス License](#ライセンス-license)
## 機能 Features
- [x] PLATEAUデータセットのインストール・管理
- [x] GeoJSON / CityJSONへの変換
- Java製の外部ライブラリ (citygml4j, citygml-tools) 非依存
- 並列処理に対応 (変換速度の向上)
- 圧縮ファイルのまま変換可能 (省容量)
- [x] JupyterLab / Jupyer Notebookでの3D都市モデル表示 (LOD1/2)
<div><video controls src="https://github.com/ozekik/plateaukit/assets/32771324/ea02df34-82f9-462a-b2e7-3f71dd3201ea" muted="false"></video></div>
## インストール Installation
```sh
pip install 'plateaukit[all]'
```
- 詳細は[PlateauKitのインストール](https://ozekik.github.io/plateaukit/install/)を参照
## 活用事例・紹介 Use Cases & Mentions
PlateauKit + PlateauLab を開発の一部などでお使いいただいている事例やご紹介いただいている事例です。
事例の追加・修正は[Issues](https://github.com/ozekik/plateaukit/issues)または[Pull Requests](https://github.com/ozekik/plateaukit/pulls)からお知らせください。
- **[PythonでPLATEAUのデータを手軽に扱ってみる](https://youtu.be/D1JMQfmGwpg?si=tlSnFmwtkDPJPGd4&t=11949) (ぴっかりん ([@raokiey](https://github.com/raokiey)) 氏)** FOSS4G 2024 Japan コアデイ
- <https://github.com/raokiey/foss4g_2024_japan_general_presentation_25>
- **[AIまちづくりファシリテーター](https://protopedia.net/prototype/6072) (チーム シャキシャキ)** 🏆**グランプリ**, PLATEAU Hack Challenge 2024 in Tokyo
- **[PLATEAUを利用した名古屋市の犯罪マップと類似領域検索](https://www.mlit-data.jp/#/ShowcaseDetail?id=Showcase18) (向 直人氏)** 🏆**国土交通データプラットフォーム特別賞**, アーバンデータチャレンジ2023 with 土木学会インフラデータチャレンジ2023
## ロードマップ Roadmap
- [x] ドキュメントの整備
- [x] 最小限のテストの整備
- [x] [ipydeck](https://github.com/ozekik/ipydeck)対応
- [x] JupyterLiteサポート
- [x] LOD2サポート
- [ ] 標高データのサポート・可視化
- [ ] 軽量版データセットの提供
- [ ] テストの拡充
- [ ] 変換の高速化
## その他のツール・ライブラリ Alternatives
- [Awesome PLATEAU](https://japan-opendata.github.io/awesome-plateau/)
### Python
- [plateaupy](https://github.com/AcculusSasao/plateaupy) (Open3D/Blender)
- [rhenerose/plateaupy](https://github.com/rhenerose/plateaupy)
- [plateau-geo-tools](https://github.com/raokiey/plateau-geo-tools) (GeoJSON)
### その他
- 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)
## 発表資料 Presentations
- **[PlateauKit + PlateauLabによる都市空間プログラミング](https://www.mlit.go.jp/plateau/file/events/doc/20240528_dxkaigi_Ozeki-shi.pdf)** まちづくりDX全国会議 presented by 国土交通省都市局[↗](https://www.mlit.go.jp/plateau/journal/j061/)
- **[PlateauKit + PlateauLab](https://speakerdeck.com/toshiseisaku/no-dot-4-plateaukit-plus-plateaulab)** PLATEAU AWARD 2023[↗](https://www.mlit.go.jp/plateau-next/2023/award/)
## クレジット Credits
- `tests/fixtures/30422_taiji-cho_2021_citygml_2_op.zip`, `tests/fixtures/30422_taiji-cho_city_2021_citygml_4_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/) の利用規約に従ってください。
Raw data
{
"_id": null,
"home_page": "https://ozekik.github.io/plateaukit/",
"name": "plateaukit",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Kentaro Ozeki",
"author_email": "32771324+ozekik@users.noreply.github.com",
"download_url": "https://files.pythonhosted.org/packages/89/0e/0b0efb0268dceac49c20976e67356a62470de79a021f99403a5ce8c31d0a/plateaukit-0.18.0.tar.gz",
"platform": null,
"description": "# PlateauKit + PlateauLab\n\n[](https://pypi.org/project/plateaukit/)\n[](https://github.com/ozekik/plateaukit/actions/workflows/ci.yaml)\n[](https://codecov.io/gh/ozekik/plateaukit)\n[](https://pypistats.org/packages/plateaukit)\n\n> Python library and utility for programming 3D city models by MLIT Project PLATEAU\n\n**PlateauKit** \u306f\u3001<a href=\"https://www.mlit.go.jp/plateau/\" target=\"_blank\">\u56fd\u571f\u4ea4\u901a\u7701PLATEAU\u30d7\u30ed\u30b8\u30a7\u30af\u30c8</a>\u306e3D\u90fd\u5e02\u30e2\u30c7\u30eb\u3092\u5229\u7528\u3059\u308b\u305f\u3081\u306e\u5909\u63db\u30c4\u30fc\u30eb\u304a\u3088\u3073Python\u30e9\u30a4\u30d6\u30e9\u30ea\u3067\u3059\u3002\n\n**PlateauLab** \u306f\u3001<a href=\"https://jupyter.org\" target=\"_blank\">JupyterLab / Jupyter Notebook</a>\u4e0a\u3067PLATEAU\u90fd\u5e02\u30e2\u30c7\u30eb\u3092\u6271\u3046\u30b3\u30fc\u30c7\u30a3\u30f3\u30b0\u74b0\u5883\u3092\u5b9f\u73fe\u3059\u308b\u305f\u3081\u306ePython\u30e9\u30a4\u30d6\u30e9\u30ea\u3067\u3059\u3002 \u73fe\u5728\u306fPlateauKit\u306e\u4e00\u90e8\u3068\u3057\u3066\u63d0\u4f9b\u3057\u3066\u3044\u307e\u3059\u3002\n\n- **\u30c9\u30ad\u30e5\u30e1\u30f3\u30c8 Documentation:** <https://ozekik.github.io/plateaukit/>\n<!-- - **\u30d6\u30e9\u30a6\u30b6\u3067\u8a66\u3059 (\u8a66\u9a13\u7248) Try in Your Browser (Experimental):** <https://ozekik.github.io/plateaukit/jupyterlite/notebooks/?path=demo.ipynb> -->\n\n## \u76ee\u6b21 Table of Contents\n\n- [\u6a5f\u80fd Features](#\u6a5f\u80fd-features)\n- [\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb Installation](#\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb-installation)\n- [\u6d3b\u7528\u4e8b\u4f8b\u30fb\u7d39\u4ecb Use Cases & Mentions](#\u6d3b\u7528\u4e8b\u4f8b\u7d39\u4ecb-use-cases--mentions)\n- [\u30ed\u30fc\u30c9\u30de\u30c3\u30d7 Roadmap](#\u30ed\u30fc\u30c9\u30de\u30c3\u30d7-roadmap)\n- [\u305d\u306e\u4ed6\u306e\u30c4\u30fc\u30eb\u30fb\u30e9\u30a4\u30d6\u30e9\u30ea Alternatives](#\u305d\u306e\u4ed6\u306e\u30c4\u30fc\u30eb\u30e9\u30a4\u30d6\u30e9\u30ea-alternatives)\n- [\u767a\u8868\u8cc7\u6599 Presentations](#\u767a\u8868\u8cc7\u6599-presentations)\n- [\u30af\u30ec\u30b8\u30c3\u30c8 Credits](#\u30af\u30ec\u30b8\u30c3\u30c8-credits)\n- [\u30e9\u30a4\u30bb\u30f3\u30b9 License](#\u30e9\u30a4\u30bb\u30f3\u30b9-license)\n\n## \u6a5f\u80fd Features\n\n- [x] PLATEAU\u30c7\u30fc\u30bf\u30bb\u30c3\u30c8\u306e\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u30fb\u7ba1\u7406\n- [x] GeoJSON / CityJSON\u3078\u306e\u5909\u63db\n - Java\u88fd\u306e\u5916\u90e8\u30e9\u30a4\u30d6\u30e9\u30ea (citygml4j, citygml-tools) \u975e\u4f9d\u5b58\n - \u4e26\u5217\u51e6\u7406\u306b\u5bfe\u5fdc (\u5909\u63db\u901f\u5ea6\u306e\u5411\u4e0a)\n - \u5727\u7e2e\u30d5\u30a1\u30a4\u30eb\u306e\u307e\u307e\u5909\u63db\u53ef\u80fd (\u7701\u5bb9\u91cf)\n- [x] JupyterLab / Jupyer Notebook\u3067\u306e3D\u90fd\u5e02\u30e2\u30c7\u30eb\u8868\u793a (LOD1/2)\n\n<div><video controls src=\"https://github.com/ozekik/plateaukit/assets/32771324/ea02df34-82f9-462a-b2e7-3f71dd3201ea\" muted=\"false\"></video></div>\n\n## \u30a4\u30f3\u30b9\u30c8\u30fc\u30eb Installation\n\n```sh\npip install 'plateaukit[all]'\n```\n\n- \u8a73\u7d30\u306f[PlateauKit\u306e\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb](https://ozekik.github.io/plateaukit/install/)\u3092\u53c2\u7167\n\n## \u6d3b\u7528\u4e8b\u4f8b\u30fb\u7d39\u4ecb Use Cases & Mentions\n\nPlateauKit + PlateauLab \u3092\u958b\u767a\u306e\u4e00\u90e8\u306a\u3069\u3067\u304a\u4f7f\u3044\u3044\u305f\u3060\u3044\u3066\u3044\u308b\u4e8b\u4f8b\u3084\u3054\u7d39\u4ecb\u3044\u305f\u3060\u3044\u3066\u3044\u308b\u4e8b\u4f8b\u3067\u3059\u3002\n\u4e8b\u4f8b\u306e\u8ffd\u52a0\u30fb\u4fee\u6b63\u306f[Issues](https://github.com/ozekik/plateaukit/issues)\u307e\u305f\u306f[Pull Requests](https://github.com/ozekik/plateaukit/pulls)\u304b\u3089\u304a\u77e5\u3089\u305b\u304f\u3060\u3055\u3044\u3002\n\n- **[Python\u3067PLATEAU\u306e\u30c7\u30fc\u30bf\u3092\u624b\u8efd\u306b\u6271\u3063\u3066\u307f\u308b](https://youtu.be/D1JMQfmGwpg?si=tlSnFmwtkDPJPGd4&t=11949) (\u3074\u3063\u304b\u308a\u3093 ([@raokiey](https://github.com/raokiey)) \u6c0f)** FOSS4G 2024 Japan \u30b3\u30a2\u30c7\u30a4\n - <https://github.com/raokiey/foss4g_2024_japan_general_presentation_25>\n- **[AI\u307e\u3061\u3065\u304f\u308a\u30d5\u30a1\u30b7\u30ea\u30c6\u30fc\u30bf\u30fc](https://protopedia.net/prototype/6072) (\u30c1\u30fc\u30e0 \u30b7\u30e3\u30ad\u30b7\u30e3\u30ad)** \ud83c\udfc6**\u30b0\u30e9\u30f3\u30d7\u30ea**, PLATEAU Hack Challenge 2024 in Tokyo\n- **[PLATEAU\u3092\u5229\u7528\u3057\u305f\u540d\u53e4\u5c4b\u5e02\u306e\u72af\u7f6a\u30de\u30c3\u30d7\u3068\u985e\u4f3c\u9818\u57df\u691c\u7d22](https://www.mlit-data.jp/#/ShowcaseDetail?id=Showcase18) (\u5411 \u76f4\u4eba\u6c0f)** \ud83c\udfc6**\u56fd\u571f\u4ea4\u901a\u30c7\u30fc\u30bf\u30d7\u30e9\u30c3\u30c8\u30d5\u30a9\u30fc\u30e0\u7279\u5225\u8cde**, \u30a2\u30fc\u30d0\u30f3\u30c7\u30fc\u30bf\u30c1\u30e3\u30ec\u30f3\u30b82023 with \u571f\u6728\u5b66\u4f1a\u30a4\u30f3\u30d5\u30e9\u30c7\u30fc\u30bf\u30c1\u30e3\u30ec\u30f3\u30b82023\n\n## \u30ed\u30fc\u30c9\u30de\u30c3\u30d7 Roadmap\n\n- [x] \u30c9\u30ad\u30e5\u30e1\u30f3\u30c8\u306e\u6574\u5099\n- [x] \u6700\u5c0f\u9650\u306e\u30c6\u30b9\u30c8\u306e\u6574\u5099\n- [x] [ipydeck](https://github.com/ozekik/ipydeck)\u5bfe\u5fdc\n- [x] JupyterLite\u30b5\u30dd\u30fc\u30c8\n- [x] LOD2\u30b5\u30dd\u30fc\u30c8\n- [ ] \u6a19\u9ad8\u30c7\u30fc\u30bf\u306e\u30b5\u30dd\u30fc\u30c8\u30fb\u53ef\u8996\u5316\n- [ ] \u8efd\u91cf\u7248\u30c7\u30fc\u30bf\u30bb\u30c3\u30c8\u306e\u63d0\u4f9b\n- [ ] \u30c6\u30b9\u30c8\u306e\u62e1\u5145\n- [ ] \u5909\u63db\u306e\u9ad8\u901f\u5316\n\n## \u305d\u306e\u4ed6\u306e\u30c4\u30fc\u30eb\u30fb\u30e9\u30a4\u30d6\u30e9\u30ea Alternatives\n\n- [Awesome PLATEAU](https://japan-opendata.github.io/awesome-plateau/)\n\n### Python\n\n- [plateaupy](https://github.com/AcculusSasao/plateaupy) (Open3D/Blender)\n - [rhenerose/plateaupy](https://github.com/rhenerose/plateaupy)\n- [plateau-geo-tools](https://github.com/raokiey/plateau-geo-tools) (GeoJSON)\n\n### \u305d\u306e\u4ed6\n\n- Blender: [Plateau-Blender-Importer](https://github.com/nneri-hin/Plateau-Blender-Importer)\n- Unreal Engine: [PLATEAU SDK for Unreal](https://github.com/Project-PLATEAU/PLATEAU-SDK-for-Unreal)\n- Unity: [PLATEAU SDK for Unity](https://github.com/Project-PLATEAU/PLATEAU-SDK-for-Unity)\n\n## \u767a\u8868\u8cc7\u6599 Presentations\n\n- **[PlateauKit + PlateauLab\u306b\u3088\u308b\u90fd\u5e02\u7a7a\u9593\u30d7\u30ed\u30b0\u30e9\u30df\u30f3\u30b0](https://www.mlit.go.jp/plateau/file/events/doc/20240528_dxkaigi_Ozeki-shi.pdf)** \u307e\u3061\u3065\u304f\u308aDX\u5168\u56fd\u4f1a\u8b70 presented by \u56fd\u571f\u4ea4\u901a\u7701\u90fd\u5e02\u5c40[\u2197](https://www.mlit.go.jp/plateau/journal/j061/)\n- **[PlateauKit + PlateauLab](https://speakerdeck.com/toshiseisaku/no-dot-4-plateaukit-plus-plateaulab)** PLATEAU AWARD 2023[\u2197](https://www.mlit.go.jp/plateau-next/2023/award/)\n\n## \u30af\u30ec\u30b8\u30c3\u30c8 Credits\n\n- `tests/fixtures/30422_taiji-cho_2021_citygml_2_op.zip`, `tests/fixtures/30422_taiji-cho_city_2021_citygml_4_op.zip`: PLATEAU\u30c7\u30fc\u30bf\u30bb\u30c3\u30c8 ([\u56fd\u571f\u4ea4\u901a\u7701 Project PLATEAU](https://www.mlit.go.jp/plateau/site-policy/), [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/deed.ja))\n\n## \u30e9\u30a4\u30bb\u30f3\u30b9 License\n\nMIT License\n\nPLATEAU\u30c7\u30fc\u30bf\u30bb\u30c3\u30c8\u306e\u5229\u7528\u306b\u3064\u3044\u3066\u306f\u3001[\u56fd\u571f\u4ea4\u901a\u7701 Project PLATEAU](https://www.mlit.go.jp/plateau/site-policy/) \u306e\u5229\u7528\u898f\u7d04\u306b\u5f93\u3063\u3066\u304f\u3060\u3055\u3044\u3002\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python library and utility for 3D city models by MLIT Project PLATEAU",
"version": "0.18.0",
"project_urls": {
"Homepage": "https://ozekik.github.io/plateaukit/",
"Repository": "https://github.com/ozekik/plateaukit"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9c16fc04f874710ab0bd7813a3749bdbf5a46f4b07665d465c13a2b7ef52d8b2",
"md5": "5f487c355e30d607268bfe5586fb9fc1",
"sha256": "f562afe59d7c7fc15838c18865c01d9480e6ee6c2ea1152e92da10cb22e07702"
},
"downloads": -1,
"filename": "plateaukit-0.18.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5f487c355e30d607268bfe5586fb9fc1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 97534,
"upload_time": "2025-01-23T16:27:04",
"upload_time_iso_8601": "2025-01-23T16:27:04.588522Z",
"url": "https://files.pythonhosted.org/packages/9c/16/fc04f874710ab0bd7813a3749bdbf5a46f4b07665d465c13a2b7ef52d8b2/plateaukit-0.18.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "890e0b0efb0268dceac49c20976e67356a62470de79a021f99403a5ce8c31d0a",
"md5": "5e2a6243627cb21fe936a9f8c225613b",
"sha256": "e588338a5b0a182f636774f1052bfb41978a644a62fdb091cd1923e56fd2c649"
},
"downloads": -1,
"filename": "plateaukit-0.18.0.tar.gz",
"has_sig": false,
"md5_digest": "5e2a6243627cb21fe936a9f8c225613b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 72804,
"upload_time": "2025-01-23T16:27:06",
"upload_time_iso_8601": "2025-01-23T16:27:06.926268Z",
"url": "https://files.pythonhosted.org/packages/89/0e/0b0efb0268dceac49c20976e67356a62470de79a021f99403a5ce8c31d0a/plateaukit-0.18.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-23 16:27:06",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ozekik",
"github_project": "plateaukit",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "plateaukit"
}
JSON
