Générer une règle attributaire de jointure spatiale (Gestion des données)

Synthèse

Génère un fichier .csv avec une règle attributaire pour une entrée reposant sur des valeurs de champ interrogées à partir d’une ou de plusieurs classes d’entités.

Utilisation

• Le paramètre Field Map (Appariement des champs) permet de gérer les champs et leur contenu dans le jeu de données en sortie.

  • Ajoutez et supprimez des champs de la liste des champs, réorganisez la liste des champs et renommez des champs.
  • Le type de données par défaut d’un champ en sortie est le même que le type de données du premier champ en entrée (du même nom) qu’il rencontre. Vous pouvez modifier le type de données en un autre type de données valide.
  • Utilisez une action pour identifier la manière dont les valeurs d’un ou de plusieurs champs en entrée sont fusionnées en un seul champ en sortie. Les actions disponibles sont First (Premier), Last (Dernier), Concatenate (Concaténer), Sum (Somme), Mean (Moyenne), Median (Médiane), Mode, Minimum, Maximum, Standard Deviation (Écart type) et Count (Total).
  • Lorsque vous utilisez l’action Concatenate (Concaténer), vous pouvez spécifier un délimiteur, comme une virgule ou d’autres caractères. Cliquez au début de la zone de texte Delimiter (Délimiteur) pour ajouter les caractères de délimitation.
  • L’option Standard Deviation (Écart type) n’est pas valide pour une seule valeur en entrée.
  • L’option Export (Exporter) permet d’enregistrer un appariement des champs sous forme de fichier .fieldmap.
  • L’option Load (Charger) permet de charger un fichier .fieldmap. La couche d’entités ou le jeu de données spécifié dans le fichier doit correspondre à celui utilisé dans l’outil. Sinon, le paramètre Field Map (Appariement des champs) est réinitialisé.
  • Utilisez le bouton Slice Text (Texte de tranche) sur les champs de la source du texte pour sélectionner les caractères d’une valeur en entrée à extraire dans le champ en sortie. Pour accéder au bouton Slice Text (Texte de tranche), survolez un champ de texte dans la liste des champs en entrée, puis spécifiez les positions des caractères de début et de fin.
  • Il est également possible d’apparier des champs dans un script Python.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Table en entrée	Classe d’entités à partir de laquelle la règle attributaire est créée.	Feature Layer
Dossier en sortie	Dossier dans lequel le fichier .csv en sortie est enregistré. Le nom du fichier est identique à la valeur du paramètre Table en entrée.	Folder
Classes de jointure	Attributs des entités de jointure qui sont joints aux attributs des entités en entrée.	Feature Layer
Appariement des champs	Contrôle le transfert ou l’appariement des champs depuis les valeurs du paramètre Classes de jointure vers la valeur du paramètre Table en entrée.	Field Mappings
Expression (Facultatif)	Expression SQL qui permet de limiter les entités de l’entrée qui participent à la règle attributaire.	SQL Expression
Options de recherche (Facultatif)	Définit les requêtes spatiales entre les entités des valeurs de paramètre Table en entrée et Classes de jointure. Le type de géométrie, l’opérateur spatial et la distance spatiale peuvent être configurés de façon à définir les appariements entre la classe de jointure et la table en entrée. Classe de jointure : nom de la classe de jointure sur laquelle s’exécute la requête spatiale. Type de géométrie en entrée : portion de la géométrie en entrée utilisée pour interroger la classe de jointure. Opérateur spatial : opération spatiale utilisée dans la requête. Distance de recherche : distance par rapport à la géométrie qui est incluse dans la requête. Les opérateurs de géométrie en entrée disponibles sont les suivants : Géométrie : géométrie complète de l’entité en entrée. Il s’agit de l’option par défaut. Début : premier sommet dans une entité polyligne. Cette option est prise en charge uniquement pour les entités polylignes. Fin : dernier sommet dans une entité polyligne. Cette option est prise en charge uniquement pour les entités polylignes. Centroïde : centre géométrique de l’entité en entrée. Les opérateurs spatiaux disponibles sont les suivants : Intersecte : les entités de la classe de jointure sont appariées si elles intersectent une entité en entrée. Il s’agit de l’option par défaut. Croise : les entités de la classe de jointure sont appariées si elles croisent une entité en entrée. Contient : les entités de la classe de jointure sont appariées si une entité en entrée les contient. Cet opérateur est l’opposé de l’option À l’intérieur. Intersecte l’enveloppe : les entités de la classe de jointure sont appariées si leurs emprises (enveloppes) intersectent l’emprise d’une entité en entrée. Superpose : les entités de la classe de jointure sont appariées si elles se superposent à une entité en entrée. Les entités de la classe de jointure ne sont pas complètement contenues dans les entités en entrée. Touche : les entités de la classe de jointure sont appariées si elles comportent une limite qui touche une entité en entrée. Lorsque les entités en entrée et jointes sont des polylignes ou des polygones, la limite de l’entité de jointure ne peut toucher que la limite de l'entité en entrée, et aucune partie de l’entité de jointure ne peut croiser la limite de l’entité en entrée. À l’intérieur : les entités de la classe de jointure sont appariées si une entité en entrée se trouve à l’intérieur. Cet opérateur est l’opposé de l’option Contient.	Value Table

Sortie obtenue

Étiquette	Explication	Type de données
Fichier CSV de règle en sortie	Emplacement de dossier et nom du fichier .csv en sortie.	File

Python

arcpy.management.GenerateSpatialJoinAttributeRule(in_table, out_folder, join_classes, field_map, {where_clause}, {search_options})

Nom	Explication	Type de données
in_table	Classe d’entités à partir de laquelle la règle attributaire est créée.	Feature Layer
out_folder	Dossier dans lequel le fichier .csv en sortie est enregistré. Le nom du fichier est identique à la valeur du paramètre in_table.	Folder
join_classes [join_classes,...]	Attributs des entités de jointure qui sont joints aux attributs des entités en entrée.	Feature Layer
field_map	Contrôle le transfert ou l’appariement des champs depuis les valeurs du paramètre join_classes vers la valeur du paramètre in_table.	Field Mappings
where_clause (Facultatif)	Expression SQL qui permet de limiter les entités de l’entrée qui participent à la règle attributaire.	SQL Expression
search_options [search_options,...] (Facultatif)	Définit les requêtes spatiales entre les entités des valeurs de paramètre in_table et join_classes. Le type de géométrie, l’opérateur spatial et la distance spatiale peuvent être configurés de façon à définir les appariements entre la classe de jointure et la table en entrée. Classe de jointure : nom de la classe de jointure sur laquelle s’exécute la requête spatiale. Type de géométrie en entrée : portion de la géométrie en entrée utilisée pour interroger la classe de jointure. Opérateur spatial : opération spatiale utilisée dans la requête. Distance de recherche : distance par rapport à la géométrie qui est incluse dans la requête. Les opérateurs de géométrie en entrée disponibles sont les suivants : GEOMETRY : géométrie complète de l’entité en entrée. Il s’agit de l’option par défaut. START : premier sommet dans une entité polyligne. Cette option est prise en charge uniquement pour les entités polylignes. END : dernier sommet dans une entité polyligne. Cette option est prise en charge uniquement pour les entités polylignes. CENTROID : centre géométrique de l’entité en entrée. Les opérateurs spatiaux disponibles sont les suivants : INTERSECTS : les entités de la classe de jointure sont appariées si elles intersectent une entité en entrée. Il s’agit de l’option par défaut. CROSSES : les entités de la classe de jointure sont appariées si elles croisent une entité en entrée. CONTAINS : les entités de la classe de jointure sont appariées si une entité en entrée les contient. Cet opérateur est l’opposé de l’option WITHIN. ENVELOPE_INTERSECTS : les entités de la classe de jointure sont appariées si leurs emprises (enveloppes) intersectent l’emprise d’une entité en entrée. OVERLAPS : les entités de la classe de jointure sont appariées si elles se superposent à une entité en entrée. Les entités de la classe de jointure ne sont pas complètement contenues dans les entités en entrée. TOUCHES : les entités de la classe de jointure sont appariées si elles comportent une limite qui touche une entité en entrée. Lorsque les entités en entrée et jointes sont des polylignes ou des polygones, la limite de l’entité de jointure ne peut toucher que la limite de l'entité en entrée, et aucune partie de l’entité de jointure ne peut croiser la limite de l’entité en entrée. WITHIN : les entités de la classe de jointure sont appariées si une entité en entrée se trouve à l’intérieur. Cet opérateur est l’opposé de l’option CONTAINS.	Value Table

Sortie obtenue

Nom	Explication	Type de données
out_rule_csv	Emplacement de dossier et nom du fichier .csv en sortie.	File

Exemple de code

Exemple d’utilisation de la fonction GenerateSpatialJoinAttributeRule (fenêtre Python)

L’exemple ci-dessous explique comment utiliser la fonction GenerateSpatialJoinAttributeRule entre deux classes :

import arcpy
arcpy.management.GenerateSpatialJoinAttributeRule( 
    in_table=r"C:\temp\test.gdb\in_featureclass", 
    out_folder=r"C:\temp", 
    join_classes=["layer_one", "layer_two"], 
    where_clause="select * from X" 
)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.