格网索引要素 (制图)

摘要

创建一个可用作索引以使用数据驱动页面来指定地图册页面的矩形面要素的格网。可创建一个仅包含与另一要素图层相交的面要素的格网。

用法

语法

GridIndexFeatures_cartography (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

面索引要素的生成要素类。

输出要素类的坐标系按照以下方法确定。

  • 如果坐标系是通过“环境设置”中的“输出坐标系”变量指定的,则输出要素类将使用此坐标系。
  • 如果坐标系不是通过“输出坐标系”指定的,则输出要素类将使用活动数据框(ArcMap 已打开)的坐标系。
  • 如果坐标系不是通过“输出坐标系”指定的,并且没有活动数据框(ArcMap 未打开),则输出要素类将使用第一个输入要素的坐标系。
  • 如果坐标系不是通过“输出坐标系”指定的,并且没有活动数据框(ArcMap 未打开),也没有指定的输入要素,则输出要素类的坐标系将为未知。
Feature Class
in_features
[in_features,...]
(可选)

输入要素可用于定义所创建的面格网的范围。

Feature Layer
intersect_feature
(可选)

将输出格网要素类限制到仅与输入要素图层或数据集相交的区域。当输入要素已指定时,默认值为 INTERSECTFEATURE。输入要素的交集将用作创建索引要素。

  • INTERSECTFEATURE将输出格网要素类限制到仅与输入要素图层或数据集相交的区域。
  • NO_INTERSECTFEATURE将使用指定的坐标、行和列来创建输出格网要素类。
Boolean
use_page_unit
(可选)

指示索引面的大小输入是否使用页面单位。默认设置为 NO_USEPAGEUNIT。默认情况下,该工具使用地图单位。

  • USEPAGEUNIT索引面的高度和宽度使用页面单位来计算。
  • 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。

  • LABELFROMORIGIN起始于指定的起始页码(默认值为 1)的页码(标注)号从输出格网左下角的面要素开始。
  • NO_LABELFROMORIGIN起始于指定的起始页码(默认值为 1)的页码(标注)号从输出格网左上角的像元开始。
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

# 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

# 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

# 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

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:\data\ProjectData.gdb"
env.outputCoordinateSystem = r"C:\Program Files\ArcGIS\Desktop10.0\Coordinate Systems\
Projected Coordinate Systems\Continental\North America\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

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:\data\ProjectData.gdb"
env.outputCoordinateSystem = r"C:\Program Files\ArcGIS\Desktop10.0\Coordinate Systems\
Projected Coordinate Systems\Continental\North America\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)

环境

相关主题

许可信息

ArcView: 是
ArcEditor: 是
ArcInfo: 是

7/10/2012