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 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 ArcMap 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 página controlada por datos. 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 página controlada por datos. 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 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 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 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(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 | 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) | Indica si la entrada de tamaño de entidad de índice está en unidades de página.
| 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 ArcMap, 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.
| 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. La predeterminada 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 |
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 (secuencia de comandos 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 (secuencia de comandos 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 (secuencia de comandos 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 (secuencia de comandos 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 sobre licencias
- Basic: Sí
- Standard: Sí
- Advanced: Sí