带状地图索引要素 (制图)

许可等级:BasicStandardAdvanced

摘要

该工具可根据单个线状要素或一组线状要素创建一系列矩形面或索引要素。这些索引要素可与“数据驱动页面”结合使用,以便根据线状要素定义一幅带状地图或一组地图中的页面。生成的索引要素中包含可在页面上旋转及定向地图的属性,还包含决定哪些索引要素或页面与当前页面相邻(左右侧或上下侧)的属性。

用法

语法

StripMapIndexFeatures_cartography (in_features, out_feature_class, {use_page_unit}, {scale}, {length_along_line}, {length_perpendicular_to_line}, {page_orientation}, {overlap_percentage}, {starting_page_number}, {direction_type})
参数说明数据类型
in_features

定义带状地图索引要素路径的输入折线 (polyline)。

Feature Layer
out_feature_class

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

输出要素类的坐标系按以下顺序进行确定。

  • 如果已通过“环境设置”中的“输出坐标系”变量指定了坐标系,则输出要素类将使用此坐标系。
  • 如果未通过“输出坐标系”指定坐标系,则输出要素类将使用输入要素的坐标系。
Feature Class
use_page_unit
(可选)

指示索引要素大小的输入是否位于页面空间内。默认值为 NO_USEPAGEUNIT。

  • USEPAGEUNIT索引面的高度和宽度将在页面空间中进行计算。
  • NO_USEPAGEUNIT索引面的高度和宽度将在地图空间中进行计算。
Boolean
scale
(可选)

如果索引要素的长度(沿线长度和垂直于线的长度)要在页面空间中进行计算,则必须指定地图比例。如果已打开 ArcMap,则默认值为活动数据框的比例。如果 ArcMap 未打开,则默认值为 1。

Long
length_along_line
(可选)

沿以地图单位或页面单位指定的输入线要素方向的面索引要素长度。默认值由输入的一个或多个线要素的空间参考决定。该值为 X 轴方向上输入要素类长度的 1/100。

Linear unit
length_perpendicular_to_line
(可选)

垂直于以地图单位或页面单位指定的输入线要素的面索引要素长度。默认值由输入的一个或多个线要素的空间参考决定。该值为沿线方向要素长度的 1/2。

Linear unit
page_orientation
(可选)

用于确定布局页面上输入线要素的方向。默认值为 HORIZONTAL。

  • VERTICAL页面上带状地图系列的方向为从上至下。
  • HORIZONTAL页面上带状地图系列的方向为从左至右。
String
overlap_percentage
(可选)

系列中单个地图页面与其相邻页面之间地理叠加的近似百分比。默认值为 10。

Double
starting_page_number
(可选)

各格网索引要素将分配到连续的页码,起始页码需要指定。默认值为 1。

Long
direction_type
(可选)

索引要素将按照一定的顺序创建并需要指定一个起点。设置带状地图的方向类型后将产生一个起点。默认值为 WE_NS。这表示,如果线要素的方向趋势为自西向东/自东向西,则带状地图的起点位于该线要素的西端点,而如果方向趋势为自北向南/自南向北,则起点位于线要素的最北端。方向类型同样适用于次级线要素。

  • WE_NS自西向东和自北向南。
  • WE_SN 自西向东和自南向北。
  • EW_NS 自东向西和自北向南。
  • EW_SN 自东向西和自南向北。
String

代码实例

StripMapIndexFeatures 工具示例 #1(Python 窗口)

根据输入线要素创建带状地图索引要素,为布局页面指定索引要素尺寸。

import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.StripMapIndexFeatures_cartography ("lines", "indexFeatures",
                                         USEPAGEUNIT, "500000",
                                         "7 inches", "5 inches")
StripMapIndexFeatures 工具示例 #1(独立 Python 脚本)

根据输入线要素创建带状地图索引要素,为布局页面指定索引要素尺寸。

# stripmapindexfeatures_example1.py
# Description: Creates a series of strip map index features based on inputed
# line features with index feature dimensions specified for a layout page.
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
arcpy.env.workspace = r"C:\data\ProjectData.gdb"

# Set local variables
inFeatures = "line"
outFeatureClass = "indexFeatures"
usePageUnit = "USEPAGEUNIT"
scale = "500000"
lenA = "7 Inches"
lenP = "5 Inches"

# Execute StripMapIndexFeatures
arcpy.StripMapIndexFeatures_cartography (inFeatures, outFeatureClass,
                                         usePageUnit, scale, lenA, lenP)
StripMapIndexFeatures 工具示例 #2(Python 窗口)

根据输入线要素创建带状地图索引要素,索引要素尺寸指定为使用地图单位并且叠加为 0。

import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.StripMapIndexFeatures_cartography ("lines", "indexFeatures", "",
                                         "", "10 kilometers", "5 kilometers")
StripMapIndexFeatures 工具示例 #2(独立 Python 脚本)

根据输入线要素创建带状地图索引要素,索引要素尺寸指定为使用地图单位并且叠加为 0。

# stripmapindexfeatures_example2.py
# Description: Creates a series of strip map index features based on inputed
# line features with index feature dimensions specified in map units with an
# overlap set at 0.
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
arcpy.env.workspace = r"C:\data\ProjectData.gdb"

# Set local variables
inFeatures = "line"
outFeatureClass = "indexFeatures"
lenA = "10 Kilometers"
lenP = "5 Kilometers"

# Execute StripMapIndexFeatures
arcpy.StripMapIndexFeatures_cartography (inFeatures, outFeatureClass, "",
                                         "", lenA, lenP)
StripMapIndexFeatures 工具示例 #3(Python 窗口)

根据输入线要素创建带状地图索引要素,为布局页面指定索引要素尺寸并且页面方向设定为垂直。

import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.StripMapIndexFeatures_cartography ("lines", "indexFeatures",
                                         USEPAGEUNIT, "500000", "5 inches",
                                         "7 inches", VERTICAL)
StripMapIndexFeatures 工具示例 #3(独立 Python 脚本)

根据输入线要素创建带状地图索引要素,为布局页面指定索引要素尺寸并且页面方向设定为垂直。

# stripmapindexfeatures_example3.py
# Description: Creates a series of strip map index features based on inputed
# line features with index feature dimensions specified for a layout and
# the page orientation set as vertical.
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
arcpy.env.workspace = r"C:\data\ProjectData.gdb"

# Set local variables
inFeatures = "line"
outFeatureClass = "indexFeatures"
usePageUnit = "USEPAGEUNIT"
scale = "500000"
lenA = "7 Inches"
lenP = "5 Inches"
pageOrientation = "VERTICAL"

# Execute StripMapIndexFeatures
arcpy.StripMapIndexFeatures_cartography (inFeatures, outFeatureClass,
                                         usePageUnit, scale, lenA, lenP,
                                         pageOrientation)
StripMapIndexFeatures 工具示例 #4(Python 窗口)

根据输入线要素创建带状地图索引要素,要素尺寸的具体设置为使用地图单位、起始页码和带状地图方向。

import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.StripMapIndexFeatures_cartography ("lines", "indexFeatures", "", "",
                                         "10 kilometers", "5 kilometers",
                                         "", "", "5", "EW_SN")
StripMapIndexFeatures 工具示例 #4(独立 Python 脚本)

根据输入线要素创建带状地图索引要素,要素尺寸的具体设置为使用地图单位、起始页码和带状地图方向。

# stripmapindexfeatures_example4.py
# Description: Creates a series of strip map index features based on inputed
# line features with index feature dimensions specified in map units, the
# starting page number is 5 and the strip map direction is
# East-West/South-North.
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
arcpy.env.workspace = r"C:\data\ProjectData.gdb"

# Set local variables
inFeatures = "line"
outFeatureClass = "indexFeatures"
lenA = "10 Kilometers"
lenP = "5 Kilometers"
startingPageNum = "5"
directionType = "EW_SN"

# Execute StripMapIndexFeatures
arcpy.StripMapIndexFeatures_cartography (inFeatures, outFeatureClass, "", "",
                                         lenA, lenP, "", "", startingPageNum,
                                         directionType)

环境

此工具不使用任何地理处理环境

相关主题

许可信息

ArcGIS for Desktop Basic: 是
ArcGIS for Desktop Standard: 是
ArcGIS for Desktop Advanced: 是
5/10/2014