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 páginas controladas por datos para definir las páginas dentro 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
El sistema de coordenadas de la clase de entidad de salida se determina en este orden:
- Si la variable Sistema de coordenadas de salida de Configuración del entorno especifica un sistema de coordenadas, la clase de entidad de salida utilizará este sistema de coordenadas.
- Si la variable Sistema de coordenadas de salida no especifica un sistema de coordenadas, la clase de entidad de salida utilizará el sistema de coordenadas de la entidad de entrada.
Las entidades lineales son las únicas entradas válidas.
Cuando se selecciona Utilizar escala y unidad de página, Escala de mapa se convierte en un parámetro requerido. Si ArcMap está abierto, se usará la escala de mapa del marco de datos activo; de lo contrario, el valor predeterminado es 1. Si está especificando el tamaño de las entidades de índice en el espacio de mapa y no selecciona Utilizar escala y unidad de página, Escala de mapa no es necesario.
Las entidades de índice resultantes se crean con un número de atributos. Estos atributos incluyen: PageNumber, GroupId, SeqId, PrevPage, NextPage, 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 poder 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, dónde 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 lineales. 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 están derivados del OID de la primera entidad de línea de una cadena dada.
- SeqId es un número incremental asignado a cada entidad de índice basado en el orden de creación de la entidad dentro de 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 página controlada por datos. Para texto dinámico, utilice los campos LeftPage, RightPage, TopPage y BottomPage.
- NextPage 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 página controlada por datos. Para texto dinámico, utilice los campos LeftPage, RightPage, TopPage y BottomPage.
- LeftPage, RightPage, TopPage y BottomPage resultan útiles cuando se incorporan los resultados a las páginas controladas por datos. 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 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 documento de mapa activo (si ArcMap está abierto), o a pulgadas, si está utilizando la herramienta fuera de una sesión de ArcMap. 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
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})
Parámetro | Explicación | Tipo de datos |
in_features | Polilínea o polilíneas de entrada que definen la ruta de las entidades de índice de mapa de separación. | Feature Layer |
out_feature_class | Clase de entidad resultante de las entidades de índice de polígono. El sistema de coordenadas de la clase de entidad de salida se determina en este orden.
| Feature Class |
use_page_unit (Opcional) | Indica si la entrada de tamaño de entidad de índice está en el espacio de página. El valor predeterminado es NO_USEPAGEUNIT.
| 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 el espacio de página. Si ArcMap está abierto, el valor predeterminado será la escala del marco de datos activo. Si ArcMap no está abierto, 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 1/2 del número utilizado para la longitud a lo largo de la línea. | Linear unit |
page_orientation (Opcional) | Utilizado para determinar la orientación de las entidades de línea de entrada en la página de diseño. El valor predeterminado es HORIZONTAL.
| 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) | A cada entidad de índice de cuadrícula se le asigna un número de página secuencial que empieza con un número de página inicial especificado. El valor predeterminado es 1. | Long |
direction_type (Opcional) | Las entidades de índice se crean en un orden secuencial y necesitan un punto de inicio. La configuración del tipo de dirección para el mapa de separación proporciona un punto de inicio. El valor predeterminado es WE_NS. Esto significa que el punto de inicio para el mapa de separación estará en el extremo oeste de la entidad de línea si la tendencia direccional de la entidad de línea es Oeste a Este/Este a Oeste, o bien, estará en el punto más al norte de la entidad de línea, si la tendencia direccional es Norte a Sur/Sur a Norte. El tipo de dirección también se aplica a las entidades lineales secundarias.
| String |
Ejemplo de código
Ejemplo Nº 1 de la herramienta StripMapIndexFeatures (ventana de Python)
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 from arcpy import env arcpy.env.workspace = "C:\data\ProjectData.gdb" arcpy.StripMapIndexFeatures_cartography ("lines", "indexFeatures", USEPAGEUNIT, "500000", "7 inches", "5 inches")
Ejemplo Nº 1 de la herramienta StripMapIndexFeatures (secuencia de comandos de Python independiente)
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.
# 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)
Ejemplo Nº 2 de la herramienta StripMapIndexFeatures (ventana de Python)
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 from arcpy import env arcpy.env.workspace = "C:\data\ProjectData.gdb" arcpy.StripMapIndexFeatures_cartography ("lines", "indexFeatures", "", "", "10 kilometers", "5 kilometers")
Ejemplo Nº 2 de la herramienta StripMapIndexFeatures (secuencia de comandos de Python independiente)
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.
# 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)
Ejemplo Nº 3 de la herramienta StripMapIndexFeatures (ventana de Python)
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 from arcpy import env arcpy.env.workspace = "C:\data\ProjectData.gdb" arcpy.StripMapIndexFeatures_cartography ("lines", "indexFeatures", USEPAGEUNIT, "500000", "5 inches", "7 inches", VERTICAL)
Ejemplo Nº 3 de la herramienta StripMapIndexFeatures (secuencia de comandos de Python independiente)
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.
# 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)
Ejemplo Nº 4 de la herramienta StripMapIndexFeatures (ventana de Python)
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 from arcpy import env arcpy.env.workspace = "C:\data\ProjectData.gdb" arcpy.StripMapIndexFeatures_cartography ("lines", "indexFeatures", "", "", "10 kilometers", "5 kilometers", "", "", "5", "EW_SN")
Ejemplo Nº 4 de la herramienta StripMapIndexFeatures (secuencia de comandos de Python independiente)
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.
# 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)
Entornos
Esta herramienta no utiliza ningún entorno de geoprocesamiento.
Información sobre licencias
- ArcGIS for Desktop Basic: Sí
- ArcGIS for Desktop Standard: Sí
- ArcGIS for Desktop Advanced: Sí