Étiquette | Explication | Type de données |
Table en entrée | Table contenant les enregistrements à croiser. | Table View |
Champs 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 permettront de générer le nom des champs dans la table en sortie. | Field |
Champ de valeur | Champ dont les valeurs renseigneront les champs croisés dans la table en sortie. | Field |
Table en sortie | Table qui sera créée. | 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.
La combinaison des valeurs Champs en entrée, Champ de croisement et Champ de valeur doit être unique.
Si la valeur 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 la valeur de 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 la valeur Champ de croisement sélectionnée contient des valeurs nulles.
Paramètres
arcpy.management.PivotTable(in_table, fields, pivot_field, value_field, out_table)
Nom | Explication | Type de données |
in_table | Table contenant les enregistrements à croiser. | 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 permettront de générer le nom des champs dans la table en sortie. | Field |
value_field | Champ dont les valeurs renseigneront les champs croisés dans la table en sortie. | Field |
out_table | Table qui sera créée. | Table |
Exemple de code
La fenêtre de script Python suivante illustre l’utilisation de la fonction PivotTable en mode immédiat.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.PivotTable("attributes.dbf", "OwnerID", "AttrTagNam",
"AttrValueS", "C:/output/attribPivoted.dbf")
Le script Python suivant 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"
# Run PivotTable
arcpy.management.PivotTable(in_table, fields, pivot_field, value_field, out_table)
Informations de licence
- Basic: Non
- Standard: Non
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?