Résumé
Réorganise, suivant un ordre croissant ou décroissant, les enregistrements dans une classe ou table d'entités selon un ou plusieurs champs. Le résultat de cette réorganisation est écrit dans un nouveau jeu de données.
Illustration
Utilisation
Les classes d'entités peuvent faire l'objet d'une réorganisation spatiale ou d'un tri spatial. Vous devez utiliser le champ Forme comme champ de tri pour effectuer un tri spatial. Il existe plusieurs méthodes de tri spatial qui réorganisent différemment les entités selon leur emplacement.
Si des enregistrements en entrée sont sélectionnés, seul le sous-ensemble des enregistrements sélectionnés est trié et écrit dans la sortie.
Si plusieurs champs sont définis comme champ de tri, les enregistrements sont d'abord triés en fonction du premier champ, les enregistrements ainsi triés sont ensuite triés en fonction du deuxième champ, et ainsi de suite.
Les entités polygone peuvent être triées en fonction de leur surface à l'aide du champ Shape_Area d'une classe d'entités de géodatabase. De même, les entités polylignes peuvent être triées en fonction de leur longueur à l'aide du champ Shape_Length. Si vous souhaitez trier des entités surfaciques dans un fichier de formes, ajoutez un nouveau champ, calculez la surface dans le nouveau champ à l'aide de la fonction Calculate Field (Calculer un champ), puis exécutez la fonction Sort (Trier) à l’aide du nouveau champ.
Syntaxe
arcpy.management.Sort(in_dataset, out_dataset, sort_field, {spatial_sort_method})
Paramètre | Explication | Type de données |
in_dataset | Jeu de données en entrée dont les enregistrements sont réorganisés en fonction des valeurs de champ retenues dans le ou les champs de tri. | Table View |
out_dataset | Classe ou table d'entités en sortie. | Feature Class; Table |
sort_field [[sort_field, direction],...] | Spécifie le ou les champs dont les valeurs vont servir à réorganiser les enregistrements en entrée, et l'ordre dans lequel les enregistrements sont triés.
| Value Table |
spatial_sort_method (Facultatif) | Spécifie la manière dont les entités sont triées spatialement. La méthode de tri est activée uniquement lorsque le champ Shape (Forme) est sélectionné comme l’un des champs de tri.
| String |
Exemple de code
Exemple 1 d'utilisation de l'outil Tri (fenêtre Python)
Le script de la fenêtre Python suivant montre comment utiliser l'outil Sort pour organiser des entités en fonction des valeurs d'un champ.
import arcpy
from arcpy import env
env.workspace = "C:/data/city.gdb"
arcpy.Sort_management("crime", "crime_Sort", [["DATE_REP", "ASCENDING"]])
Exemple 2 d'utilisation de l'outil Tri (script autonome)
Le script Python ci-dessous illustre l’utilisation de la fonction Sort dans un script autonome.
# Name: Sort_example2.py
# Description: Sorts wells by location and well yield.
# Import system modules
import arcpy
# Set workspace environment
arcpy.env.workspace = "C:/data/newfoundland.gdb"
# set local variables
in_dataset = "wells"
out_dataset = "wells_Sort"
# Order features first by location (Shape) and then by WELL_YIELD
sort_fields = [["Shape", "ASCENDING"], ["WELL_YIELD", "DESCENDING"]]
# Use Peano algorithm
sort_method = "PEANO"
# execute the function
arcpy.Sort_management(in_dataset, out_dataset, sort_fields, sort_method)
Environnements
- Espace de travail courant
- Espace de travail temporaire
- Système de coordonnées en sortie
- Transformations géographiques
- Étendue
- Résolution XY
- Tolérance XY
- Valeurs M en sortie
- Résolution M
- Tolérance M
- Valeurs Z en sortie
- Valeur Z en sortie par défaut
- Résolution Z
- Tolérance Z
- Noms de champ qualifiés
- Domaine XY en sortie
- Domaine M en sortie
- Domaine Z en sortie
Informations de licence
- Basic: Limité
- Standard: Limité
- Advanced: Oui