HomCloudにはコマンドラインインターフェース(CLI)とPythonインターフェースの2つのインターフェスが用意されています. それぞれのインターフェースに対していくつかのチュートリアルが用意されています. まずはポイントクラウドのチュートリアルから始めてください.
CLIとPythonではPythonのインターフェースの方がお勧めです. Pythonの科学技術計算エコシステムと組み合わせることでより便利にHomCloudを活用できます.
このチュートリアルはjupyter notebookを使っています.チュートリアルをする前に jupyter notebookをインストールしてください.
その後,python-tutorial.zipをダウンロードし,zipファイルを展開してください.
そこで tutorial/python-interface/
というディレクトリが作られるので,そこにターミナルでcd
で移動して,jupyter notebook
とするとWebブラウザ上でUIが開かれます.
そこに各チュートリアルに対応してディレクトリがあるので,それを開いてその下にある
.ipynb
ファイルを開いてチュートリアルを実行してください.
また,Python interface の API のドキュメントは python-api/から参照できます.
最近 HomCloud はGoogle Colaboratoryでも動作するようになりました. 現在Colabへのチュートリアルの移植を進行中です.
Jupyter notebookは勉強するのに使ったり試行錯誤には便利ですが,ある程度やることが固まってくると使いにくいと思います. そういうときは脱Jupyter notebookが必要なのでがんばってください.
このリンク先のファイルにjupyter notebookのnotebookファイル(.ipynb)や,データファイル等が含まれています.
このチュートリアルは jupyter notebook に bash_kernel というものを組み合わせて使っています. インストール方法は以下の通りです.
https://github.com/takluyver/bash_kernel を使います.インストール方法はこのリンク先にも書いてありますが,
pip3 install bash_kernel
python3 -m bash_kernel.install
とします.
tutorial/bash/
というディレクトリが
作られるので,そこにターミナルでcd
で移動して,
jupyter notebook
とするとWebブラウザ上でUIが開かれます.
そこに3つのディレクトリ(pointcloud
, binary-image
, grayscale-image
)
があるので,チュートリアルを実行してください.