Resumen
Crea una red de celdas rectangulares. La salida pueden ser entidades polilíneas o entidades de polígono.
Uso
El sistema de coordenadas de la salida se puede establecer ya sea al introducir una capa o clase de entidad en el parámetro Extensión de plantilla o al establecer la variable de entorno Sistema de coordenadas de salida.
Si el parámetro Crear puntos de etiqueta está activado (labels = 'LABELS' en Python), además de la red de salida, se crea una nueva clase de entidad de puntos con puntos de etiqueta en el centro de cada celda de red. El nombre de esta clase de entidad es el mismo que la clase de entidad de salida con un sufijo _label y se crea en la misma ubicación.
El parámetro Tipo de geometría ofrece la opción de crear celdas de polígonos o de polilíneas (opción predeterminada) de salida. La creación de una red de polígonos puede ser más lenta, según la cantidad de filas y columnas.
Los valores Ancho de tamaño de celda y Altura de tamaño de celda se encuentran en las mismas unidades definidas por la clase de entidad de salida.
Sintaxis
arcpy.management.CreateFishnet(out_feature_class, origin_coord, y_axis_coord, cell_width, cell_height, number_rows, number_columns, {corner_coord}, {labels}, {template}, {geometry_type})
Parámetro | Explicación | Tipo de datos |
out_feature_class | Clase de entidad de salida que contiene la red de celdas rectangulares. | Feature Class |
origin_coord | Punto pivote inicial de la red. | Point |
y_axis_coord | La coordenada del eje Y se utiliza para orientar la red. La red se rota en el mismo ángulo definido por la línea que conecta la coordenada de origen y la coordenada del eje Y. | Point |
cell_width | Determina el ancho de cada celda. Si desea que el ancho se calcule de manera automática con el valor del parámetro Cantidad de filas, deje vacío este parámetro o establezca el valor en cero. El ancho se calculará al ejecutar la herramienta. | Double |
cell_height | Determina la altura de cada celda. Si desea que la altura se calcule de manera automática con el valor del parámetro Cantidad de columnas, deje vacío este parámetro o establezca el valor en cero. La altura se calculará al ejecutar la herramienta. | Double |
number_rows | Determina la cantidad de filas que tendrá la red. Si desea que la cantidad de filas se calcule de manera automática con el valor del parámetro Ancho de tamaño de celda, deje este parámetro vacío o establezca el valor en cero. La cantidad de filas se calculará al ejecutar la herramienta. | Long |
number_columns | Determina la cantidad de columnas que tendrá la red. Si desea que la cantidad de columnas se calcule de manera automática con el valor del parámetro Altura de tamaño de celda, deje este parámetro vacío o establezca el valor en cero. La cantidad de columnas se calculará al ejecutar la herramienta. | Long |
corner_coord (Opcional) | La esquina opuesta de la red establecida por los valores Coordenada X y Coordenada Y. | Point |
labels (Opcional) | Especifica si se creará una clase de entidad de punto que contenga los puntos de etiqueta en el centro de cada celda de la red.
| Boolean |
template (Opcional) | Especifique la extensión de la red. Se puede introducir la extensión especificando las coordenadas o utilizando un dataset de plantilla.
| Extent |
geometry_type (Opcional) | Determina si la celdas de la red de salida serán entidades de polilínea o de polígono.
| String |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_label | se crea una nueva clase de entidad de punto con puntos de etiqueta en el centro de cada celda de red Si el parámetro Crear puntos de etiqueta está activado (labels = 'LABELS' en Python), se crea una nueva clase de entidad de puntos con puntos de etiqueta en el centro de cada celda de red. El nombre de esta clase de entidad es el mismo que la clase de entidad de salida con un sufijo _label y se crea en la misma ubicación. | Clase de entidad |
Muestra de código
El siguiente script de la ventana de Python demuestra cómo utilizar la función CreateFishnet en modo inmediato.
import arcpy
# Create a fishnet with 9 columns and 9 rows
# with origin at (1, 1) and output geometry is set to default (POLYLINE)
arcpy.CreateFishnet_management("C:/data/output/fishnet1.shp", "1 1", "1 9", "1", "1", "9", "9", "#", "NO_LABELS")
El siguiente script independiente muestra cómo crear nuevas celdas rectangulares (red) con la función CreateFishnet.
# Name: CreateFishnet.py
# Description: Creates rectangular cells
# import system module
import arcpy
from arcpy import env
# set workspace environment
env.workspace = "C:/data/output"
# Set coordinate system of the output fishnet
env.outputCoordinateSystem = arcpy.SpatialReference("NAD 1983 UTM Zone 11N")
outFeatureClass = "fishnet10by10.shp"
# Set the origin of the fishnet
originCoordinate = '1037.26 4145.81'
# Set the orientation
yAxisCoordinate = '1037.26 4155.81'
# Enter 0 for width and height - these values will be calcualted by the tool
cellSizeWidth = '0'
cellSizeHeight = '0'
# Number of rows and columns together with origin and opposite corner
# determine the size of each cell
numRows = '10'
numColumns = '10'
oppositeCoorner = '19273.61 18471.17'
# Create a point label feature class
labels = 'LABELS'
# Extent is set by origin and opposite corner - no need to use a template fc
templateExtent = '#'
# Each output cell will be a polygon
geometryType = 'POLYGON'
arcpy.CreateFishnet_management(outFeatureClass, originCoordinate, yAxisCoordinate, cellSizeWidth, cellSizeHeight, numRows, numColumns, oppositeCoorner, labels, templateExtent, geometryType)
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí