描述
创建一个可用作索引的矩形面要素格网，以使用数据驱动页面来指定地图册页面。可创建一个仅包含与另一要素图层相交的面要素的格网。
使用方法
输出要素类的坐标系按照以下方法确定。
- 如果坐标系是通过“环境设置”中的“输出坐标系”变量指定的，则输出要素类将使用此坐标系。
- 如果坐标系不是通过“输出坐标系”指定的，则输出要素类将使用活动数据框（ArcMap 已打开）的坐标系。
- 如果坐标系不是通过“输出坐标系”指定的，并且没有活动数据框（ArcMap 未打开），则输出要素类将使用第一个输入要素的坐标系。
- 如果坐标系不是通过“输出坐标系”指定的，并且没有活动数据框（ArcMap 未打开），也没有指定的输入要素，则输出要素类的坐标系将为未知。
输入要素可以是点、线、面或栅格。
选择使用页面单位和比例时，地图比例将成为必需的参数。
使用工具对话框时，如果在已指定格网原点坐标的情况下更改面的宽度或高度值，则行数和列数将自动更改。
添加输入要素时，将自动计算格网原点坐标。
考虑将输出要素类保存到地理数据库。虽然支持将输出保存到 shapefile，但是如果想要使用 Calculate_Central_Meridian_And_Parallels 或 Calculate_UTM_Zone 工具来计算索引图层要素的空间参考，生成的坐标字符串结果可能会超出 shapefile 的字段字符长度限制 (255)。
当已选择使用页面单位和比例时，面宽度和面高度的单位将自动更改为活动地图文档中设置的页面单位。如果在 ArcMap 会话以外使用该工具，单位会默认为英寸。尽管可以指定地图单位（如米或英里），但最好还是使用适合页面的单位。
当已选择使用页面单位和比例时，地图比例将默认为活动 ArcMap 文档的页面布局上的活动数据框的比例值。如果在 ArcMap 会话以外使用该工具，则比例默认为 1。
为得到最佳结果，所有输入要素图层和要素类都应使用和数据框相同的坐标系，或者如果在 ArcMap 会话以外使用该工具，那么所有输入要素图层和要素类都应使用和列表中第一个输入要素图层或要素类相同的坐标系。
语法
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 （可选） | 将输出格网要素类限制到仅与输入要素图层或数据集相交的区域。当输入要素已指定时，默认值为 INTERSECTFEATURE。输入要素的交集将用作创建索引要素。
| Boolean |
use_page_unit （可选） | 指示索引面的大小输入是否使用页面单位。默认设置为 NO_USEPAGEUNIT。默认情况下，该工具使用地图单位。
| Boolean |
scale （可选） | 如果索引面的高度和宽度要使用页面单位来计算，则必须指定比例。如果该工具在活动 ArcMap 会话以外使用，则默认比例值为 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 （可选） | 起始于指定的起始页码（默认值为 1）的页码（标注）号从输出格网左下角的像元开始。默认值为 NO_LABELFROMORIGIN。
| Boolean |
代码示例
GridIndexFeatures 工具示例 #1（Python 窗口）
通过输入要素的交集和以地图单位指定的索引要素的大小来创建 GridIndexFeatures。
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly", "", "", "",
"1000 meters","1000 meters")
GridIndexFeatures 工具示例 #2（Python 窗口）
通过输入要素的整个范围和以页面单位指定的索引要素的尺寸来创建 GridIndexFeatures。
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly",
"NO_INTERSECTFEATURE","USEPAGEUNIT",
"100000", "5 inches","5 inches")
GridIndexFeatures 工具示例 #3（Python 窗口）
通过输入要素的交点、以地图单位指定的索引要素的尺寸以及起始页码 5 来创建 GridIndexFeatures。
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly", "", "", "",
"1000 meters", "1000 meters", "", "",
"", "5")
GridIndexFeatures 工具示例 #4（Python 窗口）
通过指定原点坐标、使用地图单位的索引要素尺寸、行数和列数来创建 GridIndexFeatures。
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures", "", "", "", "",
"1000 meters","1000 meters",
"-6000000 -1600000", "15", "20",)
GridIndexFeatures 工具示例 #5（Python 窗口）
通过指定原点坐标、使用页面单位的索引要素尺寸、行数、列数、起始页码 5 以及将在原点开始的标注来创建 GridIndexFeatures。
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures", "", "", "USEPAGEUNIT",
"100000", "5 inches", "5 inches",
"-6000000 -1600000", "5",
"LABELFROMORIGIN")
GridIndexFeatures 工具示例 #1（独立 Python 脚本）
通过输入要素的交集和以地图单位指定的索引要素的大小来创建 GridIndexFeatures。
# 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 工具示例 #2（独立 Python 脚本）
通过输入要素的整个范围和以页面单位指定的索引要素的尺寸来创建 GridIndexFeatures。
# 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)
GridIndexFeatures 工具示例 #3（独立 Python 脚本）
通过输入要素的交点、以地图单位指定的索引要素的尺寸以及起始页码 5 来创建 GridIndexFeatures。
# 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 工具示例 #4（独立 Python 脚本）
通过指定原点坐标、使用地图单位的索引要素尺寸、行数和列数来创建 GridIndexFeatures。
# 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)
GridIndexFeatures 工具示例 #5（独立 Python 脚本）
通过指定原点坐标、使用页面单位的索引要素尺寸、行数、列数、起始页码 5 以及将在原点开始的标注来创建 GridIndexFeatures。
# 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: 是