Entidades de índice de mapa de separación (Cartografía)

Resumen

Crea una serie de polígonos rectangulares, o entidades de índice, que siguen a una entidad lineal simple o a un grupo de entidades lineales. Estas entidades de índice se pueden utilizar con series de mapas espaciales para definir las páginas de un mapa de separación o una serie de mapas que sigue a una entidad lineal. Las entidades de índice resultantes contienen atributos que se pueden utilizar para rotar y orientar el mapa en la página y determinar qué entidades de índice, o páginas, están cerca de la página actual (a la izquierda y a la derecha o hacia arriba y hacia abajo).

Uso

  • Las entidades de línea no pueden estar en una red geométrica.

  • Si usa el parámetro Utilizar escala y unidad de página, el parámetro Escala de mapa es obligatorio. Si ArcGIS Pro está abierto, se utilizará la escala de mapa del marco de datos activo; de lo contrario, el valor predeterminado será 1. Si especifica el tamaño de las entidades de índice en el espacio de mapa y no selecciona Utilizar escala y unidad de página, la Escala de mapa no es obligatoria ni necesaria.

  • Las entidades de índice resultantes se crean con un número de atributos. Estos atributos son PageNumber, GroupId, SeqId, Previous, Next, LeftPage, RightPage, TopPage, BottomPage y Angle.

    • Angle es un valor numérico que expresa el ángulo de rotación que el mapa (marco de datos) necesita para alinear los bordes de la entidad de índice con los bordes de una página de diseño. Para mantenerse dentro de las convenciones cartográficas, estos ángulos se calculan para mantener el Norte orientado hacia la parte superior de la página lo más posible. Los ángulos se calculan contra la orientación predeterminada de un mapa, donde 0 grados es el Norte, 90 grados es el Este, 180 grados es el Sur y -90 grados es el Oeste.
    • PageNumber es un número incremental asignado a cada entidad de índice.
    • GroupId es un entero asignado a todas las entidades de índice en una cadena o grupo conectado de entidades de línea. Los resultados de Entidades de índice de mapa de separación pueden incluir varios grupos. Generalmente, un grupo simple se origina en un conjunto conectado de entidades lineales o en una línea simple con varias partes no conectadas. Las entidades de índice creadas a partir de entidades lineales no conectadas individuales se asignarán a grupos separados. Los valores de GroupId son únicos y se derivan del ObjectID de la primera entidad de línea de una cadena dada.
    • SeqId: un número incremental asignado a cada entidad de índice basado en el orden de creación de la entidad en cada grupo.
    • PrevPage es el valor de PageNumber para la entidad de índice creada anteriormente. Este campo se utiliza para analizar el orden de creación de las entidades de índice. No utilice este campo para ejecutar texto dinámico para una serie de mapas. Use los campos LeftPage, RightPage, TopPage y BottomPage para texto dinámico.
    • Next es el valor de PageNumber para la próxima entidad de índice creada. Este campo se utiliza para analizar el orden de creación de las entidades de índice. No utilice este campo para ejecutar texto dinámico para una serie de mapas. Use los campos LeftPage, RightPage, TopPage y BottomPage para texto dinámico.
    • LeftPage, RightPage, TopPage y BottomPage resultan útiles cuando se incorporan los resultados a una serie de mapas. LeftPage es el valor de PageNumber de la entidad de índice que aparece a la izquierda de la entidad de índice actual después de aplicar la rotación. RightPage es el valor de PageNumber de la entidad de índice que aparece a la derecha. TopPage y BottomPage son los valores para las entidades de índice en la parte superior e inferior, respectivamente.

  • Cuando se selecciona Utilizar escala y unidad de página, las unidades para la Longitud a lo largo de la línea y la Longitud perpendicular a la línea cambian automáticamente a las unidades de página establecidas en el diseño activo (si ArcGIS Pro está abierto), o a pulgadas, si está utilizando la herramienta fuera de una sesión de ArcGIS Pro. Para obtener mejores resultados, estas unidades deben especificarse en unidades de página como pulgadas o centímetros. Si no se selecciona Utilizar escala y unidad de página, las unidades se deben especificar en unidades de mapa como metros, pies, kilómetros, millas o grados decimales.

Sintaxis

arcpy.cartography.StripMapIndexFeatures(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})
ParámetroExplicaciónTipo de datos
in_features

Las entidades de polilínea de entrada que definen la ruta de las entidades de índice de mapa de separación.

Feature Layer
out_feature_class

Clase de entidad de salida de entidades de índice de polígono.

Feature Class
use_page_unit
(Opcional)

Especifica si la entrada de tamaño de entidad de índice está en unidades de página.

  • USEPAGEUNITLa altura y el ancho del polígono de índice se calculan en unidades de página.
  • NO_USEPAGEUNITLa altura y el ancho del polígono de índice se calculan en unidades de mapa. Esta es la opción predeterminada.
Boolean
scale
(Opcional)

La escala del mapa debe estar especificada si las longitudes de las entidades de índice (a lo largo de la línea y perpendiculares a la línea) se calculan en unidades de página. Si usa ArcGIS Pro, el valor predeterminado será la escala del marco de datos activo; de lo contrario, el valor predeterminado será 1.

Long
length_along_line
(Opcional)

La longitud de la entidad de índice poligonal a lo largo de la entidad de línea de entrada especificada en unidades de mapa o unidades de página. El valor predeterminado está determinado por la referencia espacial de las entidades o la entidad de línea de entrada. Este valor será de 1/100 de la extensión de la clase de entidad de entrada a lo largo del eje x.

Linear Unit
length_perpendicular_to_line
(Opcional)

La longitud de la entidad de índice poligonal perpendicular a la entidad de línea de entrada especificada en unidades de mapa o unidades de página. El valor predeterminado está determinado por la referencia espacial de las entidades o la entidad de línea de entrada. Este valor será de la mitad del número utilizado para la longitud a lo largo de la línea.

Linear Unit
page_orientation
(Opcional)

Especifica la orientación de las entidades de línea de entrada en la página de diseño.

  • VERTICALLa dirección de la serie de mapas de separación en la página es desde arriba hacia abajo.
  • HORIZONTALLa dirección de la serie de mapas de separación en la página es de izquierda a derecha. Esta es la opción predeterminada.
String
overlap_percentage
(Opcional)

El porcentaje aproximado de superposición geográfica entre una página de mapa individual y las páginas contiguas en la serie. El valor predeterminado es 10.

Double
starting_page_number
(Opcional)

El número de página de la página inicial. A cada entidad de índice de cuadrícula se le asigna un número de página secuencial que empieza con el número de página inicial especificado. El valor predeterminado es 1.

Long
direction_type
(Opcional)

Especifica la dirección inicial de los mapas de separación.

  • WE_NSSi la tendencia direccional de la línea es de oeste a este, el punto inicial estará en el extremo más occidental de la línea; si la tendencia direccional de la línea es de norte a sur, el punto inicial estará en el extremo más septentrional de la línea. Esta es la opción predeterminada.
  • WE_SNSi la tendencia direccional de la línea es de oeste a este, el punto inicial estará en el extremo más occidental de la línea; si la tendencia direccional de la línea es de sur a norte, el punto inicial estará en el extremo más meridional de la línea.
  • EW_NSSi la tendencia direccional de la línea es de este a oeste, el punto inicial estará en el extremo más oriental de la línea; si la tendencia direccional de la línea es de norte a sur, el punto inicial estará en el extremo más septentrional de la línea.
  • EW_SNSi la tendencia direccional de la línea es de este a oeste, el punto inicial estará en el extremo más oriental de la línea; si la tendencia direccional de la línea es de sur a norte, el punto inicial estará en el extremo más meridional de la línea.
String

Muestra de código

Ejemplo 1 de StripMapIndexFeatures (ventana de Python)

El ejemplo siguiente crea entidades de índice de mapa de separación basado en las entidades de línea de entrada con dimensiones de entidad de índice especificadas para una página de diseño.

import arcpy
arcpy.env.workspace = 'C:\data\ProjectData.gdb'
arcpy.StripMapIndexFeatures_cartography('lines', 'indexFeatures',
                                        'USEPAGEUNIT', 500000,
                                        '7 inches', '5 inches')
Ejemplo 2 de StripMapIndexFeatures (script independiente)

El ejemplo siguiente crea entidades de índice de mapa de separación basado en las entidades de línea de entrada con dimensiones de entidad de índice especificadas para una página de diseño.

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

# Import system modules
import arcpy

# 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)
Ejemplo 3 de StripMapIndexFeatures (ventana de Python)

El ejemplo siguiente crea entidades de índice de mapa de separación basado en las entidades de línea de entrada con dimensiones de entidad de índice especificadas en unidades de mapa con una superposición de 0.

import arcpy
arcpy.env.workspace = 'C:\data\ProjectData.gdb'
arcpy.StripMapIndexFeatures_cartography('lines', 'indexFeatures', '',
                                        '', '10 kilometers', '5 kilometers')
Ejemplo 4 de StripMapIndexFeatures (script independiente)

El ejemplo siguiente crea entidades de índice de mapa de separación basado en las entidades de línea de entrada con dimensiones de entidad de índice especificadas en unidades de mapa con una superposición de 0.

# 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.

# Import system modules
import arcpy

# 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)
Ejemplo 5 de StripMapIndexFeatures (ventana de Python)

El ejemplo siguiente crea entidades de índice de mapa de separación basado en las entidades de línea de entrada con dimensiones de entidad de índice especificadas para una página de diseño y la orientación de página establecida como vertical.

import arcpy
arcpy.env.workspace = 'C:\data\ProjectData.gdb'
arcpy.StripMapIndexFeatures_cartography('lines', 'indexFeatures',
                                        'USEPAGEUNIT', 500000, '5 inches',
                                        '7 inches', 'VERTICAL')
Ejemplo 6 de StripMapIndexFeatures (script independiente)

El ejemplo siguiente crea entidades de índice de mapa de separación basado en las entidades de línea de entrada con dimensiones de entidad de índice especificadas para una página de diseño y la orientación de página establecida como vertical.

# 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.

# Import system modules
import arcpy

# 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)
Ejemplo 7 de StripMapIndexFeatures (ventana de Python)

El ejemplo siguiente crea entidades de índice de mapa de separación basado en las entidades de línea de entrada con especificaciones para dimensiones de entidad en unidades de mapa, número de página inicial y dirección de mapa de separación.

import arcpy
arcpy.env.workspace = 'C:\data\ProjectData.gdb'
arcpy.StripMapIndexFeatures_cartography('lines', 'indexFeatures', '', '',
                                        '10 kilometers', '5 kilometers',
                                        '', '', 5, 'EW_SN')
Ejemplo 8 de StripMapIndexFeatures (script independiente)

El ejemplo siguiente crea entidades de índice de mapa de separación basado en las entidades de línea de entrada con especificaciones para dimensiones de entidad en unidades de mapa, número de página inicial y dirección de mapa de separación.

# 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.

# Import system modules
import arcpy

# 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)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados