PointOnAreaOverlayer

Exemple : trouver la surface qui contient un point

Dans cet exemple, nous avons un jeu de données de points représentant des restaurateurs et un jeu de données de polygones représentant les quartiers.

Pour trouver dans quel voisinage se trouve un restaurateur, nous connecter les points restaurateurs au port d'entrée Point et les quartiers au port d'entrée Area.

Dans les paramètres, les configurations par défaut fourniront les bons résultats. Notez que le mode Traitement des attributs est réglé sur Fusionner tous les attributs, ce qui ajoutera à chaque point les attributs du polygone de voisinage.

En regardant les restaurateurs en sortie, nous voyons que les attributs du quartier englobant a été ajouté.

En observant la sortie des surfaces, l'attribut _overlaps nous indique combien de restaurateurs existent dans chaque quartier.

Exemple : générer une liste de plusieurs points contenus dans une surface

En utilisant les mêmes points de restaurateurs et polygones de voisinages que précédemment, nous allons aussi construire un attribut de liste qui contient tous les restaurateurs pour un quartier donné.

Dans la fenêtre de paramètres, activez Génération de liste sur les areas (polygones), donnez un nom à la liste et sélectionnez les attributs à inclure.

En observant le résultat, nous pouvons voir que le quartier de Fairview contient 7 restaurateurs, et les noms et descriptions de ces restaurateurs sont contenus dans un attribut de liste.

Comparaison de Transformers spatiaux

Transformer	Peut fusionner des attributs	Altère la géométrie	Compte le nombre d'entités liées	Créé des listes	Types supportés*	Recommandé pour
SpatialFilter	Oui	Non	Non	Non	Point Texte Curve Area	Teste l'existence de relations spatiales entre deux jeux d'entités et les dirige selon la réussite ou l'échec du ou des test(s).
SpatialRelator	Oui	Non	Oui	Oui	Point Texte Curve Area	Identifier la nature des relations spatiales entre deux jeux d'entités.
AreaOnAreaOverlayer	Oui	Oui	Oui	Oui	Area	Trouve les superpositions de polygones et les extrait dans une nouvelle géométrie.
LineOnAreaOverlayer	Oui	Oui	Oui	Oui	Courbe et Surface	Trouver les intersections entre les lignes et les polygones, et les diviser à l'endroit où ils se croisent.
LineOnLineOverlayer	Oui	Oui	Oui	Oui	Curve	Trouver des intersections entre entités linéaires et les fractionner en nouvelles géométries de lignes et points représentant les intersections.
PointOnAreaOverlayer	Oui	Non	Oui	Oui	Point et Surface Texte et Surface	Identifie les points qui tombent dans des polygones et fusionne leurs attributs entre eux.
PointOnLineOverlayer	Oui	Oui	Oui	Oui	Point et Courbe Texte et Courbe	Identifier où les points tombent sur des lignes et les fractionner en nouvelles géométries.
PointOnPointOverlayer	Oui	Non	Oui	Oui	Point Texte	Identifie les points à la même position (selon une tolérance) et fusionne les attributs entre eux.
Intersector	Oui	Oui	Oui	Oui	Point Texte Curve Area	Trouve les intersections entres toutes les entités en entrée quelle que soit leur géométrie (incluant les auto-intersections), fractionne les entités et créer de nouvelles géométries.
Clipper	Oui	Oui	Non	Non	Point Texte Curve Area Surface Solides Raster Nuage de points	Compare les entités contre un jeu d'entités Clipper et les fractionne selon ou le long des bordures des entités Clipper. Génère en sortie une géométrie nouvelle et intacte, identifiée comme étant à l'intérieur (port de sortie Inside) ou à l'extérieur (port de sortie Outside) du Clipper.
NeighborFinder	Oui	Dans certains cas	Non	Oui	Point Texte Curve Area	Identifie les entités les plus proches de chaque entité considérée, qu'elle soit dans un autre jeu d'entités ou dans le même.
TopologyBuilder	Oui	Oui	Non	Oui	Point Texte Curve Area	Analyse les relations spatiales entre les entités pour calculer la topologie, fractionner les entités et créer de nouvelles géométries représentant des nœuds, segments et faces topologiquement significatifs avec les attributs associés.

* Notez que les courbes (Curve) comprennent les lignes, les arcs et les chemins. Les surfaces (Area) comprennent les polygones, les polygones troués et les ellipses.

Effet du choix de Transformer spatial sur les performances

L'analyse spatiale peut nécessiter un traitement intensif, en particulier lorsqu'un grand nombre d'entités sont concernées. Si vous souhaitez améliorer les performances de votre traitement, voici un bon point de départ.

Quand il y a plusieurs façons de configurer un traitement pour atteindre le même but, il est souvent mieux de choisir le Transformer le plus adapté à votre tâche.

Si les performances sont un problème dans votre traitement, recherchez des méthodes alternatives, guidées par la géométrie.

Point

Entités ponctuelles (incluant texte) auxquelles seront comparées les surfaces.

Area

Entités surfaciques auxquelles seront comparés les points.

Point

Entités ponctuelles, avec des attributs ajoutés selon la configuration des paramètres du Transformer. La géométrie n'est pas modifiée.

Area

Entités polygonales, avec des attributs ajoutés selon la configuration des paramètres du Transformer. La géométrie n'est pas modifiée.

Les entités avec des géométries invalides sont rejetées et ressortent par ce port.

Les entités rejetées ont un attribut fme_rejection_code avec l'une des valeurs suivantes :

INVALID_POINT_GEOMETRY_TYPE

INVALID_POLYGON_GEOMETRY_TYPE

INVALID_POLYGON_GEOMETRY_VERTICES

INVALID_POLYGON_GEOMETRY_DEGENERATE

EXTRA_POLYGON_FEATURE

Gestion des entités rejetées : ce paramètre permet d'interrompre la traduction ou de la poursuivre lorsqu'elle rencontre une entité rejetée. Ce paramètre est disponible à la fois comme option par défaut de FME et comme paramètre de traitement.

Traitement des regroupements

Regrouper par

Le comportement par défaut consiste à utiliser l'ensemble des entités comme groupe. Cette option vous permet de sélectionner les attributs qui définissent les groupes à former.

Traitement des regroupements

Sélectionnez le moment du traitement où les groupes sont traités :

Quand toutes les entités sont reçues

Comportement par défaut. Le traitement ne se produira dans ce Transformer que lorsque toutes les entrées seront présentes.

Quand le groupe change (avancé)

Ce Transformer traitera les groupes en entrée dans l'ordre. Les changements de la valeur du paramètre Regrouper par sur le flux d'entrée déclencheront le traitement du groupe en cours de regroupement. Cela peut améliorer la vitesse globale (en particulier avec plusieurs groupes de taille égale), mais peut provoquer un comportement indésirable si les groupes en entrée ne sont pas ordonnés.

Général

Polygones en premier

Si l'option Polygones en premier a pour valeur Oui, le calque PointOnAreaOverlayer part du principe que toutes les entités du port Area entrent dans le Transformer avant les entités Point. Cela peut réduire l'utilisation de la mémoire de PointOnAreaOverlayer si vous avez beaucoup d'entités ponctuelles à superposer. Toute autre entité polygonales qui arrive après la première entité de point sera enregistrée avec un avertissement et rejetée.

Si le paramètre Traitement des regroupements est défini sur Quand le groupe change, le prérequis Polygones en premier s'applique à chaque groupe séparément. Cela signifie que les entités Area et Point du premier groupe doivent entrer dans le Transformer avant les entités Area et Point du second groupe.

Gestion des agrégats

Choisir comment les agrégats de géométries doivent être gérés.

Désagréger : décomposent les agrégats en leurs composants individuels.

Rejeter : ne pas traiter les agrégats et les sortir via le port <Rejected>.

Gestion des attributs

Si les attributs des entités entrantes et originales ont le même nom, mais ne sont pas d'attribut de géométrie commençant par fme_, alors ils seront considérés comme en conflit.

Fusion des attributs

Traitement des attributs

Regrouper les entités entrantes : l'entité originale conservera tous ses attributs non conflictuels et acquerra en plus tous les attributs non conflictuels de l'entité entrante. Ce mode traitera les attributs conflictuels en fonction du paramètre de résolution des conflits.

Préfixer les entités entrantes : L'entité originale conservera tous ses attributs. De plus, l'original acquerra des attributs reflétant les attributs de l'entité entrante, avec le nom préfixé par le paramètre Prefix.

Remplacer par une seule entité entrante : tous les attributs de l'entité originale seront supprimés, à l'exception des attributs géométriques qui commencent par fme_. Ensuite, tous les attributs d'une entité entrante (arbitraire) seront placés sur l'original.

Résolution de conflit

Utiliser les attributs d'origine : si un conflit d'attributs apparaît, les valeurs des entités d'origine sont conservées.

Utiliser les attributs des entités appariées : si un conflit d'attributs apparaît, les valeurs des attributs de la liste seront transférées aux entités d'origine.

Préfixe

Si le paramètre Traitement des attributs vaut Préfixer les éléments entrants , la valeur saisie en paramètre préfixera les attributs ajoutés aux entités d'origine.

Générer liste dans le port de sortie ‘Point’

Quand activé, ajoute un attribut de liste aux entités sortant du port Point et les attributs de chaque surface comprenant un point en sortie sont ajoutés dans la liste du point.

Aucune intersection des entités surfaciques n'est réalisée.

Nom de la liste ‘Point’

Entrer un nom de liste.

Note Les attributs de liste ne sont pas accessibles à partir du schéma de sortie dans FME Workbench, sauf s'ils sont d'abord traités à l'aide d'un Transformer qui opère sur eux, comme ListExploder ou ListConcatenator. Il est également possible d'utiliser AttributeExposer.

Ajouter à la liste 'Point'

Tous les attributs: tous les attributs seront ajoutés aux entités ponctuelles en sortie.

Attributs sélectionnés: Active le paramètre Attributs sélectionnés où des attributs spécifiques peuvent être choisis pour inclusion.

Attributs sélectionnés

Activé lorsque l'option Ajouter à la liste "Points" vaut Attributs sélectionnés. Spécifiez les attributs que vous souhaitez inclure.

Gérer liste dans le port de sortie 'Surface'

Quand activé, ajoute un attribut de liste aux entités sortant du port Area et les attributs de chaque ligne comprise dans une surface en sortie sont ajoutés à la liste de cette surface.

Aucune intersection des entités surfaciques n'est réalisée.

Nom de liste 'Area'

Entrer un nom de liste.

Note Les attributs de liste ne sont pas accessibles à partir du schéma de sortie dans FME Workbench, sauf s'ils sont d'abord traités à l'aide d'un Transformer qui opère sur eux, comme ListExploder ou ListConcatenator. Il est également possible d'utiliser AttributeExposer.

Ajouter à la liste 'Area'

Tous les attributs : tous les attributs seront ajoutés aux entités surfaciques en sortie.

Attributs sélectionnés: Active le paramètre Attributs sélectionnés où des attributs spécifiques peuvent être choisis pour inclusion.

Attributs sélectionnés

Activé lorsque l'option Ajouter à la liste "Area" vaut Attributs sélectionnés. Spécifiez les attributs que vous souhaitez inclure.

Nom de l'attribut en sortie

Nombre de superpositions

L'attribut Nombre de superpositions ajouté aux entités ponctuelles contient le nombre de surfaces dans lesquelles ils étaient.

Le paramètre Attribut Nombre de superpositions contient le nom de l'attribut ajouté aux entités surfaciques en sortie qui stocke le nombre de superpositions avec les entités ponctuelles.

Définir des valeurs de paramètres

Définir les valeurs

Il existe plusieurs façons de définir une valeur à utiliser dans un Transformer. La plus simple consiste à saisir simplement une valeur ou une chaîne de caractères, qui peut inclure des fonctions de différents types telles que des références d'attributs, des fonctions mathématiques et de chaînes de caractères, et des paramètres traitement.

Utilisation de l'éditeur de texte

L'éditeur de texte fournit un moyen efficace de construire des chaînes de textes (dont les expressions régulières) à partir de données source diverses, telles que des attributs, des paramètres et des constantes, et le résultat est directement utilisé dans le paramètre.

Editeur de texte

Utilisation de l'éditeur arithmétique

L'éditeur arithmétique fournit un moyen simple de construire des expressions mathématiques à partir de plusieurs données source, telles que des attributs et des fonctions, et le résultat est directement utilisé dans un paramètre.

Éditeur arithmétique

Valeur conditionnelle

Définit des valeurs selon un ou plusieurs tests.

Fenêtre de définition de conditions

Contenu

Les expressions et chaînes de caractères peuvent inclure des fonctions, caractères, paramètres et plus.

Lors du paramétrage des valeurs - qu'elles soient entrées directement dans un paramètre ou construites en utilisant l'un des éditeurs - les chaînes de caractères et les expressions contenant des fonctions Chaîne de caractères, Math, Date et heure ou Entité FME auront ces fonctions évaluées. Par conséquent, les noms de ces fonctions (sous la forme @<nom_de_fonction>) ne doivent pas être utilisés comme valeurs littérales de chaîne de caractères.

Types de contenu

Fonctions chaînes de caractères	Ces fonctions manipulent les chaînes de caractères.
Caractères spéciaux	Un ensemble de caractères de contrôle est disponible dans l'éditeur de texte.
Fonctions mathématiques	Plusieurs fonctions sont disponibles dans les deux éditeurs.
Fonctions Date/heure	Les fonctions de dates et heures sont disponibles dans l'Editeur texte.
Opérateurs mathématiques	Ces opérateur sont disponibles dans l'éditeur arithmétique.
Fonctions d'entités	Elles retournent des valeurs spécifiques aux entités.
Paramètres FME	Les paramètres FME et spécifiques au traitement peuvent être utilisés.
Créer et modifier un paramètre publié	Créer ses propres paramètres éditables.

Options - Tables

Outils de tableau

Les Transformers avec des paramètres de style table possèdent des outils additionnels pour remplir et manipuler des valeurs.

Réordonner

Activé une fois que vous avez cliqué sur un élément de ligne. Les choix comprennent :

Ajouter une ligne
Supprimer une ligne
Déplacer la ligne en cours au dessus
Déplacer la ligne en cours en dessous
Déplacer la ligne en cours en haut de liste
Déplacer la ligne en cours en bas de liste

Couper, Copier et Coller

Activé une fois que vous avez cliqué sur un élément de ligne. Les choix comprennent :

Couper une ligne - supprime et copie dans le presse-papiers.
Copie une ligne dans le presse-papiers.
Colle une ligne depuis le presse-papiers.

Copier, copier et coller peuvent être utilisés au sein d'un Transformer ou entre Transfromers.

Filtre

Commencez à taper une chaîne de caractères, et la matrice n'affichera que les lignes correspondant à ces caractères. Recherche dans toutes les colonnes. Cela n'affecte que l'affichage des attributs dans le Transformer - cela ne change pas les attributs qui sont sortis.

Importer

Le bouton d'import remplit la table avec un jeu de nouveaux attributs lus depuis un jeu de données. L'application spécifique varie selon les Transformers.

Réinitialiser/Rafraîchir

Réinitialise la table à son état initial, et peut fournir des options additionnelles pour supprimer des entrées invalides. Le comportement varie d'un Transformer à l'autre.

Note : Tous les outils ne sont pas disponibles dans tous les Transformers.

Comportement	Basé sur le regroupement
Stockage des entités	Oui
Dépendances
Alias
Historique

PointOnAreaOverlayer

Cas d'utilisation courants

Comment fonctionne-t-il ?

Exemples

Notes

Choisir un Transformer spatial

Configuration

Ports en entrée

Ports de sortie

Paramètres

Éditer les paramètres des Transformers

Références

FME Community