ディープラーニング用の ArcGIS Pro の設定

ArcGIS Pro ディープラーニングツールは、バックグラウンドで Python ディープラーニングライブラリを使用します。ライブラリをインストールして、インストールが成功したことを確認します。

ディープラーニングライブラリのインストール

最初に、ディープラーニングライブラリをダウンロードして、インストールします。 ArcGIS Pro のバージョンとディープラーニングライブラリのバージョンが一致している必要があります (例: どちらも 3.4)。 3 つのケースがあります。

初めてディープラーニングライブラリをインストールする場合は、このセクションで説明するステップに従ってください。
過去にディープラーニングライブラリをインストールしており、ArcGIS Pro 3.4 (またはそれ以降) に更新しようとしている場合は、このセクションで説明するステップに従ってください。
過去にディープラーニングライブラリをインストールしており、古いバージョンの ArcGIS Pro (3.3 またはそれ以前) に更新しようとしている場合は、詳細な手順について、このチュートリアルの後半にある「古いバージョンの ArcGIS Pro のライブラリをすでにインストールしている場合の更新」セクションをご参照ください。このオプションは最も推奨度が低くなります。

以下のステップでは、バージョン 3.4 での手順を示します。

ArcGIS Pro アプリケーションが終了していることを確認します。
[Deep Learning Libraries Installers for ArcGIS] ページに移動します。
[Download] の下の [Deep Learning Libraries Installer for ArcGIS Pro 3.4] をクリックします。
注意:
以前のリリースの ArcGIS Pro を使用している場合、[Downloads for previous versions] をクリックして対応するライブラリを見つけることができます。

[ArcGIS_Pro_34_Deep_Learning_Libraries.zip] 圧縮フォルダーがコンピューターにダウンロードされます。
Microsoft File Explorer で、[Downloads] フォルダーに移動して、[ArcGIS_Pro_34_Deep_Learning_Libraries.zip] ファイルを見つけます。
[ArcGIS_Pro_34_Deep_Learning_Libraries.zip] を右クリックして、コンピューター上のフォルダーに展開します。
これを行うには、[すべて展開] メニューオプションまたは他のアーカイブ抽出アプリケーション ([7-Zip] など) を選択します。
展開した [ArcGIS_Pro_34_Deep_Learning_Libraries] フォルダーを開きます。
注意:
展開したフォルダーではなく圧縮された .zip ファイル内から [ProDeepLearning.msi] インストーラーパッケージを実行すると、インストールプロセスは失敗します。
[ProDeepLearning.msi] Windows インストーラーパッケージをダブルクリックしてディープラーニングライブラリをインストールします。
注意:
ファイル拡張子が表示されていない場合、[表示] タブの [表示/非表示] セクションで拡張子を表示できます。

インストーラーウィンドウが表示されます。
インストーラーウィンドウで [次へ] を 2 回クリックします。
[マスター契約書に同意する] をクリックし、[次へ] をクリックします。
[インストール] をクリックします。
[このアプリがデバイスに変更を加えることを許可しますか] というメッセージが表示されたら、[はい] をクリックします。
ディープラーニングライブラリがコンピューターにインストールされます。
注意:
インストールが完了するまで数分かかる場合があります。
インストールが完了したら、[終了] をクリックします。

インストールが成功したことを確認

ディープラーニングライブラリをインストールした後は、ArcGIS Pro を開き、インストールが成功したことを確認します。

ArcGIS Pro を起動します。サインインを求められたら、ライセンスが割り当てられた ArcGIS 組織アカウントを使用してサインインします。
注意:
ArcGIS Pro へのアクセス権限または組織アカウントがない場合は、ソフトウェアアクセスのオプションをご参照ください。
[設定] をクリックします。
[パッケージマネージャー] をクリックします。
[インストール済みパッケージ] セクションで、インストールしたパッケージを確認できます。これらは解析を実行するときにバックグラウンドで使用されます。
注意:
ArcGIS Pro 向けに別の Python 環境をすでに作成している場合は、最初にデフォルトの [arcgispro-py3] 環境に切り替える必要があります。ディープラーニングライブラリは [arcgispro-py3] に自動的にインストールされます。
[インストール済みパッケージ] セクションで、検索ボックスに「deep」と入力し、[deep-learning-essentials] パッケージが結果にリストされていることを確認します。
これは ArcGIS Pro でディープラーニングトレーニングと推測を実行するために必要なパッケージの 1 つです。

ディープラーニングライブラリをインストールし、ArcGIS Pro でインストールを確認しました。これで、ディープラーニングの Learn ArcGIS チュートリアルまたは ArcGIS Pro のその他のディープラーニングワークフローで提供されるディープラーニング解析を実行する準備ができました。

ディープラーニングツールを実行するとコンピューターのシステム構成によって、問題が発生する場合があります。その場合は、作業を一時停止し、詳細について、このチュートリアルの次のパート「一般的な問題のトラブルシューティング」をご参照ください。

ArcGIS Pro のディープラーニングツールでは、CPU または GPU プロセッサのどちらを使用するかの選択が示されることがあります。お使いのコンピューターで使用可能なオプションが不明な場合は、「GPU の利用可能性の確認」セクションを確認してください。

一般的な問題のトラブルシューティング (オプション)

前に行ったディープラーニングライブラリのインストールは、ArcGIS Pro でのディープラーニングを準備する最も重要な手順であり、通常必要なのはこの手順だけです。ただし、場合によっては、コンピューターシステムが適切に構成され、ディープラーニングワークフローの実行時に正常に機能するように、追加の手順を実行する必要がある場合があります。詳細について知りたい場合、または ArcGIS Pro でディープラーニングツールの実行中に問題が発生している場合は、次のヒントを確認してください。

GPU の利用可能性の確認

ArcGIS Pro でディープラーニングツールを実行する際は、コンピューターの標準プロセッサーである CPU (中央処理装置) ではなく、コンピューターの GPU (グラフィックス処理装置) を使用して実行することをお勧めします。ディープラーニング手法では、多くの処理能力が要求されます。GPU は複数の同時計算を実行できるため、よく適合しています。ただし、すべての GPU がディープラーニングに対応しているわけではありません。具体的には、ディープラーニングライブラリは、NVIDIA GPU プラットフォームを想定しています。このセクションでは、コンピューターに適切な GPU が搭載されているかどうかを確認する方法について説明します。

注意:

コンピューターに搭載されているのが CPU だけの場合、(「ディープラーニング事前トレーニング済みモデルを使用したオブジェクトの検出」チュートリアルで示すような) シンプルなディープラーニングワークフローに使用することはできますが、処理時間が長くなります。

コンピューターに NVIDIA GPU 機能が搭載されているかどうかを確認するには、次の手順を実行します。

Windows タスクバーで、[検索] ボタンをクリックします。
検索ボックスに「タスクマネージャー」と入力して、Enter キーを押します。
[タスクマネージャー] ウィンドウで、[パフォーマンス] タブをクリックします。
パフォーマンスインジケーターのリストで、[NVIDIA] タイプの [GPU] オプションを探します。
- [NVIDIA GPU] がリストされている場合は、[GPU] モードで ArcGIS Pro ディープラーニングツールを実行でき、高速なパフォーマンスが得られます。
- [NVIDIA GPU] の記述がない場合、その機能はお使いのコンピューターに搭載されていません。選択を求められた場合は、[CPU] モードで ArcGIS ディープラーニングツールを実行する必要があります。
- コンピューターに 2 つの GPU (1 つは NVIDIA、もう 1 つは NVIDIA 以外) が搭載されている場合があります。 GPU モードでディープラーニングツールを実行すると、ArcGIS Pro は NVIDIA GPU を自動的に選択し、もう 1 つの GPU を無視します。
例では、NVIDIA GPU を含む 2 つの GPU を搭載しているコンピューターを示しています。
注意:
詳細については、GPU の確認方法とそれが重要である理由をご参照ください。
古いコンピューターの場合、ディープラーニングライブラリでは機能しない NVIDIA GPU が搭載されている場合があります。 NVIDIA GPU 計算機能の詳細をご参照ください。

NVIDIA GPU の能力を計測する主なインジケーターは、専用メモリの容量です。 4 ～ 8 GB の専用メモリ (推論だけを実行する場合は 4 GB、最初からディープラーニングモデルをトレーニングする場合は 8 GB) をお勧めします。ここで、NVIDIA GPU の仕様を確認します。
[NVIDIA GPU] インジケーターをクリックして、その GPU に関する詳細情報を表示します。
[専用 GPU メモリ] インジケーターを見つけます。
- 2 番目の数字は、使用可能な専用メモリの総容量を示します (次の画像例では [8 GB])。
- 最初の数字は、現在使用されている専用メモリの容量を示します (画像例では [1.9 GB])。
[専用 GPU メモリ使用量] グラフを見つけます。
このグラフは、専用 GPU メモリ使用量をリアルタイムで示します。 ArcGIS Pro でディープラーニングツールを実行すると、このグラフ上で使用量が急に上がるのがわかります。
提供された残りの情報を調べます。
次の仕様が特に重要です。
- GPU モデルの名前 (次の画像例では [NVIDIA Quadro RTX 4000])。
- [ドライバーのバージョン] (ここでは [31.0.15.3598])。
- [ドライバーの日付] (ここでは [5/24/2023])。

GPU ドライバーが最新の状態でないために問題が発生した場合、この情報は極めて重要です。この状況については、次のセクション「NVIDIA ドライバーの更新」で説明します。

NVIDIA ドライバーの更新

古い GPU ドライバーはディープラーニングツールが失敗する原因となります。この問題が発生した場合に、GPU ドライバーを更新する方法について説明します。

ArcGIS Pro アプリケーションが終了していることを確認します。
NVIDIA GPU のモデルとドライバーのバージョンに関する情報を収集していることを確認します (このチュートリアルの前の「GPU の利用可能性の確認」セクションを参照)。
NVIDIA の「Download Drivers」ページに移動します。
[NVIDIA Driver Downloads] セクションで、お使いの GPU に対応するオプションを選択します。この例では、GPU モデルは [NVIDIA Quadro RTX 4000] です。
注意:
[Operating System] では、ご利用のコンピューターの [設定] を開いて [About your PC] を検索すると、関連情報を見つけられます。
[Download Type] では、基本的に [Production Branch/Studio] を選択します。
[Search] をクリックし、[Download] をクリックし、[Agree & Download] をクリックします。
ドライバーのインストーラーファイルがコンピューターにダウンロードされます。
コンピューター上で、インストーラーファイルを見つけて実行します (通常は [ダウンロード] フォルダー)。
システムに対する変更を許可するため [はい] をクリックし、[OK] をクリックしてインストーラーを実行します。
[NVIDIA インストーラー] ウィンドウで、[Agree and Continue] をクリックし、デフォルトのインストールオプションをそのまま使用し、[Next] をクリックします。
インストールが完了したら、[Close] をクリックします。

これで、GPU ドライバーは最新になりました。

古いバージョンの ArcGIS Pro のライブラリをすでにインストールしている場合の更新

正常に動作させるには、ディープラーニングライブラリのバージョンが ArcGIS Pro のバージョンと一致している必要があります (例: どちらも 3.4)。過去に古いバージョンの ArcGIS Pro のディープラーニングライブラリをインストールしていて、新しいバージョンに更新したい場合は、2 つのケースがあります。

ArcGIS Pro 3.4 (またはそれ以降) に更新しようとしている場合は、本チュートリアルの「ディープラーニングライブラリのインストール」セクションと「インストールが成功したことを確認」セクションで説明するステップに従ってください。このオプションを強くおすすめします。
古いバージョンの ArcGIS Pro (3.3 またはそれ以前) を更新しようとしている場合は、以下のステップに従ってください。エラーを引き起こす可能性のあるバージョンの不一致を回避するため、コンポーネントのアンインストールおよび再インストールを特定の順序で行う必要があります。

ArcGIS Pro 3.3 またはそれ以前に更新しようとしている場合は、最初に、コンピューターに現在インストールされているディープラーニングライブラリのバージョンを確認して、状況をよく把握します。

Windows タスクバーで、[検索] をクリックします。
検索ボックスに「Add or remove programs」と入力して、Enter キーを押します。
[Add or remove programs on your computer] ウィンドウが表示されます。
検索ボックスに「deep」と入力します。
結果のリストで、[Deep Learning Libraries for ArcGIS Pro] をクリックします。
ライブラリのバージョン番号が表示されます。
最初の 2 桁 (この場合、3.2) は、バージョンを示しています。これらのライブラリは、ArcGIS Pro 3.2 で機能するようになっています。目的が ArcGIS Pro とディープラーニングライブラリを次のバージョン (例: 3.3) にアップグレードすることであれば、一番安全な方法はどちらもアンインストールしてから再度インストールすることです。このプロセスについては、3.2 から 3.3 へのアップグレードを例に、この後の手順で説明します。
注意:
ArcGIS Pro 3.3 にすでにアップグレード済みで、ディープラーニングライブラリがまだバージョン 3.2 の場合、一番安全な方法は上記と同じく ArcGIS Pro とディープラーニングライブラリの両方をアンインストールしてから再度インストールすることです。
ArcGIS Pro もディープラーニングライブラリもすでに目的のバージョン (例: 3.3) にアップデート済みにもかかわらずディープラーニングツールを実行するとエラーが発生する場合は、以前のバージョンを最初にアンインストールしなかった可能性があります。その場合、以下の手順に従って、クリーンな再インストールを行ってください。
まず、ライブラリをアンインストールします。
[Add or remove programs on your computer] ウィンドウの [Deep Learning Libraries for ArcGIS Pro] で [アンインストール] をクリックし、画面に表示される指示に従ってアンインストールプロセスを完了します。
今度は ArcGIS Pro をアンインストールします。
[Add or remove programs on your computer] ウィンドウで [ArcGIS Pro] を検索して、[Uninstall] をクリックします。画面に表示される指示に従って、アンインストールプロセスを完了します。
[Add or remove programs on your computer] ウィンドウを閉じます。
次に、クリーンアップをいくつか行います。
Windows エクスプローラーで C:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3 に移動するか、または同等のインストール場所に移動して、まだ残っているすべてのファイルを直接削除します。
これらのファイルは、以前に変更を加えた環境からそのまま残っていたファイルの可能性があります。
ArcGIS Pro 3.3 をインストールします。
注意:
ArcGIS Pro のインストールへの進み方がわからない場合は、システム管理者にお問い合わせください。一般的な方法としては、自分の認証情報で ArcGIS Online にログインして設定に移動し、[ライセンス] をクリックしたら [ArcGIS Pro] の横にある [ArcGIS Pro のダウンロード] をクリックします。次に、ダウンロードしたインストーラーファイルを確認し、ダブルクリックしてインストールを開始します。
本チュートリアルの「ディープラーニングライブラリのインストール」セクションと「インストールが成功したことを確認」セクションの手順を参考に、Deep Learning Libraries for ArcGIS Pro 3.3 をインストールします。

これで、ArcGIS Pro でディープラーニング解析を実行する準備ができました。

ディープラーニングライブラリを含む環境の管理

ArcGIS Pro では、Python はデフォルトで [arcgispro-py3] という Python 環境内で実行されます。場合によっては、個別の環境を作成して、異なる Python ライブラリをインストールしていることもあります。ディープラーニングライブラリインストーラーでは、ライブラリはデフォルトの [arcgispro-py3] 環境に常にインストールされます。 [arcgispro-py3] 以外の環境に切り替えた場合、ディープラーニングツールを使用する前に、[arcgispro-py3] に戻す必要があります。これを行うには、次の手順を実行します。

ArcGIS Pro を起動します。
[設定] をクリックします。
[パッケージマネージャー] をクリックします。
[アクティブな環境] で、環境名が選択されていることを確認します。
次の画像例では、現在のアクティブな環境は [myenv] で、これはユーザーが作成したカスタム Python 環境です。
代わりにデフォルトの環境をアクティブ化します。
ドロップダウン矢印をクリックし、[arcgispro-py3] を選択します。

デフォルトの Python 環境 [arcgispro-py3] がアクティブ化されました。この場所に、ディープラーニングライブラリがインストールされました。これで ArcGIS Pro ディープラーニングツールを正常に使用できるようになりました。

ディープラーニングライブラリを含むまたは含まないデフォルトの環境のクローン作成

ディープラーニングライブラリを含む ArcGIS Pro クローン環境を作成するには、ライブラリをインストールした後にデフォルトの arcgispro-py3 環境のクローンを作成します。ディープラーニングライブラリが新しい環境に含まれます。

別の Python ライブラリをインストールしようとして一部のパッケージの競合が見つかった場合など、その他のいくつかのケースで、ディープラーニングライブラリを含んでいない環境が必要になることがあります。このような環境を作成するには、次の手順の説明に従って、Python コマンドプロンプトを使用します。

ArcGIS Pro を終了します。
Windows タスクバーで、[検索] ボタンをクリックします。
検索ボックスに「Python Command Prompt」と入力して Enter キーを押します。
[Python コマンドプロンプト] ウィンドウで、次の Conda コマンドを入力します。
conda create -n myenv arcpy=3.2
この例では、「myenv」は作成する新しい環境の名前、「3.2」は ArcPy パッケージのバージョンです。これは、コンピューターにインストールされている ArcGIS Pro のバージョンに一致します (この場合 ArcGIS Pro 3.2)。
注意:
[myenv] を任意の名前に置き換えることができます。
Enter キーを押します。
コマンドが実行されます。
[Proceed ([y]/n)] と表示されたら、「y」を入力して Enter キーを押します。
注意:
プロセスの終了には時間がかかる場合があります。
プロセスが完了したら、ArcGIS Pro を起動します。
[設定] をクリックします。
[パッケージマネージャー] をクリックします。
[アクティブな環境] で、環境名が選択されていることを確認します。
次の画像例では、デフォルトの環境 [arcgispro-py3] が現在アクティブになっています。
作成した環境をアクティブ化します。
ドロップダウン矢印をクリックし、[myenv] (またはカスタム環境用に選択した別の名前) を選択します。
新しい環境で使用する他の (ディープラーニング以外の) パッケージをインストールするには、[パッケージの追加] タブを使用します。
注意:
詳細については、「パッケージマネージャー」およびパッケージの追加方法をご参照ください。

これで、新しいカスタム Python 環境がアクティブになりました。ディープラーニングライブラリは含まれていませんが、必要な他の (ディープラーニング以外の) Python パッケージが含まれています。

メモリの問題

ArcGIS Pro でディープラーニングツールを実行すると、専用 GPU メモリが不足して失敗することがあります。これは一般的に、選択した [バッチサイズ] 値が GPU に対して大きすぎるためです。これを解決するには、[バッチサイズ] 値を減らし (たとえば、[4] から [2] または [1])、ツールをもう一度実行します。

問題の報告と質問

ArcGIS Pro のディープラーニングに関する問題を報告したり質問をしたりする方法は複数あります。

ディープラーニングライブラリのインストール中に予期しない動作が生じた場合は、ディープラーニングフレームワークの GitHub リポジトリに問題を報告できます。
Esri Community の ArcGIS Image Analyst セクションで ArcGIS Pro のディープラーニングツールの使用に関する質問を投稿できます。また、「deep learning」タグを追加して、「ArcGIS Pro Questions」セクションにこれらの質問を投稿することもできます。
ディープラーニングツールは完全にサポートされているため、サポートケースを開くこともできます。

参考資料

このチュートリアルで提供されたトピックの詳細は、次の参考資料をご参照ください。

このチュートリアルでは、ArcGIS Pro でのディープラーニングの準備方法について学習しました。 Python ディープラーニングライブラリを設定し、インストールに成功したことを確認しました。また、コンピューターの設定を確認する方法と発生する可能性がある一般的な問題をトラブルシューティングする方法についても学習しました。これで、ArcGIS Pro でディープラーニングワークフローを実行する準備が整いました。

他のチュートリアルについては、チュートリアルギャラリーをご覧ください。

ディープラーニング用の ArcGIS Pro の設定 ArcGIS Pro ディープラーニングツールを実行するために必要な Python ライブラリをインストールし、インストールに成功したことを確認します。	15 分
一般的な問題のトラブルシューティング (オプション) コンピューターの設定を確認する方法と、コンピューター上でのディープラーニングツールの実行に関連する一般的な問題をトラブルシューティングする方法について学習します。	30 分

ディープラーニング用の ArcGIS Pro の設定

一般的な問題のトラブルシューティング (オプション)

ディープラーニングライブラリのインストール

注意:

注意:

注意:

注意:

インストールが成功したことを確認

注意:

注意:

GPU の利用可能性の確認

注意:

注意:

NVIDIA ドライバーの更新

注意:

古いバージョンの ArcGIS Pro のライブラリをすでにインストールしている場合の更新

注意:

注意:

ディープラーニングライブラリを含む環境の管理

ディープラーニングライブラリを含むまたは含まないデフォルトの環境のクローン作成

注意:

注意:

注意:

メモリの問題

問題の報告と質問

参考資料

Deep Learning Using ArcGIS Pro

Classifying Object Using Deep Learning in ArcGIS Pro

ArcGIS: ディープラーニングの概要

要件

Outline

ディープ ラーニング用の ArcGIS Pro の設定

一般的な問題のトラブルシューティング (オプション)

ディープ ラーニング用の ArcGIS Pro の設定

ディープ ラーニング ライブラリのインストール

注意:

注意:

注意:

注意:

インストールが成功したことを確認

注意:

注意:

一般的な問題のトラブルシューティング (オプション)

GPU の利用可能性の確認

注意:

注意:

NVIDIA ドライバーの更新

注意:

古いバージョンの ArcGIS Pro のライブラリをすでにインストールしている場合の更新

注意:

注意:

ディープ ラーニング ライブラリを含む環境の管理

ディープ ラーニング ライブラリを含むまたは含まないデフォルトの環境のクローン作成

注意:

注意:

注意:

メモリの問題

問題の報告と質問

参考資料

使用許諾

フィードバックを送信

このチュートリアルの共有と再利用

詳細​

関連する Esri トレーニング

Deep Learning Using ArcGIS Pro

Classifying Object Using Deep Learning in ArcGIS Pro

ArcGIS: ディープ ラーニングの概要

ディープラーニング用の ArcGIS Pro の設定

ディープラーニング用の ArcGIS Pro の設定

ディープラーニングライブラリのインストール

ディープラーニングライブラリを含む環境の管理

ディープラーニングライブラリを含むまたは含まないデフォルトの環境のクローン作成

詳細

ArcGIS: ディープラーニングの概要