Résumé
Crée une classe d’entités pour un quadrillage de cellules rectangulaires L'outil peut créer des entités polylignes ou surfaciques.
Utilisation
Le système de coordonnées de la sortie peut être défini en entrant une classe d'entités ou une couche dans le paramètre Modèle d'étendue ou en définissant la variable d'environnement Système de coordonnées en sortie.
En plus de créer le quadrillage en sortie, une nouvelle classe d'entités points est créée avec des points labels au centre de chaque cellule de quadrillage si le paramètre Créer des points d'étiquette est sélectionné (labels = 'LABELS' dans Python). Le nom de cette classe d'entités est le même que celui de la classe d'entités en sortie avec le suffixe _label et elle est créée dans le même emplacement.
Le paramètre Type de géométrie permet de choisir entre la création de cellules polylignes (valeur par défaut) ou de cellules surfaciques en sortie. La création d'un quadrillage de polygone peut être plus lente, selon le nombre de lignes et de colonnes.
Les valeurs Largeur de cellule et Hauteur de cellule sont exprimées dans les mêmes unités que celles définies par la classe d'entités en sortie.
Syntaxe
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})| Paramètre | Explication | Type de données |
out_feature_class | Classe d'entités en sortie contenant le quadrillage de cellules rectangulaires. | Feature Class |
origin_coord | Point de croisement initial du quadrillage. | Point |
y_axis_coord | La coordonnée de l'axe des y permet d'orienter le quadrillage. Le quadrillage est tourné selon le même angle que celui défini par la ligne qui connecte l'origine et la coordonnée de l'axe des y. | Point |
cell_width | Détermine la largeur de chaque cellule. Si vous souhaitez que la largeur soit calculée automatiquement à l'aide de la valeur du paramètre Nombre de lignes, laissez ce paramètre vide ou définissez la valeur sur zéro (la largeur sera calculée lors de l'exécution de l'outil). | Double |
cell_height | Détermine la hauteur de chaque cellule. Si vous souhaitez que la hauteur soit calculée automatiquement à l'aide de la valeur du paramètre Nombre de colonnes, laissez ce paramètre vide ou définissez la valeur sur zéro (la hauteur sera calculée lors de l'exécution de l'outil). | Double |
number_rows | Détermine le nombre de lignes qu'aura le quadrillage. Si vous souhaitez que le nombre de lignes soit calculé automatiquement à l'aide de la valeur du paramètre Largeur de cellule, laissez ce paramètre vide ou définissez la valeur sur zéro (le nombre de lignes sera calculé lors de l'exécution de l'outil). | Long |
number_columns | Détermine le nombre de colonnes qu'aura le quadrillage. Si vous souhaitez que le nombre de colonnes soit calculé automatiquement à l'aide de la valeur du paramètre Hauteur de cellule, laissez ce paramètre vide ou définissez la valeur sur zéro (le nombre de colonnes sera calculé lors de l'exécution de l'outil). | Long |
corner_coord (Facultatif) | Angle opposé du quadrillage défini par les valeurs de Coordonnée X et Coordonnée Y. | Point |
labels (Facultatif) | Indique si une classe d'entités points sera créée avec des points labels au centre de chaque cellule du quadrillage.
| Boolean |
template (Facultatif) | Spécifie l'étendue du quadrillage. L'étendue peut être saisie en spécifiant les coordonnées ou en utilisant un jeu de données modèle.
| Extent |
geometry_type (Facultatif) | Détermine si les cellules de quadrillage en sortie seront des entités polylignes ou surfaciques.
| String |
Sortie dérivée
| Nom | Explication | Type de données |
| out_label | une classe d’entités ponctuelles est créée avec des points d’étiquette au centre de chaque cellule du quadrillage Si le paramètre Create Label Points (Créer des points d’étiquette) est activé (labels = 'LABELS' dans Python), une classe d’entités ponctuelles est créée avec des points d’étiquette au centre de chaque cellule du quadrillage. Le nom de cette classe d’entités est le même que celui de la classe d’entités en sortie avec le suffixe _label ; elle est créée dans le même emplacement. | Classe d’entités |
Exemple de code
Exemple 1 d'utilisation de l'outil CreateFishnet (fenêtre Python)
Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction CreateFishnet en mode immédiat.
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")
Exemple 2 d’utilisation de l’outil CreateFishnet (script autonome)
Le script autonome suivant indique la manière de créer des cellules rectangulaires (quadrillage) à l’aide de la fonction 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)
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui