概要
矩形ポリゴン フィーチャのグリッドを作成します。このグリッドは、空間マップ シリーズでページを指定するためのインデックスとして使用できます。グリッドは、別のフィーチャ レイヤーと交差するポリゴン フィーチャだけを含むように作成できます。
使用法
出力フィーチャクラスの座標系は以下の順に決定されます。
- 座標系が出力座標系環境で指定されている場合、その出力フィーチャクラスはこの座標系を使用します。
- 座標系が出力座標系環境で指定されていない場合、出力フィーチャクラスはアクティブなマップまたはマップ フレームの座標系を使用します。
- 座標系が出力座標系環境で指定されておらず、アクティブなマップも存在しない (ArcGIS Pro が開いていない) 場合、出力フィーチャクラスは最初の入力フィーチャの座標系を使用します。
- 座標系が出力座標系環境で指定されておらず、アクティブなマップが存在せず (ArcGIS Pro が開いていない)、入力フィーチャも指定されていない場合、出力フィーチャクラスの座標系は不明になります。
[入力フィーチャ] パラメーターには、ポイント、ライン、ポリゴン、またはラスターを指定できます。
[ページ単位と縮尺の使用] パラメーターを使用する場合、[縮尺] パラメーターが必要です。
ツール ダイアログ ボックスを使用していて、[ポリゴン グリッドの原点座標] パラメーターが指定されていた場合、ポリゴンの幅または高さの値を変更すると、行数と列数が自動的に変更されます。行と列は、フィーチャクラス範囲のグリッドの原点座標に基づいて自動的に算出されます。範囲全体が増加する方法で原点の X、Y 座標が変更された場合は、それに応じて行数と列数が更新されます。範囲全体が減少する方法で変更された場合は、その変更内容が無視され、フィーチャの全体表示が使用されます。
[入力フィーチャ] パラメーターを追加すると、[ポリゴン グリッドの原点座標] パラメーター値が自動的に計算されます。
[ページ単位と縮尺の使用] がオンになっている場合、[ポリゴンの幅] と [ポリゴンの高さ] の単位は、アクティブなマップ フレームで設定されているページ単位と一致するように自動的に変更されます。ArcGIS Pro セッションの外部でツールを使用している場合、この単位はインチにデフォルト設定されます。メートルやマイルなどのマップ単位を指定することも可能ですが、ページに適した単位を使用します。
[ページ単位と縮尺の使用] がオンになっている場合、マップの縮尺はデフォルトで、ページ レイアウト上のアクティブなマップ フレームの縮尺値に設定されます。ArcGIS Pro セッションの外部でツールを使用している場合、この縮尺は 1 にデフォルト設定されます。
最良の結果を得るには、すべての入力フィーチャ レイヤーおよびフィーチャクラスをマップまたはマップ フレームと同じ座標系に配置する必要があります。また、ArcGIS Pro セッションの外部でツールを使用している場合は、すべての入力フィーチャ レイヤーおよびフィーチャクラスをリスト内の先頭の入力フィーチャ レイヤーおよびフィーチャクラスと同じ座標系に配置する必要があります。
構文
arcpy.cartography.GridIndexFeatures(out_feature_class, {in_features}, {intersect_feature}, {use_page_unit}, {scale}, {polygon_width}, {polygon_height}, {origin_coord}, {number_rows}, {number_columns}, {starting_page_number}, {label_from_origin})| パラメーター | 説明 | データ タイプ |
out_feature_class | ポリゴン インデックス フィーチャの結果として出力されるフィーチャクラス。 出力フィーチャクラスの座標系は以下の順に決定されます。
| Feature Class |
in_features [in_features,...] (オプション) | 作成対象のポリゴン グリッドの範囲の定義に使用する入力フィーチャ。 | Feature Layer; Raster Layer |
intersect_feature (オプション) | 出力のグリッド フィーチャクラスを、入力フィーチャ レイヤーまたはデータセットと交差する領域に制限します。入力フィーチャの交差部が、インデックス フィーチャの作成に使用されます。
| Boolean |
use_page_unit (オプション) | インデックス ポリゴン サイズの入力をページ単位に含めるかどうかを指定します。
| Boolean |
scale (オプション) | マップ縮尺。インデックス ポリゴンの高さと幅をページ単位で計算する予定がある場合は、縮尺を指定する必要があります。アクティブな ArcGIS Pro セッションの外部でツールを使用している場合、デフォルトの縮尺値は 1 です。 | Long |
polygon_width (オプション) | マップ単位またはページ単位のどちらかで指定されたインデックス ポリゴンの幅。ページ単位を使用した場合、デフォルト値は 1 インチです。マップ単位を使用した場合、デフォルト値は 1 度です。 | Linear Unit |
polygon_height (オプション) | マップ単位またはページ単位のどちらかで指定されたインデックス ポリゴンの高さ。ページ単位を使用した場合、デフォルト値は 1 インチです。マップ単位を使用した場合、デフォルト値は 1 度です。 | Linear Unit |
origin_coord (オプション) | 出力グリッド フィーチャクラスの左下の原点座標値。入力フィーチャを指定した場合、指定されたフィーチャの範囲の結合範囲によってデフォルト値が算出されます。入力フィーチャを指定しない場合、デフォルトの座標は 0、0 です。 | Point |
number_rows (オプション) | 原点を基点として Y 方向に作成する行の数。デフォルトは 10 です。 | Long |
number_columns (オプション) | 原点を基点として X 方向に作成する列の数。デフォルトは 10 です。 | Long |
starting_page_number (オプション) | 各グリッド インデックス フィーチャに、指定した開始ページ番号から始まる連続ページ番号が割り当てられます。デフォルト値は 1 です。 | Long |
label_from_origin (オプション) | ページ番号 (ラベル) が始まる場所を指定します。
| Boolean |
コードのサンプル
次の例では、入力フィーチャの交差部を使用し、指定したインデックス フィーチャのマップ単位のディメンションを使用して、インデックス フィーチャ (格子状) を作成します。
import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly", "", "", "",
"1000 meters", "1000 meters")次の例では、入力フィーチャの全範囲を使用し、指定したインデックス フィーチャのページ単位のディメンションを使用して、インデックス フィーチャ (格子状) を作成します。
import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly",
"NO_INTERSECTFEATURE", "USEPAGEUNIT",
"100000", "5 inches", "5 inches")次の例では、入力フィーチャの交差部を使用し、指定したインデックス フィーチャのマップ単位のディメンションを使用して、開始ページ番号を 5 としたインデックス フィーチャ (格子状) を作成します。
import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly", "", "", "",
"1000 meters", "1000 meters", "", "",
"", "5")次の例では、原点座標、インデックス フィーチャのマップ単位のディメンション、行数、および列数を指定して、インデックス フィーチャ (格子状) を作成します。
import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures", "", "", "", "",
"1000 meters","1000 meters",
"-6000000 -1600000", "15", "20")次の例では、原点座標、インデックス フィーチャのページ単位のディメンション、行数、および列数を指定し、開始ページ番号を 5 とし、原点からラベリングを開始するように指定して、インデックス フィーチャ (格子状) を作成します。
import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures", "", "", "USEPAGEUNIT",
"100000", "5 inches", "5 inches",
"-6000000 -1600000", "15", "20", "5",
"LABELFROMORIGIN")次の例では、入力フィーチャの交差部を使用し、指定したインデックス フィーチャのマップ単位のディメンションを使用して、インデックス フィーチャ (格子状) を作成します。
# gridindexfeatures_example1.py
# Description: Creates Grid Index Features using the intersection of input
# features and specified index feature dimensions in map units
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
arcpy.env.workspace = "C:\data\ProjectData.gdb"
# Set local variables
outFeatureClass = "gridIndexFeatures"
inFeatures = "poly"
polygonWidth = "1000 meters"
polygonHeight= "1000 meters"
# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass,inFeatures, "", "", "",
polygonWidth, polygonHeight)次の例では、入力フィーチャの全範囲を使用し、指定したインデックス フィーチャのページ単位のディメンションを使用して、インデックス フィーチャ (格子状) を作成します。
# gridindexfeatures_example2.py
# Description: Creates Grid Index Features using the entire extent of input
# features and specified index feature dimensions in page units
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
arcpy.env.workspace = "C:\data\ProjectData.gdb"
# Set local variables
outFeatureClass = "gridIndexFeatures"
inFeatures = "poly"
noIntersect = "NO_INTERSECTFEATURE"
usePageUnit = "USEPAGEUNIT"
scale = "100000"
polygonWidth = "5 inches"
polygonHeight= "5 inches"
# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass, inFeatures, noIntersect,
usePageUnit, scale, polygonWidth,
polygonHeight)次の例では、入力フィーチャの交差部を使用し、指定したインデックス フィーチャのマップ単位のディメンションを使用して、開始ページ番号を 5 としたインデックス フィーチャ (格子状) を作成します。
# gridindexfeatures_example3.py
# Description: Creates Grid Index Features using the intersection of input
# features, specified index feature dimensions in map units and 5 as the
# starting page number
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
arcpy.env.workspace = "C:\data\ProjectData.gdb"
# Set local variables
outFeatureClass = "gridIndexFeatures"
inFeatures = "poly"
polygonWidth = "1000 meters"
polygonHeight= "1000 meters"
startingPageNum = "5"
# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass,inFeatures, "", "", "",
polygonWidth, polygonHeight, "", "", "",
startingPageNum)次の例では、原点座標、インデックス フィーチャのマップ単位のディメンション、行数、および列数を指定して、インデックス フィーチャ (格子状) を作成します。
# gridindexfeatures_example4.py
# Description: Creates Grid Index Features by specifying the origin
# coordinates, the index feature dimensions in map units, the number of
# rows and the number of columns
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:\data\ProjectData.gdb"
env.outputCoordinateSystem = arcpy.SpatialReference("North America Albers Equal Area Conic.prj")
# Set local variables
outFeatureClass = "gridIndexFeatures"
polygonWidth = "1000 meters"
polygonHeight= "1000 meters"
originCoord = "-6000000 -1600000"
numberRows = "15"
numberColumns = "20"
# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass, "", "", "", "",
polygonWidth, polygonHeight, originCoord,
numberRows, numberColumns)次の例では、原点座標、インデックス フィーチャのページ単位のディメンション、行数、および列数を指定し、開始ページ番号を 5 とし、原点からラベリングを開始するように指定して、インデックス フィーチャ (格子状) を作成します。
# gridindexfeatures_example5.py
# Description: Creates Grid Index Features by specifying the origin
# coordinates, the index feature dimensions in page units, the number of
# rows, the number of columns, 5 as the starting page number and labeling
# to start at the origin
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:\data\ProjectData.gdb"
env.outputCoordinateSystem = arcpy.SpatialReference("North America Albers Equal Area Conic.prj")
# Set local variables
outFeatureClass = "gridIndexFeatures"
usePageUnit = "USEPAGEUNIT"
scale = "100000"
polygonWidth = "1000 meters"
polygonHeight= "1000 meters"
originCoord = "-6000000 -1600000"
numberRows = "15"
numberColumns = "20"
startingPageNum = "5"
labeling = "LABELFROMORIGIN"
# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass, "", "", usePageUnit,
scale, polygonWidth, polygonHeight,
originCoord, numberRows, numberColumns,
startingPageNum, labeling)環境
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい