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

ライセンス レベル:BasicStandardAdvanced

サマリ

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

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

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

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

使用法

構文

MakeGridsAndGraticulesLayer_cartography (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 グリッド定義テンプレートには、各グリッド レイヤのグラフィックス プロパティの仕様が格納されています。この定義には、実行前は変更できないグラフィックス プロパティが設定されているだけでなく、パラメータとして公開されていて実行前に変更できる特定のデフォルト値も設定されています。

テンプレート ファイルは \ArcGIS\Desktop10.1\GridTemplates ディレクトリに配置されます。その他のグリッド テンプレートは、ArcGIS Resource Center から別途に入手、共有することが可能です。

Esri Production Mapping エクステンションには、新しいテンプレートの作成や既存のテンプレートの変更ができる、グリッド デザイナが用意されています。

File
in_aoi

作成されたグリッド レイヤの範囲を特定するために使用される、フィーチャ レイヤまたは x、y 範囲。

  • フィーチャ レイヤ - 対象エリアに使うレイヤを選択できるように、指定します。このレイヤからフィーチャを 1 つだけ選択して使用できます。レイヤに複数のフィーチャが含まれている場合は、最初のフィーチャをベースにしてグリッド レイヤが作成されます。最初のフィーチャはオブジェクト ID をベースにします。それ以外のフィーチャはすべて無視されます。
  • 範囲 - 次のいずれかを対象エリアとして使用できるように、指定します。
    • データ フレームのデフォルトの対象エリア。
    • 以下の指定に一致 - 座標を直接追加することにより範囲を指定する場合、座標の空間参照は次の順に取得されます。(1)ArcMap 上で現在フォーカスのあるデータ フレーム (2)ArcMap がアクティブでなければ「カートグラフィの座標系」の環境設定。
    • 表示領域に一致する対象領域(AOI)。

注意注意:

このツールで有効な範囲オプションは、[デフォルト]、[以下の指定に一致]、または [表示領域に一致] だけです。それ以外のオプションを選択すると、エラーが発生します。

Feature Layer; Extent
input_feature_dataset

フィーチャの格納先となるフィーチャ データセット。グリッド固有のフィーチャクラスがまだ存在しなければ、自動的に作成されます。そのようなフィーチャクラスがすでに存在している場合は、作成対象のグリッドと同じ名前およびタイプのグリッドも存在していて、上書きされます。

注意注意:

作成対象のグリッドと同じ名前およびタイプのグリッドは、ジオプロセシングの出力の上書き設定に関係なく常に上書きされます。

Feature Dataset
output_layer

グリッド フィーチャ、経緯線フィーチャ、および境界線フィーチャを描写する、フィーチャクラスのグループ レイヤ。各グリッド レイヤを構成する要素としては、マスク ポリゴン、クリップ ポリゴン、セグメント(ライン)、グリッドライン(1 つまたは複数)、目盛(ライン)、端点(1 つまたは複数)、ポイント(1 つまたは複数)、アノテーション フィーチャクラスなどがあります。

注意注意:

これはテンプレート レイヤであり、ArcMap ドキュメント内に保存するか、またはレイヤ ファイルとして保存する必要があります。

Group Layer
name
(オプション)

作成されたカートグラフィック グリッドの名前。このグリッド名から、同じフィーチャ データセットおよびフィーチャクラス セットに格納されているグリッド同士を区別できます。カートグラフィック グリッド名の表記形式は、次のいずれかです。

  • String - グリッド名としてテキスト文字列を入力します。
  • フィールド - フィーチャ レイヤからのフィールドを入力します。選択されたフィーチャのフィールドの値は、グリッドを指定する場合に使用されます。対象エリア フィールド名が使用可能になるのは、[対象エリア] パラメータがフィーチャ レイヤとして定義されている場合です。

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
(オプション)

データ フレーム設定値をグリッド レイヤと一致するように調整します。データ フレームの座標系、縮尺、回転角度、サイズ、範囲およびクリッピングは、整合性が確保されるように変更できます。[グリッド設定を使用してデータ フレームとレイアウトを構成します] チェックボックスのオン/オフが可能になるのは、[格子線と経緯線レイヤの作成(Make Grids and Graticules Layer)] ツールが 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(格子線と経緯線レイヤの作成)ツールの例(スタンドアロン Python スクリプト)

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

# Name: MakeGridsAndGraticulesLayer.py
# Description: Create grid for a selected area of interest in a file
# geodatabase

# Import system module
import arcpy

# Enabling logging of the results
arcpy.logHistory = True

# Enable background geoprocessing 
# arcpy.Command("force_run_in_background yes")  #uncomment this to run the
# GP tool in the background

# Set overwrite outputs of geoprocessing operations to true
arcpy.gp.overwriteOutput = 1

# 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
t = "C:/Program Files/ArcGIS/Desktop10.1/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 (the '#' indicates use
# default values)
arcpy.MakeGridsAndGraticulesLayer_cartography(t, in_aoi,
                                              input_feature_dataset,
                                              output_layer, name, "#", "#",
                                              "#", "#", "#")

環境

カートグラフィの座標系

XML グリッド定義ファイルが [環境の使用] と定義されている場合、[プライマリの座標系] パラメータと [補助座標系] パラメータにはこの設定値が使用されます。

基準縮尺

XML グリッド定義ファイルが [環境の使用] と定義されている場合、[基準縮尺] パラメータにはこの設定値が使用されます。

関連トピック

ライセンス情報

ArcGIS for Desktop Basic: ×
ArcGIS for Desktop Standard: ○
ArcGIS for Desktop Advanced: ○
9/14/2013