2025/7/29開催 開発者向けセミナー『ベクトルであそぼう!』のソースコードです。 YouTubeリンク 資料PDF

• InterSystems IRIS (2024.3 以降, Community Edition / Advanced Server)

• Python 3.x（venv 推奨）

※ ただし、Pythonの最新バージョン 3.13は利用できません(IRISが未対応/ sentencepieceとの互換性により)

• Jupyter Notebook

InterSystems IRIS (2024.3 以降のCommunity Edition もしくは Advanced Server が必要です。)

IRIS Community Edition のダウンロード/インストールは下記をご覧ください。

InterSystems IRIS／InterSystems IRIS for Health コミュニティエディションのダウンロード方法

本プロジェクトは Python 3.x が必要です。

※ ただし、Pythonの最新バージョン 3.13は利用できません(IRISが未対応/ sentencepieceとの互換性により)

• Windows の方は： こちら の Windows installer (64-bit) からダウンロードしてインストールしてください。

• macOS の方は Homebrew を使ってPython3.12をインストールできます：

1. Homebrew がインストールされていない場合：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Python 3.12 をインストールする

brew install python@3.12

3. Python 3.12 を有効化（zsh / bash に応じて）

echo 'export PATH="/opt/homebrew/opt/python@3.12/bin:$PATH"' >> ~/.zprofile
source ~/.zprofile

4. バージョン確認

python3.12 --version

→ Python 3.12.x と表示されればインストール成功です

Python の仮想環境（venv）を使うことで、依存関係や環境構築をプロジェクトごとに独立することができ、管理が簡単になります。

# 任意の名前(ここではfishenv)で環境を作成する
python -m venv fishenv

# 仮想環境を有効化する
fishenv\Scripts\activate     # Windows の場合
source fishenv/bin/activate  # macOS/Linux の場合

# PIPで必要なライブラリをインストールする
# (Jupyter Notebook の欄を参照ください)

# (参考)仮想環境を終了するには
deactivate

Jupyter Notebook のインストール

pip install jupyter

• IRIS を起動します。

iris start (インスタンス名)
# もしくは、システムトレイから起動(Windowsの場合)

• 仮想環境を有効化します。

# 仮想環境を有効化する
fishenv\Scripts\activate     # Windows の場合
source fishenv/bin/activate  # macOS/Linux の場合

• notebook/iris_config.py を編集しIRISへの接続情報を記載してください。

• Jupyter Notebook を起動します。

jupyter notebook

• 上記コマンドを実行すると、ブラウザでJupyter Notebookが起動します。

• /notebook/配下のファイルをJupyter NotebookのUI上で開きます

  • Prep.ipynb, FishNameAsobo.ipynb, VisualizeVector.ipynb を実行して実験を行ってください。
  • !pip install ... と記載された部分を実行すると、ライブラリをインストールします。
  • 実験完了後、データやテーブルが不要でしたら CleanUp.ipynbを実行してください。

• notebook/iris_config.py

  • IRISへの接続情報を設定

• notebook/Prep.ipynb

  • テーブルの作成、データの登録

• notebook/FishNameAsobo.ipynb

  • 魚の写真から魚の名前をあてる実験

• notebook/VisualizeVector.ipynb

  • ベクトルの可視化 / クラスタリング / アノマリ検知

• notebook/CleanUp.ipynb

  • データの削除、テーブルの削除

• datasets/fishname.csv

  • 魚の名前リスト

• datasets/super

  • スーパーで購入した魚の画像

• datasets/Wikipedia/image/

  • Wikipediaから取得した画像

• datasets/Wikipedia/CREDITS.md

  • ライセンス表記