目次

2. インストール

■ 安全上の注意
本プログラムの使用によって生じた損害について作者は一切の責任を負いません。
mojila.exeを最初に起動する前に必ずウイルスチェックを行ってください。
mojila.exeは Microsoft Visual Studio を用いてダウンロードしたソースコード(C#)から作成することができます。
C#とPythonのソースコードを確認してからご使用ください。

2.1 ダウンロード

ファイル(mojila.zip) をダウンロードして、 適当なフォルダに展開してください。以下のファイルから成ります。

  1. mojila.exe : 古文書解読プログラム用GUI
  2. mojila.dll : 同上dll
  3. mojila.pdb : 同上debug用ファイル
  4. mojila.deps.json : 同上設定ファイル
  5. mojila.runtimeconfig.json : 同上設定ファイル
  6. mojila.py : 推論プログラム
  7. myCNN.py : 自作CNNプログラム
  8. labels.py : 各データセットのラベル
  9. WinRT.Runtime.dll : ランタイムライブラリー（Microsoft製）
  10. vcs/ : GUIソースコード（C#, プログラム実行には不要）
  11. image_EMNIST/ : 英数字の画像を保存するフォルダ（サンプル1個あり）
  12. image_K49/ : ひらがなの画像を保存するフォルダ（サンプル1個あり）
  13. image_KKanji/ : 漢字の画像を保存するフォルダ（サンプル1個あり）
  14. image_TKanji/ : 漢字+かなの画像を保存するフォルダ（サンプル2個あり）
  15. image_CIFAR10/ : CIFAR-10の画像を保存するフォルダ（サンプル1個あり）
  16. image_CIFAR100/ : CIFAR-100の画像を保存するフォルダ（サンプル1個あり）
  17. image_Flowers102/ : 花の画像を保存するフォルダ（サンプル1個あり）
  18. image_doc/ : 古文書の画像と文字データを保存するフォルダ（サンプル1組あり）

2.2 パラメーターファイル

本プログラムmojila.exeは実行時にパラメーターファイルが必要です。
パラメーターファイルは自分で作ることができますが、 予め作成したものを使用するには下記をダウンロードしてmojila.exeと同じフォルダに保存してください。
バージョンアップ時にパラメーターファイルの仕様が変わることがあります。 そのときは再度下記のファイルをダウンロードしてください。

■ パラメーターファイルを自分で作る方法
[1]の学習プログラムを実行するとパラメーターファイルが出力されます。
パラメーターファイル名の先頭に"_"を付けてください。 （例えばEMNISTのときはEMNIST.pthを_EMNIST.pthにする）

2.3 Pythonのインストール

コマンドプロンプトでPythonが動く環境が必要です。
以下の方法でPythonと関連ツールをインストールしてください。

(1) Python
スタートメニューから"Microsoft Store"を起動し、検索ウィンドウに"Python"と入力してください。
適当なバージョンのPythonをクリックして[入手]をクリックしてください。（所要時間数秒）

(2) NumPy
スタートメニューから"ターミナル"を起動し、以下のコマンドを実行してください。
$ pip install numpy （所要時間数秒）

(3) PyTorch
PyTorchのページ[2]を開き、図2-1のように環境を適当に選択してください。
"Run this Command:"に表示されるコマンドをクリップボードにコピーして(Ctrl+C)、 ターミナルに貼り付けて(Ctrl+V)実行してください。（所要時間数分）

図2-1 PyTorchのインストール

■ バージョンについて
PythonとPyTorchは別々に開発されており、 他の最新のバージョンで動作保証しているとは限りません。
バージョンの不整合で動かないときは、 ひとつ前のバージョンをインストールすると動くことがあります。
「Python 3.12 + PyTorch 2.4.1または2.5.0」の組み合わせで動くことは確認しています。
「Python 3.13 + PyTorch 2.4.1または2.5.0」の組み合わせは動かないことは確認しています。

2.4 .NETのインストール

最初にmojila.exeを起動したときに以下のメッセージが出ることがあります。
そのときは"Download it now"をクリックして.NETの最新版をインストールしてください。

図2-2 .NETのインストール

2.5 事前準備

CIFAR-10またはCIFAR-100の画像の分類にはResNetを使用しています。
事前にコマンドプロンプトで mojila.exe のあるフォルダに移動し、 以下のコマンドを実行してください。
$ python mojila.py CIFAR10 image_CIFAR10/犬.png
ResNetのパラメータファイルがダウンロードされてディスクキャッシュに保存されます。

2.6 GPUを使用する方法

GPUを使用すると推論の時間が短縮されます。
GPUを使用する方法は以下の通りです。

  1. NVIDIAのGPUが実装されている
  2. CUDA[3]がインストールされている
  3. PyTorchをインストールするとき、"Compute Platform"で"cpu"ではなく"cuda"を選択する
  4. GUIの[ツール]→[設定]メニューで[GPUを使用する]をONにする

2.7 GUIプログラムをビルドする方法

GUIプログラムmojila.exeをソースコードからビルドする方法は以下の通りです。
ただし、Microsoft Visual Studio がインストールされており Microsoft Visual Studio に習熟しているものとします。

  1. エクスプローラーでvcsフォルダのmojila.slnをダブルクリックすると Microsoft Visual Studio が起動しソースコードが開かれます。
  2. ツールバーの"mojila"の右の▼をクリックして"mojilaのデバッグプロパティ"をクリックし、 [作業ディレクトリ]の[参照]でmojila.exeのあるフォルダを指定します。
  3. ビルドします。