格子線と経緯線レイヤーの作成 (Make Grids and Graticules Layer) (カートグラフィ)—ArcMap

概要
使用法
構文
コードのサンプル
環境
ライセンス情報

概要

事前定義済みのカートグラフィック仕様に基づいて格子線フィーチャ、経緯線フィーチャ、および境界線フィーチャを描写し、フィーチャクラスのグループレイヤーを作成できます。グリッドレイヤーは、縮尺/範囲固有の高度なグリッド定義に適しています。

各グリッドレイヤーを構成する要素としては、マスクポリゴン、クリップポリゴン、セグメント (ライン)、グリッドライン (1 つまたは複数)、目盛 (ライン)、端点 (1 つまたは複数)、ポイント (1 つまたは複数)、アノテーションフィーチャクラスなどがあります。これらのコンポーネントは、対応するフィーチャクラスにフィーチャとして保存されます。これらのフィーチャクラスは、ジオデータベース内の指定されたフィーチャデータセット内に保存されます。グリッドの基本コンポーネントを格納するフィーチャクラスには、7 種類があります。各フィーチャクラスは、それぞれが保持する格子線コンポーネントを識別するのに便利な、3 文字の接頭辞で名前が付けられています。これらのフィーチャクラス / コンポーネントは以下のとおりです。

ANO_ はアノテーションフィーチャクラスです。
EPT_ は端点フィーチャクラスです。
GLN_ はグリッドラインフィーチャクラスです。
MSK_ はマスクフィーチャクラスです。
PNT_ はポイントフィーチャクラスです。
SEG_ はセグメントフィーチャクラスです。
TKS_ は目盛フィーチャクラスです。

これらのフィーチャクラスは、複数の格子線の情報を保持できます。8 番目のフィーチャクラス (GRD_) には、マップ名やグリッドタイプなどの体系的情報が格納されています。この情報は、グリッドを体系的に編成するために使用されます。

グリッド定義テンプレートは、事前定義済み XML ファイルに格納されます。このファイルには、各グリッドの仕様プロパティ (たとえば、グリッドラインの数、色、ラインウェイト) が格納されています。定義テンプレートを適用した場合、現在の範囲または選択されたフィーチャの範囲 (対象エリア)、縮尺および座標系に基づく仕様に従ってフィーチャが作成されます。

使用法

[格子線と経緯線レイヤーの作成 (Make Grids and Graticules Layer)] ツールは、投影マップを印刷またはエクスポートできるように設計されています。ユーザーがマップをナビゲートしたときに動的に更新される、グリッドまたは経緯線の作成には適していません。
作成するグリッドレイヤーの範囲を指定するには、対象エリアを入力する必要があります。フィーチャレイヤーを使用して対象エリアを定義している場合は、ポリゴンフィーチャクラスまたはポリゴンレイヤーである必要があります。
[グリッドテンプレート (XML ファイル)] パラメーターを定義した後、パラメーター名のすぐ左側にあるコンテキストセンシティブなエリアにカーソルを合わせるかクリックして、定義済み XML グリッド定義テンプレートのグリッドタイプ、説明、回転タイプ、および縮尺タイプ情報を表示します。
グリッドテンプレート XML ファイルには、プライマリの座標系および補助座標系の計測値や位置が記述されたグリッドコンポーネントが指定されます。指定されたすべての座標系の間で、共通の地理座標系を共有している必要があります。プライマリの座標系を、デフォルト以外の測地基準系を用いた座標系に変更したい場合 (たとえば、WGS 1984 を用いた座標系を、NAD 1983 を用いた座標系に変更する場合)、デフォルトの補助座標系をそれぞれ NAD 1983 に変更することも必要です。
グリッドテンプレート、対象エリア (AOI)、入力フィーチャデータセット、プライマリ座標系、および補助座標系のパラメーターは、同じ測地基準系 (たとえば、WGS 1984 や NAD 1983) を使用する必要があります。
グリッドテンプレート XML ファイルでは、最大 4 つの補助座標系に対するグリッドコンポーネントが作成されます。補助グリッドの数は XML ファイルで指定します。補助座標系の追加または削除はできませんが、デフォルト値を無効にすることはできます。
[プライマリの座標系] は投影座標系でなければなりません。
補助座標系は、投影座標系または地理座標系のどちらかです。
[入力フィーチャデータセット] の空間参照の地理座標系は、グリッドテンプレート XML ファイルで指定された空間参照と同じ地理座標系でなければなりません。
[任意のエリアを入力[フィーチャまたは範囲を指定]] の空間参照の地理座標系は、グリッドテンプレート XML ファイルで指定された空間参照と同じ地理座標系でなければなりません。
[グリッド設定を使用してデータフレームとレイアウトを構成] チェックボックスをオンにした状態で ArcMap から [格子線と経緯線レイヤーの作成 (Make Grids and Graticules Layer)] ツールにアクセスすると、作成されたグリッドに最も適合するようにレイアウト上のデータフレームが調整されます。データフレームの座標系、縮尺、回転角度、サイズ、範囲およびクリッピングは、XML グリッド仕様と一致するように変更できます。この設定は、ツールが ArcMap レイアウトビューから実行されており、バックグラウンドで実行されていない場合に限り有効になります。デフォルトでは、このチェックボックスがオフになります。オフの場合、データフレームプロパティが変更されません。
出力場所にすでに存在しているグリッド名を指定すると、既存のグリッドが上書きされます。
次のパラメーター値は、グリッドテンプレート XML から自動的に設定されます。
- 出力レイヤー
- 文字列値が付いた名前
- 基準縮尺
- 回転
- マスクサイズ
- XY 許容値
- プライマリ座標系
- 補助座標系
ただし、これらのデフォルト値はいずれも、新しい値が指定されると無効になります。

構文

arcpy.cartography.MakeGridsAndGraticulesLayer(in_template, in_aoi, input_feature_dataset, output_layer, {name}, {refscale}, {rotation}, {mask_size}, {xy_tolerance}, {primary_coordinate_system}, {configure_layout}, {ancillary_coordinate_system_1}, {ancillary_coordinate_system_2}, {ancillary_coordinate_system_3}, {ancillary_coordinate_system_4})

パラメーター	説明	データタイプ
in_template	XML グリッド定義テンプレートには、各グリッドレイヤーのグラフィックスプロパティの仕様が格納されています。この定義には、実行前は変更できないグラフィックスプロパティが設定されているだけでなく、パラメーターとして公開されていて実行前に変更できる特定のデフォルト値も設定されています。テンプレートファイルは GridTemplates ディレクトリに配置されます。その他のグリッドテンプレートは、ArcGIS Resource Center から別途に入手、共有することが可能です。 Production Mapping エクステンションには、新しいテンプレートの作成や既存のテンプレートの変更ができる、グリッドデザイナーも用意されています。	File
in_aoi	作成されたグリッドレイヤーの範囲を特定するために使用される、フィーチャレイヤーまたは x、y 範囲。フィーチャレイヤー - 対象エリアに使うレイヤーを選択できるように指定します。このレイヤーからフィーチャを 1 つだけ選択して使用できます。レイヤーに複数のフィーチャが含まれている場合は、最初のフィーチャをベースにしてグリッドレイヤーが作成されます。最初のフィーチャはオブジェクト ID に基づきます。それ以外のフィーチャはすべて、無視されます。範囲 - 次のいずれかを対象エリアとして使用できるように指定します。データフレームのデフォルトの対象エリア。以下の指定に一致 - 座標を直接に追加して範囲を指定した場合、追加した座標の空間参照は、(1) ArcMap の特化型データフレームから、(2) ArcMap が非アクティブのときは [カートグラフィの座標系] 環境設定から、(1) (2) の順番に導き出されます。表示領域に一致する対象領域 (AOI)。メモ: このツールで有効な範囲オプションは、[デフォルト]、[以下の指定に一致]、または [表示領域に一致] だけです。それ以外のオプションを選択すると、エラーが発生します。	Feature Layer; Extent
input_feature_dataset	フィーチャの格納先となるフィーチャデータセット。グリッド固有のフィーチャクラスがまだ存在しなければ、自動的に作成されます。そのようなフィーチャクラスがすでに存在している場合は、作成対象のグリッドと同じ名前およびタイプのグリッドも存在していて、上書きされます。メモ: 作成対象のグリッドと同じ名前およびタイプのグリッドは、ジオプロセシングの出力の上書き設定に関係なく常に上書きされます。	Feature Dataset
output_layer	グリッドフィーチャ、経緯線フィーチャ、および境界線フィーチャを描写する、フィーチャクラスのグループレイヤー。各グリッドレイヤーを構成する要素としては、マスクポリゴン、クリップポリゴン、セグメント (ライン)、グリッドライン (1 つまたは複数)、目盛 (ライン)、端点 (1 つまたは複数)、ポイント (1 つまたは複数)、アノテーションフィーチャクラスなどがあります。メモ: これはテンプレートレイヤーであり、ArcMap ドキュメント内に保存するか、またはレイヤーファイルとして保存する必要があります。	Group Layer
name (オプション)	作成されたカートグラフィックグリッドの名前。このグリッド名から、同じフィーチャデータセットおよびフィーチャクラスセットに格納されているグリッド同士を区別できます。カートグラフィックグリッド名の表記形式は、次のいずれかです。 String - グリッド名としてテキスト文字列を入力します。フィールド - フィーチャレイヤーからのフィールドを入力します。選択されたフィーチャのフィールドの値は、グリッドを指定する場合に使用されます。AOI フィールド名が使用可能になるのは、[対象エリア] パラメーターがフィーチャレイヤーとして定義されている場合です。グリッド名に次の特殊文字を含めることはできません。 ' " ~ \ / \| # @ $ % ^ & * ( )	String; Field
refscale (オプション)	グリッドを作成、表示するための基準として用いる縮尺。XML グリッド定義ファイルから参照される基準縮尺が、[環境の使用] と定義されている場合、次の順に基準縮尺が導き出されます。ジオプロセシングの [基準縮尺] 環境設定アクティブデータフレームの基準縮尺アクティブデータフレームの縮尺 XML グリッド定義ファイルからの値	Double
rotation (オプション)	グリッドコンポーネントの回転角度。回転によって、アノテーションをページと等しい高さに配置できます。指定しない場合、回転角度の計算に対象エリアのフィーチャが使用されます。XML グリッド定義ファイルから参照される回転タイプが [環境の使用] と定義されている場合、回転角度は次の順に導き出されます。アクティブデータフレームの回転角度 XML グリッド定義ファイルからの値	Double
mask_size (オプション)	マスクは、図郭線の範囲の周囲に外部リングを形成するポリゴンフィーチャであり、座標ラベル用に確保された領域に収まるデータをマスクする際に用いられます。マスクサイズは、ポリゴンマスクフィーチャの幅をマップ単位またはページ単位で定義します。必要に応じて、座標ラベルを含めたサイズがマスクエッジの周囲に収まりきるように、データフレームを変更してください。	Linear Unit
xy_tolerance (オプション)	距離単位で表される、ジオデータベースフィーチャ間の最小許容距離。この値は、XML 内に設定されている値からデフォルト設定されます。座標の精度が低いデータには高い値を設定し、極めて精度の高いデータには低い値を設定できます。設定済みの XY 許容値内にあるフィーチャは、一致すると見なされます。	Linear Unit
primary_coordinate_system (オプション)	グリッドテンプレート XML ファイルによって、プライマリの座標系および最大 4 つのまでの補助座標系の座標や位置が記述された、グリッドコンポーネントが作成されます。補助グリッドの数はファイルで指定します。補助座標系の追加または削除はできません。指定されたすべての座標系の間で、共通の地理座標系を共有している必要があります。プライマリの座標系を、デフォルト以外の測地基準系を用いた座標系に変更したい場合 (たとえば、WGS 1984 を用いた座標系を、NAD 1983 を用いた座標系に変更する場合)、デフォルトの補助座標系をそれぞれ NAD 1983 に変更することも必要です。これは、作成対象のグリッドレイヤーのプライマリの座標系です。通常、最終製品またはデータフレームの座標系になります。この座標系は投影座標系である必要があります。 XML グリッド定義ファイルのプライマリ座標系が、[環境の使用] と定義されている場合、次の順にプライマリ座標系が導き出されます。ジオプロセシングカートグラフィ座標系の環境設定投影座標系の場合、アクティブなデータフレームの座標系 XML グリッド定義ファイルからの値どの場合においても、ユーザー入力は最優先されます。	Spatial Reference
configure_layout (オプション)	データフレーム設定値をグリッドレイヤーと一致するように調整します。データフレームの座標系、縮尺、回転、サイズ、範囲およびクリッピングは、整合性が確保されるように変更できます。この設定は、ツールが ArcMap レイアウトビューから実行されており、バックグラウンドで実行されていない場合に限り有効になります。 CONFIGURELAYOUT —グリッド設定を使用してデータフレームとレイアウトを構成するように指定します。 NO_CONFIGURELAYOUT —データフレームとレイアウトを構成しないように指定します。これがデフォルトです。	Boolean
ancillary_coordinate_system_1 (オプション)	グリッドテンプレート XML ファイルによって、プライマリの座標系および最大 4 つのまでの補助座標系の座標や位置が記述された、グリッドコンポーネントが作成されます。補助グリッドの数はファイルで指定します。補助座標系の追加または削除はできません。指定されたすべての座標系の間で、共通の地理座標系を共有している必要があります。プライマリの座標系を、デフォルト以外の測地基準系を用いた座標系に変更したい場合 (たとえば、WGS 1984 を用いた座標系を、NAD 1983 を用いた座標系に変更する場合)、デフォルトの補助座標系をそれぞれ NAD 1983 に変更することも必要です。これは最初の補助座標系です。	Spatial Reference
ancillary_coordinate_system_2 (オプション)	グリッドテンプレート XML ファイルによって、プライマリの座標系および最大 4 つのまでの補助座標系の座標や位置が記述された、グリッドコンポーネントが作成されます。補助グリッドの数はファイルで指定します。補助座標系の追加または削除はできません。指定されたすべての座標系の間で、共通の地理座標系を共有している必要があります。プライマリの座標系を、デフォルト以外の測地基準系を用いた座標系に変更したい場合 (たとえば、WGS 1984 を用いた座標系を、NAD 1983 を用いた座標系に変更する場合)、デフォルトの補助座標系をそれぞれ NAD 1983 に変更することも必要です。これは 2 番目の補助座標系です。	Spatial Reference
ancillary_coordinate_system_3 (オプション)	グリッドテンプレート XML ファイルによって、プライマリの座標系および最大 4 つのまでの補助座標系の座標や位置が記述された、グリッドコンポーネントが作成されます。補助グリッドの数はファイルで指定します。補助座標系の追加または削除はできません。指定されたすべての座標系の間で、共通の地理座標系を共有している必要があります。プライマリの座標系を、デフォルト以外の測地基準系を用いた座標系に変更したい場合 (たとえば、WGS 1984 を用いた座標系を、NAD 1983 を用いた座標系に変更する場合)、デフォルトの補助座標系をそれぞれ NAD 1983 に変更することも必要です。これは 3 番目の補助座標系です。	Spatial Reference
ancillary_coordinate_system_4 (オプション)	グリッドテンプレート XML ファイルによって、プライマリの座標系および最大 4 つのまでの補助座標系の座標や位置が記述された、グリッドコンポーネントが作成されます。補助グリッドの数はファイルで指定します。補助座標系の追加または削除はできません。指定されたすべての座標系の間で、共通の地理座標系を共有している必要があります。プライマリの座標系を、デフォルト以外の測地基準系を用いた座標系に変更したい場合 (たとえば、WGS 1984 を用いた座標系を、NAD 1983 を用いた座標系に変更する場合)、デフォルトの補助座標系をそれぞれ NAD 1983 に変更することも必要です。これは 4 番目の補助座標系です。	Spatial Reference

コードのサンプル

MakeGridsAndGraticulesLayer (格子線と経緯線レイヤーの作成) ツールの例 1 (スタンドアロンスクリプト)

このスタンドアロンスクリプトは、MakeGridsAndGraticulesLayer (格子線と経緯線レイヤーの作成) ツールを使用してカートグラフィックグリッドを作成する例を示しています。

# Name: MakeGridsAndGraticulesLayer.py
# Description: Create grid for a selected area of interest in a file
# geodatabase
# Import system module
import arcpy
import os
# Create a feature layer from the input area of interest feature class
# to pass to the Selection geoprocess below 
arcpy.MakeFeatureLayer_management("C:/Base_Data/AOIs.gdb/QUAD_24K",
                                  "QUAD_24K")
# Select a feature from the area of interest feature layer based on a
# definition query (this query, formatted for a file geodatabase, has
# been adjusted for use in python, in particular the use of \ in
# conjunction with the double quotes surrounding the field name in the
# definition query)
arcpy.SelectLayerByAttribute_management("QUAD_24K", "NEW_SELECTION",
                                        "\"MSNAME\" = 'Swift Minnesota'")
# Set the values of the tool's parameters using one of the grid
# definition XML files located under the GridTemplates directory
template = os.path.join(arcpy.GetInstallInfo()['InstallDir'], 
                        "GridTemplates/Quad_24K_NAD83.xml")
in_aoi = "QUAD_24K"
input_feature_dataset = "C:/Python_Output/grid_layers.gdb/QUAD_24K"
output_layer = "QUAD_24K_NAD83_Grid"
name = "MSNAME"
# Process: Make Grids and Graticules Layer
arcpy.MakeGridsAndGraticulesLayer_cartography(template, in_aoi,
                                              input_feature_dataset,
                                              output_layer, name)

環境

カートグラフィの座標系
メモ:
XML グリッド定義ファイルが [環境の使用] と定義されている場合、[プライマリの座標系] パラメーターと [補助座標系] パラメーターにはこの設定値が使用されます。
基準縮尺
メモ:
XML グリッド定義ファイルが [環境の使用] と定義されている場合、[基準縮尺] パラメーターにはこの設定値が使用されます。
出力データのコンフィグレーションキーワード
出力に M 値がある
出力に Z 値がある

ライセンス情報

Basic: いいえ
Standard: はい
Advanced: はい

概要

使用法

構文

コードのサンプル

MakeGridsAndGraticulesLayer (格子線と経緯線レイヤーの作成) ツールの例 1 (スタンドアロン スクリプト)

環境

ライセンス情報

関連トピック

MakeGridsAndGraticulesLayer (格子線と経緯線レイヤーの作成) ツールの例 1 (スタンドアロンスクリプト)