トラブルシューティング

インストール

通常、アップデートのインストールでは以前のバージョンのアンインストールは必要ありませんが、問題が発生した場合は、Imatest をアンインストールして再インストールすることをお勧めします。アンインストーラーは、スタート メニュー (スタート、すべてのプログラム、Imatest、アンインストール) またはコントロール パネルの[プログラムの追加と削除] からアクセスできます。アンインストーラーでは、Matlab ランタイム ライブラリ アーカイブ (バージョン 3.6 より前のバージョンではImatest-lib.exe ) を保持するか削除するかを選択できます (保持がデフォルトです。削除するには、チェックボックスをオンにする必要があります)。保持しておくと、再インストールが速くなります。Imatest を再インストールする予定がない場合、または破損している可能性があると疑われる場合 (まれなケース) にのみ削除してください。インストール手順の詳細については、こちらをクリックしてください。

Imatest 3.6+ の重要な変更点

Imatestの最新バージョンは64ビットコンピュータでのみ動作します。Matlabのバージョン履歴はWikipediaに記載されていますが、一部欠落している箇所があります。

Imatest バージョン 3.6 以降では、旧バージョンの R13 コンパイラ (バージョン 3.0.1) に代わり、新しい Matlab コンパイラ (バージョン 4.11 以降) が使用されています。新しいコンパイラでは、約 200MB のMatlab Compiler Runtime (MCR) (一種の仮想マシン) という、より大規模なライブラリのダウンロードが必要です。Imatestは通常 32 ビット アプリケーションとしてコンパイルされ、32 ビットおよび 64 ビットのコンピュータで動作します。(64 ビット アプリケーションはパフォーマンス上の利点はほとんどなく、32 ビット コンピュータでは動作しません。)

インストールが完了したら、

• MCR は、32 ビット システムでは %ProgramFiles%\MATLAB\MATLAB Compiler Runtime\v714 (Imatest 3.7 以降の場合。3.6 の場合は ...V711) に、64 ビット システムでは %ProgramFiles(x86)%\MATLAB\MATLAB Compiler Runtime\v714 (または ...V711) に配置されます (英語の Win64 インストールでは %ProgramFiles(x86)% は C:Program Files (x86) です)。
• Imatest は、32 ビット システムでは %ProgramFiles%\Imatest\Imatest にあります (英語の Win32 インストールでは %ProgramFiles は C:\Program Files です)。64 ビット システムでは %ProgramFiles(x86)%\Imatest\Imatest にあります (英語の Win64 インストールでは %ProgramFiles(x86) は C:\Program Files (x86) です)。

新しいライブラリ（V7111、V714など）を使用してImatest 3.6以降を初めてインストールする場合は、 「コンポーネントの選択」ウィンドウで「Matlabライブラリ」がチェックされていることを確認してください。ライブラリのインストールには数分かかります。お使いのバージョンに適したMCRがインストールされたら、 Imatestをアップデートする際にこのチェックボックスをオンにする必要はありません。

MCRをインストールする前にImatestを実行しようとすると、次のメッセージが表示される場合があります。Matlabライブラリのチェックボックスをオンにして再インストールすると、問題は解決します。

mclmcrrt714.dll が見つからなかったため、このアプリケーションは起動できませんでした。

インストール中に問題が発生しました

インストールまたは登録が失敗する可能性がある場合

• お使いのコンピューターには管理者権限がありません。管理者権限がない場合、次のようなメッセージが表示されることがあります。
  書き込み用のファイルを開く際にエラーが発生しました C:\Program files(x86)\Imatest\Master\imatest.exe
  書き込み用のファイルを開く際にエラーが発生しました。C:\Program files (x86)\Imatest\Master\dcraw.exe など。
• お使いのコンピューターは、強力な企業ファイアウォールの内側にあります。

バージョン3.6以前：このメッセージは、ファイアウォールが強力なシステムで時折表示されます。通常は、ダウンロードページから入手できるMatlabランタイムライブラリ「Imatest-lib.exe」がImatestのインストールファイルと同じフォルダにあることを確認することで解決できます。場合によっては、ファイアウォールを一時的に無効にして、ライブラリファイルを手動でダウンロードする必要があるかもしれません。
強力なファイアウォールが原因で発生した別のエラーメッセージを以下に示します。お客様は自宅からダウンロードした際には問題なく動作していました。解決策：オフィス外でImatestをダウンロードし、CDまたはUSBメモリをオフィスに持参してください。

「DNS エラー」の表示が出た場合 (非常にまれです)、 [スタート] 、[ファイル名を指定して実行]をクリックし、 [開く]ボックスにipconfig /flushdnsと入力して、 [OK ] をクリックしてください。

インストール後に発生する問題

エラー: MCR のバージョン mn が見つかりませんでした。

このエラーは、MCR (Matlab Compiler Runtime、つまりライブラリ) のインストール失敗、またはImatestを実行するバッチファイル内のパスの問題が原因である可能性があります。これは、 Imatest 3.7 および 3.8 の初期ビルドで発生する可能性が最も高いです。

• このバージョンのImatest を初めてインストールした際に、Matlab ライブラリが正しくインストールされませんでした。コンポーネントの選択ウィンドウでMatlab ライブラリにチェックを入れて、 Imatest を再インストールする必要があります (通常は最初のインストール時に一度だけ実行すれば十分です)。この方法でもうまくいかなかった顧客が MCR (ライブラリ) フォルダ (場所については下記およびこちらを参照) を削除し、この手順を繰り返したところ、正常に動作しました。
• MCRのインストール時に、システムに保留中のWindowsアップデートがありました。インストールを再度実行する前に、すべてのアップデートが完了していることを確認してください。
• Imatest が、別のバージョンの Matlab がインストールされているシステムにインストールされています。（これはまれにしか問題になりません。）ご使用のバージョンの Imatest を実行するために使用するフォルダ内のバッチファイル (run_imatest.bat と run_diagnostics.bat) を確認し、パスが正しい MCR の場所を指していることを確認してください。

一般的な64ビット版Windows 7（英語版）の場合、 ImatestのインストールフォルダはC:\Program Files (x86)\Imatest\Masterです。このフォルダは、 Imatestのバージョン、オペレーティングシステム、言語によって異なる場合があります。ご使用のシステムでフォルダの場所をご確認ください。

パスは、 Imatestインストールフォルダ内のファイル run_imatest.bat (または run_diagnostics.bat) で設定されています。変更を保存するには、管理者権限でファイルを開く必要があります。パス情報を含む重要な行 (私のシステムの場合) は次のとおりです。

@path="C:Program Files (x86)\Imatest\Master_3.8;C:Program Files (x86)\Imatest\Master_3.8bin; C:Program Files (x86)\MATLAB\MATLAB Compiler Runtime\v714runtimewin32 ; C:Program Files (x86\)MATLAB\MATLAB Compiler Runtime\v714 ;%path%"

この行で強調表示されている項目は、Matlab Compiler Runtime (MCR) フォルダーです。これらのフォルダーの内容を確認してください。フォルダーC:\Program Files (x86)\MATLAB\MATLAB Compiler Runtime\v714 (またはシステム上の同等のフォルダー) がこの行にない場合 (Imatest 3.8 より前のバージョンでのみ発生する問題)、追加する必要があります。

3.6: 「mclmcrrt711.dll が見つからなかったため、このアプリケーションは起動できませんでした」のようなメッセージが表示された場合は、 Matlab ランタイムライブラリ (MCR) を含むフルバージョンをダウンロードしてインストールする必要があります。Imatest 3.6では、この操作は一度だけ行えば済みます。ダウンロードとインストールにはそれぞれ数分かかる場合があります。アップグレード版のダウンロードとインストールははるかに高速です。

3.6+: mllapack.dll プロシージャが見つかりません( mllapack.dll La procédure spécifiée est introuvable en Français) Imatest は正常に起動しますが、このメッセージがボックスに表示されて終了します。この問題は 2 回発生しました。原因を特定するのは容易ではありませんでした。ある顧客に対しては有効だった (ただし、多少の手間がかかった) 解決策が、 この Google の投稿の最後とこの Matlab Central の投稿で見つかりました。

「予想通り、エラーの原因はDLLのバージョン問題でした。古いバージョンの「libmmd.dll」がwindows/system32ディレクトリに存在していました。MATLABランタイムのbin/win32ディレクトリに含まれているバージョンは使用されていませんでした。古いバージョンを削除したところ、問題は解決しました。なぜそこに存在していたのか、またvcredistのインストール時にwindowsディレクトリで更新されない理由はまだ解明できていません。本当に面倒です。」

もしこれがうまくいかない場合は、もう一つ試してみる価値のあるアドバイスがあります。 このMATLABの投稿には、「クラッシュはMATLABとCPUの互換性の問題が原因です。これは、プロセッサがSSE2命令セットをサポートしていない場合（例えば、Athlon XP 2200+ CPUなど）に発生する可能性があります。」と書かれています。この問題は、2003年以降に製造されたコンピュータでは発生しないはずです。

3.6 以前:最も一般的なインストール問題は、Matlab ランタイム ライブラリImatest-lib.exeのダウンロードまたはインストールが正しく行われないことです。その結果、次のようなエラー メッセージが表示されます。

「プロシージャのエントリポイントがダイナミックリンクライブラリ….dll内で見つかりませんでした。」

このようなメッセージが表示された場合は、 Imatest-lib.exeファイルが正しくダウンロードされているか確認してください。また、ファイアウォールの状態も確認してください。強力なファイアウォールがこの問題の原因となっている場合があります。

• インストール中に自動的にダウンロードされた場合は、Imatest のインストールフォルダ（一般的な Win32 英語版のインストールでは C:\Program files\Imatest\Imatest）にコピーが存在するはずです。
• 手動でダウンロードした場合（ファイアウォールのあるシステムでは通常必要です）、Imatestインストーラープログラムと同じフォルダにコピー（Imatest- xx.exe ）が存在するはずです。

Windows XPのエクスプローラーではファイルサイズが8,513KBと表示されますが、ファイル名にカーソルを合わせると表示されるツールチップでは8.31MBと表示されます（不思議ですね）。ダウンロードが失敗した場合は、より小さいサイズが表示されることがあります。

Imatest-lib.exe が見つからない場合、またはダウンロードが正しく行われなかったと思われる場合は、ここまたはこのセクションのいずれかのリンクを右クリックしてダウンロードし、Imatestを再インストールしてください。Imatest-lib.exe は自己解凍型の zip ファイルで、Matlab ランタイム ライブラリを Imatest インストール フォルダーのサブフォルダー binwin32 および toolbox\matlab に配置します。問題が解決しない場合は、これらのフォルダーにファイルが格納されていることを確認し、DOS ウィンドウに表示されるエラー メッセージ（存在する場合）を添えてImatest サポートにメールを送信してください。

• Imatest 3.1以降では、4つのファイルはImatestのインストールフォルダとサブフォルダの両方にインストールされます。これらのファイルが見つからない場合は、サブフォルダ（toolbox\matlab\iofun\private、英語版インストールの場合はC:\Program Files\Imatest\toolbox\matlab\iofun\private）にコピーしてください。
• 以前のバージョンについては、 jpegdlls.zipをダウンロードして、その内容をサブフォルダにコピーしてください。

実行時エラー

画像ファイルが読み取れません。

Matlabは、標準以外のヘッダーを持つ画像ファイルや、ファイル拡張子が間違っている（例えば、PNGファイルなのにBMPになっているなど）といったその他の不具合のある画像ファイルを読み込めないことがよくあります。このようなファイルは市販のカメラではまれですが、プロトタイプや開発システムでは発生する可能性があります。Irfanviewを使えば、多くの場合、これらのファイルを「修正」できます。IrfanviewはIrfanview.comから無料でダウンロードできます。非常に便利なユーティリティです。ファイルをIrfanviewに読み込み、保存してください。（元のファイルを保持する必要がある場合は、別のファイル名を使用できます。）

地域選択を行った後、Imatestが動作を停止する（フリーズまたはクラッシュする）。

この問題は、Youdao Dictionaryなどの自動翻訳ソフトウェアが原因である可能性があります。

解決：

ROI選択中は、翻訳ソフトウェアを一時的に無効にしてください。この問題に関する詳細は、「領域選択バグの回避策」をご覧ください。

Imatestがクラッシュするか、期待どおりに動作しない

この場合、通常は最小化されているコマンド（DOS）ウィンドウに、デバッグに役立つエラーメッセージが表示されることがあります。その内容を表示するには、

• Imatestコマンドウィンドウのアイコンをクリックします。 タスクバーに。
• 「ファイル」 → 「現在のセッションを表示」をクリックすると、セッションの内容がエディタ（通常はメモ帳）で開きます。また、 「ファイル」 → 「現在のセッションをコピー」をクリックして、任意のエディタに貼り付けるか、 Imatestサポートに問い合わせることもできます。
• Imatest が完全にクラッシュして終了した場合は、再起動してから、 [ファイル] 、 [表示] (または[コピー] ) 、[最後のセッション]をクリックします。

ほとんどの問題は、以下のカテゴリーに分類されます。

1. バグが見つかりました。多くのバグは、最新バージョンのImatestをダウンロードしてインストールすることで修正できます。それでも解決しない場合は、上記のコマンドウィンドウの内容、必要に応じてINIファイルとイメージを添えて、ヘルプセンターに問題を報告してください。詳細はこちらをご覧ください。
2. 保存された設定を保存するファイルであるImatest-v2.ini ( Imatest 4.2より前のバージョンでは imatest.ini) が破損し、読み取れなくなりました。説明と修正方法については、下記の「破損した INI ファイル」を参照してください。
3. 以前は正常に動作していたモジュールが動作しなくなりました。これは多くの場合、Imatest-v2.ini ファイルの該当モジュールに対応するセクションに誤ったエントリがあることが原因です。詳しくは、「以前は正常に動作していたモジュールが動作しなくなりました（下記）」を参照してください。

Imatest 3.7+ではimatest-v2.iniの正確な場所を知る必要はありません。Imatestには、その場所を特定、編集、保存、読み込むためのユーティリティ一式が備わっているからです。正確な場所は次のとおりです。

$APPDATA$\Imatest\imatest-v2.ini

ここで、$APPDATA$ は、Windows Vista/7 (英語) の C:Users user_name\ AppData\Roaming に相当する環境変数です。英語の Vista/7-10 における imatest-v2.ini の完全なパス名は、C:Users\ user_name\ AppData\Roaming\Imatest\imatest.ini です。他のオペレーティングシステムや言語では、名前が異なる場合があります。

以前は正常に動作していたモジュールが動作しなくなりました

これは多くの場合、imatest-v2.ini（ Imatest 4.2より前のバージョンでは imatest.ini、rescharts.ini、または multicharts.ini）内のモジュールのセクションを削除することで解決できます。

INIファイル設定、 INIファイルエディタの順にクリックして、下図に示すINIファイルエディタを開きます。注：Imatestを再インストールしても、この種の問題が解決することはほとんどありません。

iniファイルエディタは、ini（設定）ファイルを編集するための非常に強力なツールです。
壊れた（ただし以前は動作していた）モジュールは、次のセクションを選択することで修復できる場合が多いです。
モジュールに対応して、セクションの削除をクリックし、保存をクリックします。

セクションドロップダウンメニュー（上部付近）から、表示または削除するセクションを選択できます。個々の行を編集するには、大きなウィンドウでその行を選択し、大きなウィンドウのすぐ上にある編集ウィンドウで変更を加えてから、Enter キーを押します。選択範囲全体を削除するには、[セクションの削除] キーを押します。変更を保存する準備ができたら、 [保存]キーを押します（変更が反映されるまではグレー表示されています）。変更をキャンセルする場合は、 [ini ファイルの再読み込み]キーまたは[閉じる]キーを押します。

エラー処理と報告

問題が解決しない場合は、 Imatestサポートにメールを送信してください。送信方法の詳細は、ユーティリティメニューの「エラー報告」をご覧ください。

• エラーメッセージを含めてください。通常、コマンド（DOS）ウィンドウに表示されます。（明らかに無関係な部分は編集で削除できます。）コマンドウィンドウの内容を取得するには、
  • ファイルをクリックし、現在のセッションをコピーして、 Imatest ヘルプセンターで作成した問題に貼り付けます。
  • Imatestが完全にクラッシュして終了した場合は、再起動してから、 [ファイル] 、 [最後のセッションのコピー]をクリックします。
  • 旧バージョンの場合は、Imatestコマンドウィンドウのアイコンをクリックしてください。 タスクバーに表示されます。内容のコピー方法については、下の灰色の枠内をご覧ください。

• お使いのオペレーティングシステムを教えてください（ Imatest 3.9以降では、コマンド（DOS）ウィンドウに含まれています）。
• 問題の診断に役立つ情報が含まれている可能性があるため、 imatest.ini ( Imatest 4.2より前のバージョンでは multicharts.ini または rescharts.ini) の内容を含めてください。Imatest 3.6以降では、 [INI ファイル設定] 、 [設定のコピー (ini ファイル)] をクリックすると、内容を直接クリップボードにコピーできます。 [INI ファイル設定] 、[設定の表示 (ini ファイル)]をクリックすると、テキストエディタ (通常はメモ帳) で内容を表示できます。
• エラーによって Imatest コマンド ウィンドウが閉じない限り、実際の ini ファイルのフォルダの場所を知る必要はありません。一般的な英語バージョンの Windows Vista/7 では、 C:\Users\ your name\ AppData\Roamingにあります。[ini ファイルは %AppData%\Imatest にあります。ここで %AppData% はコマンド環境変数であり、コマンド ウィンドウでdir "%AppData%"と入力するとファイル名を確認できます。]
• 画像に問題があると思われる場合（一部の画像は正常に表示され、一部は表示されない場合など）、その画像を問題報告に添付してください。

診断実行

Imatest エラーで DOS ウィンドウが閉じてしまう場合 (これはまれになっています)、または追加の診断結果が問題の特定に役立つ可能性がある場合、

• Imatestフォルダ（一般的なwin32英語インストールではC:\Program files\Imatest\Imatest）からDiagnosticsをダブルクリックしてImatestを実行します。 （またはdiagnostics.bat）。これにより、Imatestが終了した後もDOSウィンドウが開いたままになり、エラーメッセージを確認できます。
• 上記のエラー報告手順に従って、エラーメッセージをImatestサポートにメールで送信してください。

場合によっては、imatest-v2.ini を削除する（または名前を変更する。記録が残るため、名前を変更する方が良い）ことで問題を解決できます。手順はこちらをご覧ください。

他のバージョンのMATLABがインストールされている場合、パスの競合が発生します。

お使いのシステムに、 Imatest (6.5.1) で使用されているバージョンとは異なるバージョンのMatlab がインストールされている場合、パスの競合が発生し、同様のエラー メッセージが表示されるか、 Imatest が実行に失敗する可能性がごくわずかにあります。Imatestを起動するバッチ ファイルでパスが設定されるため、このような問題はめったに発生しません。パスの問題とその解決策については、 Imatest IT EXE の説明書を参照してください。

バグとか色々

バージョン3.6以前：データを保存しようとすると、DOSウィンドウに以下のメッセージが複数回表示されます。

関数「get_param」はスタンドアロンモードでは実装されていません。

これは保存された画像には影響せず、DOSウィンドウがバックグラウンドで表示されるため、ほとんど目立ちません。Matlabはこの問題について、今後のリリースで修正予定であることをこちらで説明しています。

詳細なドキュメント

Imatestの各モジュールに関する手順は、Imatestドキュメントページに記載されています。