SpatialFilter

Filtre des entités points, lignes, surfaciques et texte selon des relations spatiales définies en paramètres.

Chaque entité candidate en entrée est comparée à toutes les entités du filtre, en fonction des tests spatiaux à remplir. Les entités qui réussissent l'un ou l'autre des tests sont produites par le port Passed ; toutes les autres entités sont produites par le port Failed.

Aller à la configuration

Cas d'utilisations typiques

Diriger des entités selon que la définition de la relation spatiale soit vraie ou fausse.
Effectuer un contrôle qualité d'un jeu de données en vérifiant ses relations spatiales avec un autre jeu de données.
Effectuer une jointure spatiale pour transférer des attributs d'une entité à une autre en se basant sur leur relation spatiale.

Comment fonctionne-t-il ?

SpatialFilter compare deux ensembles d'entités pour voir si leurs relations spatiales répondent à certaines conditions de test. Les entités testées (entités candidates) sont identifiées comme ayant réussi ou échoué le test.

Par exemple, si vous avez un jeu de données de routes (lignes) et voulez extraire toutes les routes qui passent par des parcs (polygones), vous redirigeriez les routes dans le port d'entrée Candidate et les parcs dans le port d'entrée Filter.

En sélectionnant les conditions de test Filter OGC-Intersects Candidate et Filter OGC-Contains Candidate, toutes les lignes routières qui se trouvent à l'intérieur des parcs ou qui les croisent sont émises via le port de sortie Passed, et les autres sont émises via le port de sortie Failed. Vous pouvez simultanément extraire un attribut du polygone du parc - le nom du parc, par exemple - et l'ajouter à l'entité ligne.

Exemples

Exemple : trouver les points qui ne sont pas contenus dans des polygones

Dans cet exemple, nous identifions les points d'adresse qui ne sont pas contenus par une empreinte de bâtiment. Les résultats peuvent être utilisés pour trouver les mauvais points d'adresse ou identifier les polygones de bâtiments manquants.

Les deux jeux de données source ressemblent à cela :

Les points d'adresse - le jeu de données à tester - sont connectés au port d'entrée Candidate. Les empreintes des bâtiments sont connectées au port Filter, et fournissent la géométrie par rapport à laquelle les points d'adresse seront testés.

Dans la fenêtre de dialogue SpatialFilter, nous faisons les sélections suivantes :

Type de filtre : Plusieurs filtres Il y a plusieurs polygones de bâtiments que nous voulons tester.
Critères de réussite : Pour au moins un filtre . Chaque point d'adresse ne doit se trouver qu'à l'intérieur d'un seul polygone, et non de tous les polygones.
Prédicats spatiaux à tester : Filter OGC-Contains Candidate. Nous voulons vérifier si chaque candidat (point d'adresse) est compris dans un filtre (polygone de construction).

Ce sont les paramètres clés - les autres sont laissés par défaut pour cet exemple.

Les adresses qui passent le test - qui se trouvent à l'intérieur d'un polygone - sont envoyées vers le port Passed, et ont un nouvel attribut appelé _predicate, défini sur "CONTAINS".

Les points d'adresse qui échouent au test - qui sont en dehors de tous les polygones - sont envoyés par le port Failed. Les résultats, avec le style appliqué dans FME Data Inspector, ressemblent à ceci :

Notes

Voir Relations spatiales pour plus d'informations sur les prédicats spatiaux et une illustration des relations spatiales.
Les relations spatiales sont basées sur la spécification de l'OGC et sont donc indéfinies pour les géométries qui ne sont pas valides pour l'OGC.
Les agrégats sont acceptés par un sous-ensemble de prédicats, mais doivent être utilisés avec précaution. Voir Relations spatiales pour plus d'informations.

Choisir un Transformer spatial

De nombreux Transformers peuvent évaluer les relations spatiales et effectuer des jointures spatiales - en analysant la topologie, en fusionnant les attributs et parfois en modifiant la géométrie. En général, le choix de celui qui est le plus spécifique à la tâche que vous devez accomplir fournira les résultats de performance optimaux. S'il existe plus d'une façon de procéder (ce qui est souvent le cas), il peut être utile de consacrer du temps à tester les performances des autres méthodes.

Pour analyser correctement les relations spatiales, toutes les entités doivent être dans le même système de coordonnées. Reprojector peut être utile pour reprojeter des entités dans le traitement.

Matrice de comparaison des 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	Trouve des intersections entre lignes et polygones et les fractionne en lignes là où elles intersectent les polygones.
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.

Configuration

Ports en entrée

Ports de sortie

Paramètres

Traitement par groupe

Regrouper par

Si les attributs Regrouper par sont spécifiés, les candidats sont uniquement comparés aux filtres ayant les mêmes valeurs dans ces attributs. Les candidats et les filtres doivent avoir des noms d'attributs et des valeurs identiques.

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.

Tests

Type de filtre	Le paramètre Type de filtre définit si une seule entité de Filtre est fournie ou si plusieurs entités sont utilisées. Plusieurs filtres – SpatialFilter présume que les entités candidates et de filtre peuvent arriver dans n'importe quel ordre, et doit attendre que tous les entités soient entrées avant de procéder au filtrage. Filtres en premier –le SpatialFilter part du principe que toutes lesentités du filtre entrent avant les candidats, et de la sorte est en de mesure de traiter les éléments candidats dès leur arrivée. Filtre unique – SpatialFilter présume qu'après l'entrée de la première et unique entité de filtre, toutes les autres entrent par le port Candidate, et de la sorte sera capable de les traiter immédiatement après leur arrivée.
Règle de validation	Spécifie si une entité Candidate doit avoir un prédicat correspondant face à toutes les entités Filtres ou contre au moins une.
Géométries supportées	Supporter les agrégats - les géométries multis et agrégées seront prises en charge. Cependant, les seuls prédicats pris en charge seront OGC-Contains, OGC-Disjoint, OGC-Equals, OGC-Intersects, OGC-Touches, et OGC-Within. Les prédicats OGC-Overlaps et OGC-Crosses ne seront pas pris en charge. Les masques à 9 caractères représentant des Matrices à 9 intersections étendues dimensionnellement étendues ne seront pas non plus pris en charge. Supporter tous les prédicats - tous les prédicats décrits dans la page Relations spatiales seront supportés. Cependant, les géométries agrégées et multiples ne seront pas prises en charge.
Prédicats spatiaux à tester	Définit les tests à effectuer. Les choix possibles sont les suivants : Filter OGC-Intersects Candidate Filter OGC-Equals Candidate Filter OGC-Touches Candidate Filter OGC-Contains Candidate Filter is OGC-Within Candidate Filter OGC-Crosses Candidate Filter OGC-Overlaps Candidate Filter is OGC-Disjoint From Candidate Si le mode de support est Supporter tous les prédicats, vous pouvez également tester les relations en utilisant des masques arbitraires à 9 caractères. Ces masques sont constitués des lignes d'une Matrice à 9 intersections étendu dimensionnellement. Notez que pour utiliser ces masques avec SpatialFilter, vous devez les affecter à un attribut des entités candidates et inclure la valeur de cet attribut dans la clause Tests à effectuer (vous ne pouvez pas les spécifier directement). Vous pouvez spécifier plusieurs prédicats dans un attribut en les séparant par un espace. Pour plus d'informations sur les prédicats, voir Relations spatiales.
Utiliser le rectangle englobant	Ce paramètre définit si les tests doivent être réalisés en utilisant les coordonnées exactes des entités Candidates ou leur rectangle englobant.
Règle des limites courbes	Cet attribut spécifie comment déterminer la limite des géométries de type courbe et multicourbe. La règle par défaut est que tous les points d'extrémité de la courbe qui apparaissent un nombre impair de fois dans l'ensemble de la géométrie seront considérés comme sa limite - c'est-à-dire qu'une boucle linéaire (une ligne dont le point de départ est égal à son point d'arrivée) n'aura pas de limite. L'autre règle spécifie que la limite de la courbe ou de la multicourbe est l'ensemble de tous ses points d'extrémité.

Regrouper les attributs

Définit si la fusion des attributs aura lieu. Si cette option est activée, chaque candidat qui correspond à un filtre reçoit les attributs de ce filtre. Le résultat est une opération connue sous le nom de jointure spatiale.

Traitement des attributs

Activé si l'on fusionne des attributs. Les options comprennent :

Fusionner le filtre : L'entité candidate conservera tous ses attributs non conflictuels et acquerra en plus tous les attributs non conflictuels de l'entité filtre. Ce mode traitera les attributs conflictuels en fonction du paramètre de résolution des conflits.
Filtre préfixe : L'entité candidate conservera tous ses propres attributs. En outre, le candidat acquerra des attributs reflétant les attributs de l'entité filtrée, avec le nom préfixé par le paramètre Préfixe.
Un seul filtre : Tous les attributs de l'entité candidate seront supprimés, à l'exception des attributs géométriques qui commencent par fme_. Ensuite, tous les attributs et les valeurs associées de l'entité filtre seront placés sur l'entité candidate.

Résolution de conflit

Activé si l'on fusionne des attributs. Les options comprennent :

Utiliser les attributs Candidat : si un conflit d'attributs apparaît, les valeurs des entités candidates sont conservées.
Utiliser les attributs Filtre : si un conflit d'attributs apparaît, les valeurs des attributs des filtres seront transférées aux entités d'origine.

Préfixe

Activé si la fusion des attributs et le mode d'accumulation sont définis sur Préfixe le filtre. Définit un préfixe à ajouter à tous les attributs qui sont fusionnés des Filtres aux Candidats.

Avancé

Conserver l'ordre des entités

Ce paramètre contrôle l'ordre dans lequel les entités quittent un Transformer.

Lorsqu'un Transformer a plus d'un port de sortie, les entités sortent généralement d'un port à la fois. Parfois, il peut être utile de garder l'ordre dans lequel les entités sont arrivées, en passant d'un port à l'autre si nécessaire. Cela permet de préserver l'ordre des entités, mais au prix d'une perte potentielle d'efficacité du traitement.

Sélectionner une méthode pour l'ordre des entités :

Par port de sortie (défaut)

Conserve seulement l'ordre d'entrée des entités tel qu'elles interviennent dans le groupe d'entités sortant d'un port de sortie donné.

Toutes les entités sortant d'un port de sortie retienne leur ordre relativement entre elles (dans le groupe) mais pas relativement aux entités sortant par d'autres ports de sortie.

Cette option est généralement la plus efficace quand de grandes quantités de textures sortent d'un port de sortie ensemble (tirant parti du traitement par lots).

Comme les entités sortants par différents ports de sortie peuvent ne pas sortir strictement dans l'ordre dans lequel elles étaient arrivées, l'ordre des ports de sortie peut être imprévisible.

A travers plusieurs ports de sortie

Préserve strictement l'ordre d'entrée des entités, quel que soit le port de sortie. Les entités ressortent une par une dans l'ordre où elles sont arrivées, en passant d'un port à l'autre si nécessaire. Cette option est généralement moins efficace car les gains de traitement du mode traitement par lots sont moins susceptibles de s'appliquer - cependant, l'ordre des entités est prévisible.

Éditer les paramètres des Transformers

À l'aide d'un ensemble d'options de menu, les paramètres du Transformer peuvent être attribués en faisant référence à d'autres éléments de traitement. Des fonctions plus avancées, telles qu'un éditeur avancé et un éditeur arithmétique, sont également disponibles dans certains Transformers. Pour accéder à un menu de ces options, cliquez sur à côté du paramètre applicable. Pour plus d'informations, voir Options de menus et paramètres de Transformer.

Définir les valeurs

Il existe plusieurs façons de définir une valeur à utiliser dans un Transformer. La plus simple est de simplement taper une valeur ou une chaîne de caractères, qui peut inclure des fonctions de différents types comme des références d'attributs, des fonctions mathématiques et de chaînes de caractères, et des paramètres de traitement. Il existe un certain nombre d'outils et de raccourcis qui peuvent aider à construire des valeurs, généralement disponibles dans le menu contextuel déroulant adjacent au champ de valeur.

Définir des valeurs de paramètres

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

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

Outils de tableau

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.

Références

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

FME Community

FME Community est l'endroit où trouver des démos, des tutoriaux, des articles, des FAQ et bien plus encore. Obtenez des réponses à vos questions, apprenez des autres utilisateurs et suggérez, votez et commentez de nouvelles entités.

Voir tous les résultats à propos de ce Transformer sur FME Community.

Les exemples peuvent contenir des informations sous licence Open Government - Vancouver et/ou Open Government - Canada.