带状地图索引要素 (制图)
摘要
该工具可根据单个线状要素或一组线状要素创建一系列矩形面或索引要素。这些索引要素可与“数据驱动页面”结合使用,以便根据线状要素定义一幅带状地图或一组地图中的页面。生成的索引要素中包含可在页面上旋转及定向地图的属性,还包含决定哪些索引要素或页面与当前页面相邻(左右侧或上下侧)的属性。
用法
输出要素类的坐标系按以下顺序进行确定:
- 如果已通过“环境设置”中的“输出坐标系”变量指定了坐标系,则输出要素类将使用此坐标系。
- 如果未通过“输出坐标系”指定坐标系,则输出要素类将使用输入要素的坐标系。
-
线要素是唯一有效的输入。
-
当选择使用页面单位和比例地图时,地图比例将成为必填参数。如果 ArcMap 呈打开状态,则将使用活动数据框的地图比例,否则,默认值为 1。如果您当前正在地图空间中指定索引要素的大小并且未选择使用页面单位和比例,则不需要使用地图比例。
-
根据一系列属性生成索引要素。这些属性包括:PageNumber、GroupId、SeqId、PrevPage、NextPage、LeftPage、RightPage、TopPage、BottomPage 和 Angle。
- Angle 是数值型值,表示将索引要素的边与布局页面的边对齐时地图(数据框)所需旋转的角度。为与制图惯例保持一致,这些角度值将计算为尽量将“北”朝向页面顶部。角度值会根据地图的默认定向进行计算,其中 0 度表示正北方向,90 度表示正东方向,180 度表示正南方向,而 -90 度表示正西方向。
- PageNumber 是指定给各索引要素呈递增趋势的数。
- GroupId 是整型值,它会指定给相连线要素链或线要素组中的所有索引要素。“带状地图索引要素”结果中可包括多个组。通常,单个组由一组相连的多个线要素组成或由带有多个未相连部分的单条线组成。基于未相连的独立线要素创建的索引要素将分别指定给各个组。GroupId 的值唯一,根据给定链中的第一个线要素的 OID 得来。
- SeqId 是一个呈递增趋势的数,根据各组中要素的创建顺序将其指定给各索引要素。
- PrevPage 表示之前创建的索引要素的 PageNumber 值。该字段可用于分析索引要素的创建顺序。请不要使用该字段运行“数据驱动页面”的动态文本。要运行动态文本,可使用 LeftPage、RightPage、TopPage 和 BottomPage 字段。
- NextPage 表示创建的下一个索引要素的 PageNumber 值。该字段可用于分析索引要素的创建顺序。请不要使用该字段运行“数据驱动页面”的动态文本。要运行动态文本,可使用 LeftPage、RightPage、TopPage 和 BottomPage 字段。
- 将结果应用到“数据驱动页面”时可使用 LeftPage、RightPage、TopPage 和 BottomPage。LeftPage 表示应用旋转后显示在当前索引要素左侧的索引要素的 PageNumber 值。RightPage 则表示显示在右侧的索引要素的 PageNmuber 值。而 TopPage 和 BottomPage 分别表示显示在上下端的索引要素的 PageNmuber 值。
-
如果选择使用页面单位和比例,沿线长度和垂直于线的长度的单位会自动更改为活动地图文档中设置的页面单位(如果 ArcMap 已打开),而如果使用的是 ArcMap 会话以外的工具,则将更改为英寸。为求得最佳结果,这些单位应指定为页面单位,例如英寸或厘米。如果未选择使用页面单位和比例,则单位应指定为地图单位,例如米、英尺、千米、英里或十进制度。
语法
参数 | 说明 | 数据类型 |
in_features |
定义带状地图索引要素路径的输入折线 (polyline)。 | Feature Layer |
out_feature_class |
面索引要素的生成要素类。 输出要素类的坐标系按以下顺序进行确定。
| Feature Class |
use_page_unit (可选) |
指示索引要素大小的输入是否位于页面空间内。默认值为 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。
| String |
overlap_percentage (可选) |
系列中单个地图页面与其相邻页面之间地理叠加的近似百分比。默认值为 10。 | Double |
starting_page_number (可选) |
各格网索引要素将分配到连续的页码,起始页码需要指定。默认值为 1。 | Long |
direction_type (可选) |
索引要素将按照一定的顺序创建并需要指定一个起点。设置带状地图的方向类型后将产生一个起点。默认值为 WE_NS。这表示,如果线要素的方向趋势为自西向东/自东向西,则带状地图的起点位于该线要素的西端点,而如果方向趋势为自北向南/自南向北,则起点位于线要素的最北端。方向类型同样适用于次级线要素。
| String |
代码实例
根据输入线要素创建带状地图索引要素,为布局页面指定索引要素尺寸。
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_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)
根据输入线要素创建带状地图索引要素,索引要素尺寸指定为使用地图单位并且叠加为 0。
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.StripMapIndexFeatures_cartography ("lines", "indexFeatures", "",
"", "10 kilometers", "5 kilometers")
根据输入线要素创建带状地图索引要素,索引要素尺寸指定为使用地图单位并且叠加为 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)
根据输入线要素创建带状地图索引要素,为布局页面指定索引要素尺寸并且页面方向设定为垂直。
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_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)
根据输入线要素创建带状地图索引要素,要素尺寸的具体设置为使用地图单位、起始页码和带状地图方向。
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_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)