Créer un quadrillage (Gestion des données)

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.

Pour en savoir plus sur la fonction Créer un quadrillage

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ètreExplicationType 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.

  • LABELSUne nouvelle classe d'entités est créée avec des points labels. Il s’agit de l’option par défaut.
  • NO_LABELSLa classe d'entités avec points labels n'est pas créée.
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.

  • MAXOF : l’étendue maximale de toutes les entrées est utilisée.
  • MINOF : l’étendue minimale de toutes les entrées est utilisée.
  • DISPLAY : l’étendue est égale à l’affichage visible.
  • Nom de la couche : l’étendue de la couche spécifiée est utilisée.
  • Objet Extent : l’étendue de l’objet spécifié est utilisée.
  • Chaîne délimitée par des espaces de coordonnées géographiques : l’étendue de la chaîne spécifiée est utilisée. Les coordonnées sont exprimées dans l’ordre x-min, y-min, x-max, y-max.
Extent
geometry_type
(Facultatif)

Détermine si les cellules de quadrillage en sortie seront des entités polylignes ou surfaciques.

  • POLYLINELa sortie est une classe d'entités polylignes. Chaque cellule est définie par quatre entités linéaires.
  • POLYGONLa sortie est une classe d'entités surfaciques. Chaque cellule est définie par une entité surfacique.
String

Sortie dérivée

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

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes