2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

獣医薬用量計算GUIツールをStreamlitで作った -- CLI版コアロジックの完全再利用

2
Posted at

本記事で紹介するツールは試作品(プロトタイプ)です。
実務利用の際は出力内容の正確性を必ず確認してください。

はじめに

動物病院の現場では、薬の用量計算は日常的に発生する作業です。体重からmg/kgで必要量を算出し、手元の商品で何錠かを求める。この計算を支援するCLIツール(vet-dose-calc)を以前作成しましたが、「コマンドラインは難しい」という声がありました。

そこで、同じコアロジックをブラウザGUIで操作できるようにしたStreamlit版を開発しました。処方計算(投与日数から総量・費用を算出)と商品単価管理も追加しています。

この記事でわかること

  • CLI版のコアロジックをGUI版で完全再利用するアーキテクチャ設計
  • Streamlitのrerunモデルとst.session_stateによる状態保持パターン
  • 獣医療ドメインの安全設計(NTI薬警告、猫禁忌、免責事項の配置)
  • 処方計算ロジック(総量・費用算出)のpure Python実装

対象読者

  • Pythonの基本文法を理解している人
  • Streamlitでのアプリケーション開発に興味がある人
  • 既存CLIツールのGUI化を検討している人

動作環境

項目 バージョン
Python 3.10+
OS macOS / Linux / Windows
Streamlit 1.x
PyYAML 6.0+

技術構成

項目 選択 理由
言語 Python 3.10+ VT-004と統一、Streamlitの言語
GUI Streamlit Python完結、学習コスト最低、pip 1つでインストール
LLM Gemini 2.0 Flash(suggest機能のみ) VT-004のsuggest_engineをそのまま利用
データ YAML(ローカルファイル) VT-004と共用、DBサーバー不要

なぜStreamlitを選んだか

Streamlitを選んだ最大の理由はVT-004のPythonコアロジックをそのままimportして使える点です。Flask + Jinja2やFastAPI + フロントエンドの構成ではHTML/CSS/JSの3言語が必要になり、開発コストが跳ね上がります。

Gradioも候補でしたが、薬用量計算のようなフォーム入力→テーブル表示のUIにはStreamlitのウィジェット(selectbox, number_input, table, data_editor)のほうが適していました。

アーキテクチャ

モジュール構成

vet_dose_calc_gui/          # VT-005 GUI層(新規)
  __init__.py               # __version__ = "1.0.0"
  app.py                    # Streamlitエントリ、ページルーティング、パス解決
  prescription_calc.py      # 処方計算ロジック(pure Python)
  gui_formatter.py          # データ→GUI表示用変換(Streamlit非依存)
  views/
    calc_page.py            # 用量計算画面 + 処方計算
    suggest_page.py         # 薬剤提案画面(Gemini API連携)
    manage_page.py          # マスタ管理画面 + 単価登録

vet-dose-calc/              # VT-004コアロジック層(既存・import再利用)
  vet_dose_calc/
    dosage_calc.py          # 用量計算
    drug_registry.py        # 薬剤マスタCRUD
    product_registry.py     # 商品マスタCRUD
    suggest_engine.py       # LLM薬剤提案
    input_parser.py         # 入力バリデーション
ℹ️ ビューの配置先は `views/` です。Streamlitは `pages/` ディレクトリを自動検出してマルチページナビゲーションに追加するため、`views/` にリネームして回避しています。

データフロー

ユーザー入力(ブラウザ)
    ↓
Streamlit UI(views/*.py)
    ↓
gui_formatter.py(表示変換)
    ↓ import
VT-004 コアロジック(dosage_calc, drug_registry, ...)
    ↓
YAML データファイル(drugs.yaml, products.yaml)
    ↓
計算結果 → gui_formatter → session_state → Streamlit表示

コア実装

prescription_calc.py: 処方の総量・費用を計算する

VT-005で新規追加した処方計算モジュールです。1回投与量・投与回数/日・投与日数から総量を算出し、単価が登録されていれば処方費用も計算します。GUI非依存のpure Pythonなのでテストが容易です。

@dataclass
class PrescriptionResult:
    dose_per_time: float    # 1回投与量(錠/ml等)
    times_per_day: int      # 1日投与回数
    days: int               # 投与日数
    total_units: float      # 総投与量(錠/ml等)
    daily_units: float      # 1日あたり投与量

def calculate_prescription(dose_per_time, times_per_day, days):
    # バリデーション: dose_per_time > 0, times 1-6, days 1-365
    daily_units = round(dose_per_time * times_per_day, 3)
    total_units = round(daily_units * days, 3)
    return PrescriptionResult(...)

def calculate_cost(total_units, unit_price):
    if unit_price is None:
        return None  # 単価未登録は費用計算しない(エラーではない)
    return round(total_units * unit_price, 1)

calculate_costでunit_priceがNoneの場合にNoneを返す設計は、GUI側で「(単価未登録)」と表示するためです。

ℹ️ 処方計算はcalc_page.pyの「処方計算」セクションから呼ばれます。用量計算結果の商品ごとに、投与日数を入力すると総量と費用が表示される仕組みです。

gui_formatter.py: 安全警告の構築

VT-004のコアロジック出力をGUI表示用の辞書に変換するモジュールです。特に重要なのは安全警告の生成ロジックです。

def _build_warnings(species, safety_flags):
    warnings = []
    if safety_flags.get("cat_contraindicated") and species == "cat":
        warnings.append({
            "type": "error",     # st.error() で赤く強調表示
            "message": WARNING_CAT_CONTRA,
        })
    if safety_flags.get("narrow_therapeutic_index"):
        warnings.append({
            "type": "warning",   # st.warning() で黄色く表示
            "message": WARNING_NTI,
        })
    return warnings

猫禁忌はerror(赤)、NTIはwarning(黄)と視覚的に差別化しています。猫禁忌のペルメトリンを猫に使おうとすると赤い警告が表示されます。

app.py: マルチ環境でのVT-004パス解決

GUI版からCLI版のモジュールをimportする際、GitHub cloneと開発環境でディレクトリ構造が異なる問題を解決しています。

_VT004_CANDIDATES = [
    _PARENT / "vet-dose-calc",   # GitHub clone名
    _PARENT / "VT-004",          # 開発環境(tools/VT-004)
    _PARENT / "vet_dose_calc",   # pip editable install
]

for _candidate in _VT004_CANDIDATES:
    if not _candidate.is_dir():
        continue
    _inner = _candidate / "vet_dose_calc"
    if _inner.is_dir() and (_inner / "dosage_calc.py").exists():
        # パッケージ構造: sys.modulesにbare importエイリアスを登録
        _pkg = importlib.import_module("vet_dose_calc")
        for _mod_name in _VT004_BARE_MODULES:
            if _mod_name not in sys.modules:
                sys.modules[_mod_name] = importlib.import_module(
                    f"vet_dose_calc.{_mod_name}"
                )
    else:
        # フラット構造: ディレクトリ自体をsys.pathに追加
        sys.path.insert(0, str(_candidate))
    break

3つの候補パスを順に探索し、パッケージ構造(vet_dose_calc/dosage_calc.py)が見つかればsys.modulesにエイリアスを登録、フラット構造ならsys.pathに追加します。これによりVT-004のコードを一切変更せず、どの環境でもimportが成功します。

動作例

基本ケース: 犬5kgのアモキシシリン用量計算

コマンド:

streamlit run vet_dose_calc_gui/app.py
# ブラウザで: 動物種=犬, 体重=5.0kg, 薬剤=アモキシシリン/クラブラン酸 → 計算

出力:

アモキシシリン/クラブラン酸 (犬 / 5.0 kg)

[一般感染症] 62.5-125 mg
BID | PO | 期間: 7-14日
商品名              含有量         投与量
クラバモックス小型犬用  62.5 mg/tab   2 錠
クラバモックス大型犬用  250 mg/tab    0.5 錠 (計算値: 0.5)

登録データに基づく計算結果です。
臨床判断は必ず獣医師が行ってください。

体重5kgの犬で125mg(25mg/kg上限)が必要。62.5mg錠なら2錠、250mg錠なら0.5錠と即座に算出されます。

ケース2: 処方計算で総量と費用を確認

入力:

用量計算結果表示後 → 投与日数: 7日, 投与回数/日: 2 (BID)

出力:

クラバモックス小型犬用
  1日あたり: 4 錠
  総量: 28 錠
  処方費用: 1,400 円 (@50円/錠)

投与日数を入れるだけで「28錠必要、費用は1,400円」がすぐに分かります。投与日数や回数を変更しても即座に再計算されます。

ケース3: NTI薬(ジゴキシン)の警告表示

入力:

動物種: 犬, 体重: 10kg, 薬剤: ジゴキシン

出力:

⚠️ 治療域が狭い薬剤です。用量を慎重に確認してください。

[心房細動] 0.05-0.08 mg
BID | PO | 期間: 長期
注: 血中濃度モニタリング必須

NTI薬を選択すると黄色い警告バナーが自動表示されます。

ケース4: 猫禁忌薬(ペルメトリン)の警告表示

入力:

動物種: 猫, 体重: 4kg, 薬剤: ペルメトリン

出力:

🚫 この薬剤は猫に禁忌として登録されています。使用しないでください。

猫でペルメトリンを選ぶと赤い警告が表示され、致命的な誤投与を防ぎます。

技術的チャレンジ

チャレンジ1: 複数環境でのCLI版コアロジック参照

何が難しかったか: VT-004はCLI版として開発され、bare import(from dosage_calc import ...)を使っています。一方、GitHub公開版はパッケージ構造(vet_dose_calc/dosage_calc.py)に移行済みです。開発環境(VT-004/フラット構造)とGitHub clone環境(vet-dose-calc/パッケージ構造)の両方でimportを成功させる必要がありました。

どう解決したか: 3つの候補パスを順に探索し、パッケージ構造が検出された場合はsys.modulesにbare importエイリアスを登録する方式を採用しました。from dosage_calc import calculate_doseというVT-004側のbare importが、vet_dose_calc.dosage_calcにリダイレクトされます。

# sys.modulesエイリアス登録(コア部分)
sys.modules["dosage_calc"] = importlib.import_module("vet_dose_calc.dosage_calc")

学んだこと: sys.modulesエイリアスはimportのリダイレクトに使える強力な手法です。ただしグローバル状態を変更するため、影響範囲を限定する設計が重要です。

チャレンジ2: Streamlitのrerunモデルと処方計算フォーム

何が難しかったか: Streamlitはウィジェット操作のたびにスクリプト全体を再実行します。「計算」ボタンクリック後に表示される処方計算フォーム(投与日数・投与回数)の値を変更すると、st.button("計算")がFalseに戻り、計算結果セクション全体が消失するバグが発生しました。

計算ボタン → 結果表示 + 処方フォーム表示
    ↓ 投与日数変更(rerun発生)
計算ボタン → False → 結果も処方フォームも消失

どう解決したか: 計算結果をst.session_stateに保存し、ボタンがFalse(rerun後)でも保存済み結果から再表示する方式にしました。

if st.button("計算", type="primary"):
    _do_calculate(species, weight, drug_name, drugs)
    # ↑ 内部でsession_stateに結果を保存
elif st.session_state.get("calc_gui_data") is not None:
    # rerun後もsession_stateから結果を再表示
    _show_saved_results()

学んだこと: Streamlitで「ボタンクリック後に表示されるフォーム」は高リスクパターンです。フォーム内のウィジェット操作がrerunを引き起こし、ボタンの条件分岐ごと消えます。st.session_stateによる結果保持は必須の対策です。

⚠️ このバグはGUIテスト中に発見しました。テスト計画段階で「ボタン内に描画される入力ウィジェットの変更」を洗い出しておくと事前に検出できます。

チャレンジ3: AI応答の用量フォーマット正規化

何が難しかったか: Gemini APIから返される用量文字列のフォーマットが統一されていません。"10-25mg/kg"、"10~25"、"25, 10-15"など、同じ意味の情報が多様な形式で返ります。そのままDBに登録すると用量計算が壊れます。

どう解決したか: 正規化関数を実装し、DB登録前に必ず通すようにしました。

def _normalize_dose_str(raw: str) -> str:
    s = re.sub(r"\s*(mg/kg|mg|kg)\s*$", "", s, flags=re.IGNORECASE)  # 単位除去
    s = s.replace("~", "-").replace("〜", "-").replace("~", "-")     # チルダ→ハイフン
    if "," in s:  # カンマ区切り(複数適応症混在)→ 全数値のmin-max
        nums = [float(m) for m in re.findall(r"[\d.]+", s)]
        return f"{min(nums):g}-{max(nums):g}" if nums else raw
    # ... ハイフン範囲、単一数値のパース

学んだこと: LLM応答を構造化データとして扱う場合、「パース→正規化→バリデーション」の3段階を設けると堅牢になります。正規化が行われた場合はGUI上で元の値と正規化後の値を両方表示し、ユーザーが確認できるようにしています。

制約と今後

現在の制約

  • ローカル実行前提(Streamlit Cloudへのデプロイには永続化対策が別途必要)
  • VT-004が同じマシンの同階層に存在する前提(複数候補パスで探索)
  • 薬剤提案(suggest)にはGemini APIキーが必要
  • 複数ユーザーの同時アクセスは想定外(YAMLファイルのロック機構なし)

今後の改善候補

  • VT-004のパッケージ化(pip install可能にしてsys.path追加を不要に)
  • Docker化によるワンコマンド起動
  • suggestのオフライン対応(ローカルLLMとの連携)

まとめ

CLI版の用量計算ツールをStreamlitでGUI化し、処方計算と単価管理機能を追加しました。コアロジックをそのままimportする構成により、開発コストを最小化しつつGUI固有の機能(処方計算、マスタ一括編集、単価管理)を追加できました。

Streamlitのrerunモデルは便利ですが、「ボタン内に生成されるフォーム」のような2段階UIではsession_stateによる状態保持が不可欠です。このパターンは獣医療ツールに限らず、Streamlitでフォーム入力→結果→追加入力のフローを作る際に広く適用できます。

リポジトリ

GitHub: https://github.com/Vookmarket/vet-dose-calc-gui


このツールの出力はAIによる参考情報を含みます。臨床判断は必ず獣医師が行ってください。


この記事は獣医師個人開発者による技術解説です。

動物病院で使えるAIツールを作成・公開しています。

2
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?