プログラマーでない人のための ArcPy トラブルシューティングガイド

AndrewOrtego

<\/HEAD>私の名前はAndrewです--Drewと呼んでください--私はEsri Support Servicesのデスクトップサポートアナリストです。もしPythonの問題について私たちに電話したことがあれば、おそらく私と話したことがあるでしょう！Pythonスクリプトのトラブルシューティングについて話す人々から多くの好意的なフィードバックをいただいており、私がよく伝える人気のアドバイスを共有したいと思います。初めてコードを学ぶ方でも、ArcPyサイトパッケージを使い始めたばかりの方でも、これらのヒントとコツはスクリプトを軌道に戻し、完成に近づけるのに役立つはずです。

サポートでは多くの異なるPython関連の問い合わせを受けるため、最も一般的な6つのリクエストを以下のシナリオにまとめました。これらのシナリオを使って、現在の問題にどのワークフローが適用されるか判断してください。1. Pythonを初めて使い始めるところで、どこから学べばよいかわからない場合。<\/STRONG>

ラッキーです！私はこの問題について約1年前にブログを書きました！そのブログには誰でもPythonでコードを学べるチュートリアルや、多くの無料オンラインリソースへのリンクが含まれています--これらのリソースは学習スタイル別に整理されているので、誰にでも合うものがあります。PythonとArcPyを学び始める7つの簡単な方法<\/A>2. スクリプトが次のエラーメッセージを返す場合：「ImportError: No module named arcpy」。<\/STRONG>

これはEsri SupportがArcPyトラブルシューティングで最も頻繁に遭遇する問題です。このエラーメッセージはArcPyサイトパッケージが正しくインストールされていない場合に発生しますが、とても簡単に修正できます。このエラーを引き起こす原因はいくつかあり、それらが絡み合うこともあるため、この種の問題をトラブルシューティングする際はナレッジベース記事43846「問題：arcpyをインポートできない」<\/A>を参照することをお勧めします。

もしその記事で解決しない場合は、アクセスしているディレクトリへの完全な読み取りまたは書き込み権限がない可能性があるかどうかITチームに相談することをお勧めします。リモートマシンで作業している場合は、ArcGIS for Desktopがインストールされているマシン上で直接トラブルシューティングを試みてください。3. 作成したスクリプトがWindows Task Scheduler以外では動作する場合。<\/STRONG>

EsriはWindows Task Scheduler（WTS）を作成していないため、この問題はEsri Supportでトラブルシューティングするには難しいものです。しかし、ナレッジベース記事「Windows Task SchedulerがPythonスクリプトを実行しない」<\/A>は、問題がWTS、Pythonインストール、またはスクリプト自体にあるかどうか確認する手助けになります。4. スクリプト作成を始めたい、または始めたけれど進めなくなっている場合。<\/STRONG>

この場合、目標はあるけれどPythonなしで動作させることもできるのでコードを書く必要があります。どこから始めればよいでしょう？最も重要なステップは望ましい結果を明確に持つことです。目標があれば問題を論理的なステップに分解できます。

例えば、一つのフィーチャーを別のフィーチャーでクリップするスクリプトを書きたいとします。まずArcMapで試してください。データは期待通りの結果を出していますか？このワークフローが必要だと確信していますか？そうならば、Clipツールのドキュメントとそれに対応するPython構文を確認しましょう。この情報はArcGIS for Desktopヘルプページで便利に見つけられます：Clipツールリファレンス<\/A>

構文セクションではジオプロセシングツールに関連付けられたArcPy関数名や、その関数を正しく動作させるために必要なパラメーター（およびオプションパラメーター）が示されています。データ型には注意してください--時々厄介なことがあります！

コードサンプルセクションは例から学ぶことが好きな人には非常に役立ちますので、コーディング開始前にぜひご覧ください；構文セクションよりも関数の使い方がよくわかるかもしれません。5. スクリプトが期待通りの結果を出さず、またはArcPy関数に問題があると思われる場合。<\/STRONG>

この問題はよく見かけますが、私は必ず解決できる方法を考え出しました。以下のステップで問題の原因について詳しく知ることができるでしょう。a.<\/STRONG> エラーメッセージが出ている場合でも出ていない場合でも、問題となっているコード部分だけを切り出すことがおすすめです。「最小限テスト可能なケース」を示すスクリプトを作成してください。b. <\/STRONG>2000行ものスクリプト全体よりも単一のArcPy関数だけをトラブルシューティングする方がずっと簡単です。その疑わしい関数だけ別ファイル（.py）に入れて、小さなテストデータも作成し、その関数から期待通りの出力が得られるか確認しましょう。c.<\/STRONG> 必要なら他のコードも追加してください。ただし、このテストの目的は大きなスクリプト内で問題となっている1行まで絞り込むことです。どんな問題も単純化できますし、一歩引いて考えることでデバッグ時間を大幅に節約できます。6. コードが動作せず、自分でPythonを使って問題箇所を特定できそうな場合。<\/STRONG>

ここではスクリプトトラブルシューティング向けのもう少し高度なヒントをご紹介します：a.<\/STRONG> ArcMapやArcCatalog Pythonコンソール内外で関数テストしてください。これは統合開発環境（IDE）がArcGIS for Desktopと共にインストールされたPython.exeファイルへ正しくアクセスしているかどうか示します。ArcMapやArcCatalogは常にArcPy関数を実行できるべきです。これらプログラムでArcPy関数が実行できない場合は再インストールが必要かもしれません。b.<\/STRONG> 異なるデータで関数テストしてください。これは問題がデータ固有かどうか示します。c.<\/STRONG> 使用中のArcGIS for Desktopバージョン固有のオンラインドキュメントも確認してください。新しいリリースごとにArcPyサイトパッケージには更新があり、ArcPy関数の挙動も変わります。d.<\/STRONG> 関数記述がおかしいと思ったら、その関数をArcMapやArcCatalogで実行し、「ジオプロセシング結果」ウィンドウからそのジオプロセシングツールのPython版コマンドをWindowsクリップボードへコピーしてください。それをお気に入りIDEへ貼り付け、自分のコードとEsri製Pythonスニペットと比較しましょう。それはあなたのコードより少し複雑かもしれませんが、この比較から問題箇所へのヒントが得られる可能性があります。

お役に立てば幸いです！コーディングは技術であり、ときには本当に混乱することもあります。我慢強く取り組めば、これらすべてのトラブルシューティング手順が各スクリプト作成セッションに自然と組み込まれるようになります。他者による解決策をインターネット検索することも恐れず、もちろんメンテナンス契約中ならEsri Supportにもお気軽にご連絡ください。幸運と楽しいコーディングライフを！Andrew O. - デスクトップサポートアナリスト<\/EM>



<\/BODY><\/HTML>

AndresCastillo

Thank you!