Étiquette | Explication | Type de données |
Table en entrée | Table dont les enregistrements seront croisés. | Table View |
Champ(s) en entrée | Champs qui définissent les enregistrements à inclure dans la table en sortie. | Field |
Champ de croisement | Champ dont les valeurs d'enregistrement permettent de générer le nom des champs dans la table en sortie. | Field |
Champ de valeur | Champ dont les valeurs renseignent les champs croisés dans la table en sortie. | Field |
Table en sortie | Table à créer. | Table |
Disponible avec une licence Advanced.
Synthèse
Crée une table à partir de la table en entrée en réduisant la redondance dans les enregistrements et en mettant à plat les relations un vers plusieurs.
Illustration
Utilisation
Cet outil est généralement utilisé pour réduire les enregistrements redondants et mettre à plat les relations un vers plusieurs.
Si le champ de croisement est de type texte, ses valeurs doivent commencer par un caractère (par exemple, a2) et pas un nombre (par exemple, 2a). Si la valeur du premier enregistrement commence par un nombre, toutes les valeurs en sortie seront nulles (0).
Si le champ de croisement est de type numérique, sa valeur est ajoutée au nom de son champ d'origine dans la table en sortie.
Le nombre de champs dans la table en sortie est déterminé par le nombre de champs en entrée que vous sélectionnez, plus un champ pour chaque valeur unique du champ de croisement. Le nombre d'enregistrements dans la table en sortie est déterminé par la combinaison unique de valeurs entre les champs en entrée et le champ de croisement sélectionnés.
L'outil échoue si le champ de croisement sélectionné contient des valeurs Null.
Paramètres
arcpy.management.PivotTable(in_table, fields, pivot_field, value_field, out_table)
Nom | Explication | Type de données |
in_table | Table dont les enregistrements seront croisés. | Table View |
fields [fields,...] | Champs qui définissent les enregistrements à inclure dans la table en sortie. | Field |
pivot_field | Champ dont les valeurs d'enregistrement permettent de générer le nom des champs dans la table en sortie. | Field |
value_field | Champ dont les valeurs renseignent les champs croisés dans la table en sortie. | Field |
out_table | Table à créer. | Table |
Exemple de code
Le script de fenêtre Python ci-dessous illustre l’utilisation de la fonction PivotTable en mode immédiat.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.PivotTable_management("attributes.dbf", "OwnerID", "AttrTagNam",
"AttrValueS", "C:/output/attribPivoted.dbf")
Le script Python ci-dessous illustre l’utilisation de la fonction PivotTable dans un script autonome.
# Name: PivotTable_Example2.py
# Description: Pivot the attributes table by the specified fields
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/data"
# Set local variables
in_table = "attributes.dbf"
fields = "OwnerID"
pivot_field = "AttrTagNam"
value_field = "AttrValueS"
out_table = "C:/output/attribPivot.dbf"
# Execute PivotTable
arcpy.PivotTable_management(in_table, fields, pivot_field, value_field, out_table)
Environnements
Cas particuliers
Informations de licence
- Basic: Non
- Standard: Non
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?