3次元地図のソフトウェア Cesium を Python から使う

Cesium とは，３次元の「地図」をウエブブラウザで表示するための JavaScript ライブラリ． Cesium を Python から使えるソフトウェア cesiumpy をこのWebページで紹介します．

Web ページ: https://github.com/sinhrks/cesiumpy

謝辞：このページで紹介するソフトウェア等の作者に感謝します．

前準備

Python のインストール（Windows上）

注：既にPython（バージョン3.12を推奨）がインストール済みの場合は，この手順は不要である．

winget（Windowsパッケージマネージャー）を使用してインストールを行う

以下のコマンドを管理者権限のコマンドプロンプトで実行する（手順：Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」）。
winget（Windowsパッケージマネージャー）が利用可能か確認する：
```
winget --version
```

以下のコマンドを管理者権限のコマンドプロンプトで実行する（手順：Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」）。管理者権限は、wingetの--scope machineオプションでシステム全体にソフトウェアをインストールするために必要である。

REM Python 3.12 をシステム領域にインストール
winget install --scope machine --id Python.Python.3.12 -e --silent --accept-source-agreements --accept-package-agreements
REM Python のパス設定
set "PYTHON_PATH=C:\Program Files\Python312"
set "PYTHON_SCRIPTS_PATH=C:\Program Files\Python312\Scripts"
if exist "%PYTHON_PATH%" setx PYTHON_PATH "%PYTHON_PATH%" /M >nul
if exist "%PYTHON_SCRIPTS_PATH%" setx PYTHON_SCRIPTS_PATH "%PYTHON_SCRIPTS_PATH%" /M >nul
for /f "skip=2 tokens=2*" %a in ('reg query "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v Path') do set "SYSTEM_PATH=%b"
echo "%SYSTEM_PATH%" | find /i "%PYTHON_PATH%" >nul
if errorlevel 1 setx PATH "%PYTHON_PATH%;%PYTHON_SCRIPTS_PATH%;%SYSTEM_PATH%" /M >nul

【関連する外部サイト】

Python公式サイト：https://www.python.org/

【サイト内の関連ページ】

Python詳細ガイド：Pythonまとめ »

【関連する外部サイト】

Python公式サイト：https://www.python.org/

【サイト内の関連ページ】

Python詳細ガイド：Pythonまとめ »

sinhrks/cesiumpy の設定手順

正確には https://github.com/sinhrks/cesiumpy をご覧ください。私が行った設定手順の記録です．

GitHUB の sinhrks/cesiumpy のWeb ページを開く
https://github.com/sinhrks/cesiumpy
「Clone or download」を展開し，「Download ZIP」をクリック
.zip ファイルのダウンロードが始まるので確認する．
ダウンロードした .zip ファイルを展開（解凍）する．分かりやすいディレクトリに置く．
Windows での展開（解凍）に便利な 7-Zip: 別ページ »で説明

この .zip ファイルは，E:\cesiumpy-master\cesiumpy-master に展開（解凍）したものとして，説明を続けるので，適切に読み替えてください．
Windows では，コマンドプロンプトを 管理者として実行する．
先ほど展開（解凍）したディレクトリに移動
インストールしたいので、次のコマンドを実行
Ubuntu では「sudo python3 setup.py install」
```
python -m pip install -r requirements.txt
python setup.py install
```
（省略）
Jupyter notebook を起動
```
jupyter notebook
```
Python プログラムを動かして，結果を Web ブラウザでビジュアルに見たい．
* 「jupyternotebook」を入れたのに，jupyter notebook が起動しない という場合には，次の操作で，インストールを行ってから，もう一度試してみる．
```
python -m pip install -U jupyterlab jupyter jupyter-console jupytext spyder
```
ここから先は，Jupyter notebook の画面で説明する．
次のプログラムを実行．
```
import cesiumpy
```
次のプログラムを実行．
```
v = cesiumpy.Viewer()
```
次のプログラムを実行．
```
print(v)
```
下の図のようにエラーが出た場合には、もう一度同じことを繰り返す
Jupyter ノートブック (Jupyter Notebook) には Web ブラウザが内蔵されている（Web ブラウザで動く Python 開発環境）． いま表示されている地図はマウスで操作したりできる．