VectorOnRasterOverlayer
Rasterise des entités vectorielles ou des nuages de points sur une image raster existante. Pour les entités vectorielles, l'attribut fme_color définit la couleur des pixels, et les nuages de points peuvent être rendus en utilisant leurs composantes de couleur ou d'intensité.
Cas d'utilisation courants
- Impression de données vectorielles sur un fond raster existant (orthophotos, par exemple).
- Mise à jour d'images rasters depuis de données vectorielles.
Comment fonctionne-t-il ?
VectorOnRasterOverlayer reçoit des géométries vectorielles (points, lignes, surfaces) et/ou nuages de points et les rasterise en une entité raster pour ne produire qu'une seul raster en sortie.
Pour les entités à entrée vectorielle, l'attribut fme_color détermine la couleur du pixel dans le raster. Les valeurs de pixel pour les bandes rouges, vertes et bleues seront tirées de la composante correspondante de l'attribut fme_color d'une entité. Les valeurs de pixel pour les bandes grises seront la moyenne des composants fme_color.
Les entités surfaciques peuvent aussi avoir un attribut fme_fill_color; dans ce cas, la limite extérieures sera dessinée en utilisant fme_color et la surface intérieure sera dessinée en utilisant fme_fill_color.
Pour les nuages de points, la coloration des pixels peut être effectuée en utilisant soit la couleur soit l’intensité des composants.
Les coordonnées Z des entités vecteur entrantes sont utilisées pour générer les valeurs des pixels des bandes numériques.
Les poids de ligne ne sont pas supportés et les entités seront dessinées à une largeur d'un (1) pixel. Les lignes et les points peuvent être mis en mémoire tampon avant d'entrer dans le Transformer pour augmenter leur visibilité.
Des options de valeur alpha et d'anticrénelage sont disponibles. La résolution, l'étendue et l'interprétation du raster de sortie seront identiques au raster d'entrée.
Les étendues de données vectorielles n'ont pas besoin de correspondre aux étendues du raster - si elles dépassent le raster, elles seront découpées.
Les attributs des entités vectorielles ou nuages de points en entrée peuvent être fusionnées dans le raster générée avec une option d'attribut de liste disponible.
Les entités sans attribut couleur (ou nuages de points sans composant d'intensité) seront rejetés et ressortiront par le port <Rejected>, tout comme les images rasters invalides ou supplémentaires.
Les rasters agrégés ne sont pas supportés, mais ils peuvent être désagrégés et mosaïqués avant d'entrer dans le Transformer. Les données vectorielles agrégées peuvent être rasterisées, mais peuvent produire des enregistrements en double si un attribut de liste est créé.
Les rasters avec palettes ne sont pas supportés.
Ce Transformer prend en charge la sélection de bandes raster. Un RasterSelector peut être utilisé pour modifier la sélection.
Exemples
Dans cet exemple, nous allons superposer un ensemble de polygones de parcs sur une orthoimage. Les parcs sont contenus dans un fichier Mapinfo TAB.
Notez que l'étendu du jeu de données Parcs couvre une plus grande zone que l'orthoimage.
Les fichiers TAB peuvent stocker des informations sur la couleur des entités, contrairement aux fichiers de forme (par exemple). Les entités sans couleurs assignées doivent être colorées dans le traitement à l'aide de FeatureColorSetter ou d'une autre méthode.
Les parcs et rasters entrant sont dirigés vers VectoOnRasterOverlayer.
Dans la boîte de dialogue des paramètres, nous activons l'option Générer une liste, nous nommons l'attribut de liste ParksInArea la zone et nous sélectionnons un seul attribut - ParkName - à ajouter à la liste. Les autres paramètres sont laissés à leur valeur par défaut.
Dans le raster de sortie, les polygones des parcs sont rendus sur l'image, et ils ont été coupés au-delà des limites du raster d'entrée. Notez l'attribut liste contenant les noms des parcs qui ont été inclus.
Notes
- Pour rasteriser des données vectorielles/nuages de points et créer un nouveau raster (plutôt que de dessiner sur celui existant), utilisez ImageRasterizer.
- Pour ajouter des étiquettes, vous pouvez utiliser Labeller et TextStroker avant VectorOnRasterOverlayer.
- Pour un contrôle affiné sur la stylisation cartographique, utilisez MapnikRasterizer.
- Si votre raster de fond contient plus d'une image, utilisez RasterMosaicker avant VectorOnRasterOverlayer.
- Pour produire des rasters d'élévation, utilisez NumericRasterizer.
- Pour augmenter la taille et la visibilité des entités vectorielles, utilisez Bufferer.
- Pour colorer un nuage de point depuis un raster, utilisez PointCloudOnRasterComponentSetter.
- Si le raster a une palette, utilisez RasterPaletteResolver avant VectorOnRasterOverlayer.
Choisir un Transformer raster
FME dispose d'une vaste sélection de Transformers pour travailler avec des données rasters. On peut généralement les classer en deux catégories : ceux qui permettent de travailler avec des rasters entiers, des bandes, des cellules ou des palettes, et ceux qui sont conçus pour le contrôle du flux de travail ou la combinaison de données raster et vectorielles.
Pour plus d'informations sur les géométries et propriétés rasters, voir Rasters (IFMERaster).
Travailler avec des rasters
Définit le point d'origine de la cellule dans les cellules d'un raster. |
|
Applique un filtre de convolution (des fois appelé kernel ou lentille) aux entités rasters et met en sortie les résultats. |
|
Évalue les expressions dans chaque cellule d'un raster ou d'une paire de rasters, dont les opérations algébriques et déclarations conditionnelles. |
|
Remplace la géométrie des entités raster en entrée avec un polygone couvrant soit l'étendue d'un raster soit l'étendue des données dans un raster. |
|
Extrait le système de coordonnées du point de contrôle (ou GCP pour Ground Control Point) et fait pointer vers ces valeurs depuis une entité raster pour les exposer ensuite en tant qu'attribut. |
|
Définit les points de contrôle (Ground Control Points - GCP) sur un raster, appariant les positions des cellules avec les coordonnées connues. |
|
Géoréférence un raster soit en fonction des coordonnées ou origines connues d'angles, taille de cellule et rotation. |
|
Génère une représentation en relief et en nuances de gris du terrain selon les valeurs d'élévation. |
|
Altère de type d'interprétation des rasters, incluant toutes les bandes et convertit les valeurs de cellules si nécessaire. |
|
Fusionne plusieurs entités raster en une seule entité. |
|
Extrait les propriétés géométriques de l'entité raster et les stocke sous forme d'attributs. |
|
Rééchantillonne des rasters avec plusieurs résolutions selon le nombre de niveaux ou de dimensions du plus petit raster en sortie. |
|
Transforme une image pour minimiser ses différences avec une autre. |
|
Rééchantillonne les rasters selon les dimensions de sortie spécifiées, de la taille de cellule en unités terrain ou du pourcentage de l’original, puis interpole les nouvelles valeurs de cellules. |
|
Pivote une entité raster selon sa propriété d'angle de rotation, interpolant les nouvelles valeurs de cellules, mettant à jour toutes les autres propriétés rasters affectées et produisant en sortie une entité raster avec un angle de rotation de zéro. |
|
Améliore les entités d'une image raster. RasterSharpener améliore les bords, les lignes et les courbes tout en réduisant le bruit dans les zones plates de l'image matricielle. |
|
Découpe les entités rasters en utilisant une marge intérieure plutôt que les coordonnées terrain, et ajoute optionnellement des cellules autour du périmètre. |
|
Découpe chaque entité raster en entrée en une série de tuiles en spécifiant soit la taille des tuiles en cellules/pixels soit un nombre de tuiles. |
|
Crée des polygones à partir d'entités raster d'entrée. Un polygone est créé pour chaque zone contiguë de pixels ayant la même valeur dans l'image raster d'entrée. |
|
Crée une série de tuiles d'images qui peuvent être utilisées par des applications dewebmapping telles que Bing™ Maps, Google Maps™ ou Web Map Tile Service. Pour ce faire, on rééchantillonne les rasters à diverses résolutions différentes, puis on les divise en tuiles. |
Travailler avec les bandes
Ajoute une nouvelle bande à une entité raster. |
|
Fusionne les entités raster coïncidant en une seule entité raster en sortie, conservant et ajoutant toutes les bandes. |
|
Altère le type d'interprétation pour les bandes rasters individuelles, convertissant les valeurs de cellules si nécessaire. |
|
Supprime toutes les bandes non-sélectionnées d'une entité raster. |
|
Extrait les valeurs de bandes minimum et maximum, les clés de palettes et valeurs de palettes depuis une entité raster et les ajoute à un attribut de liste. |
|
Définit le nom de bande des bandes sélectionnées dans un raster, rendant le contenu raster plus simple à comprendre comparés à des numéros de bandes. |
|
Supprime l'identifiant Nodata existant des bandes sélectionnées d'une entité raster. Toutes les valeurs précédemment égales à la valeur Nodata sont considérées comme des données valides. |
|
Définit une valeur nodata sur les bandes sélectionnées d'une entité raster. |
|
Spécifie l'ordre requis des bandes dans un raster. Les bandes sont réorganisées à partir de l'index des bandes en entrée. |
|
Extrait les propriétés des bandes et des palettes de l'entité raster et les stocke sous forme d'attributs. |
|
Supprime toute bande sélectionnée d'une entité raster. |
|
Sépare les bandes ou bandes uniques et combinaisons de palettes, puis génère soit des entités raster individuelles soit une seule entité raster contenant toutes les combinaisons. |
|
Calcule les statistiques sur des bandes rasters et ajoute les résultats sous forme d'attributs. |
Travailler avec les cellules
Calcule l'aspect (direction de la pente) pour chaque cellule d'un raster. L'aspect est mesuré en degrés de 0 à 360, dans le sens des aiguilles d'une montre à partir du nord. |
|
Crée des points ou polygones individuels pour chaque cellule dans un raster, en extrayant optionnellement les valeurs de bandes en tant que coordonnées z ou attributs. |
|
Evalue des opérations d'arithmétique basique, minimum, maximum ou moyenne sur les valeurs de cellules d'une paire de rasters. |
|
Remplace une plage de valeurs de bandes dans un raster avec une nouvelle valeur unique. |
|
Arrondit les valeurs des cellules raster. |
|
Partitionne une image raster en groupes de cellules tailles arbitraires depuis l'image en entrée selon l'intensité des différences dans les cellules de l'image raster en entrée. |
|
Effectue des opérations arithmétiques sur les valeurs de cellules d'un raster comparées à une valeur numérique. |
|
Calcule la pente (différence maximale en z) pour chaque cellule d'un raster. |
Travailler avec les palettes
Crée une palette à partir d'un attribut, et ajoute cette palette à toutes les bandes sélectionnées du raster. |
|
Créer une représentation sous forme de chaîne de caractères d'une palette existante et l'enregistre dans un attribut. |
|
Génère une palette à partir de la ou des bandes sélectionnées d'un raster. Le raster de sortie aura la ou les bandes sélectionnées remplacées par une nouvelle bande avec une palette. |
|
Altère l'interprétation du type de palettes rasters. |
|
Identifie la clé de palette qui correspond à la valeur Nodata d'une bande d'un raster et y définit une valeur. |
|
Supprime les palettes sélectionnées d'entités rasters. |
|
Résout la ou les palettes sur une trame en remplaçant les valeurs des cellules par leurs valeurs de palette correspondantes. Les valeurs de palette à composantes multiples, telles que RGB, sont décomposées et les valeurs individuelles sont affectées à plusieurs bandes nouvellement ajoutées. |
Contrôle de l'exécution
Force des opérations accumulées de rasters à être traitées, sauvegarde l'état sur le disque puis libère les ressources pour améliorer les performances et aider avec les limitations de mémoire. |
|
Lit les entités rasters à des fins de test, y compris toutes les opérations rasters accumulées. Aucune opération supplémentaire n'est effectuée, et rien n'est fait avec les entités. |
|
Sérialise la géométrie d'une entité raster dans un attribut Blob, encodant le contenu selon un choix de formats rasters binaires classiques. |
|
Crée un raster numérique de la taille et résolution spécifiées avec des valeurs de cellules par défaut. |
|
Décode un attribut binaire contenant des rasters encodés stockés en tant que blobs, puis remplace la géométrie de l’entité avec le raster décodé. |
|
Crée une entité raster couleur de la taille, résolution et type d'interprétation spécifiés avec des valeurs de cellules par défaut. |
|
Sélectionne des bandes et des palettes d'une entité raster pour traitement ultérieur par des Transformers spécifiques. |
Vectoriels et rasters
Crée une représentation raster d'une entité vectorielle ou nuage de point en utilisant l'attribut fme_color sur une fond plein rempli pour les entités vectorielles. Les nuages de points peuvent être rendus en utilisant leurs composantes de couleur ou d'intensité. |
|
Crée une représentation sous forme de raster numérique d'entités entrantes vectorielles ou nuages de points, où les valeurs des cellules sont prises depuis les coordonnées z des entités en entrée et superposées sur une fond uniforme. |
|
Génère un raster depuis des entités rasters ou vectorielles en entrée, avec un contrôle laissé sur la symbolisation et l’étiquetage en utilisant la boîte à outils Mapnik. |
|
Définit les valeurs des composantes du nuage de points en superposant un nuage de points sur une trame. Les valeurs des composantes de chaque point sont interpolées à partir des valeurs de la bande à l'emplacement du point. |
|
Extrait les valeurs de bandes et palettes d'un raster à l'emplacement d'un ou plusieurs des points en entrée et les définit en tant qu'attribut sur l'entité. |
|
Produit un modèle numérique d'élévation (MNE) en effectuant de manière uniforme une triangulation de Delaunay générée depuis des points d'entrée et des lignes de rupture. |
|
Rasterise des entités vectorielles ou des nuages de points sur une image raster existante. Pour les entités vectorielles, l'attribut fme_color définit la couleur des pixels, et les nuages de points peuvent être rendus en utilisant leurs composantes de couleur ou d'intensité. |
Configuration
Ports en entrée
Entités vectorielles ou nuages de points à raster. Les entités vectorielles doivent avoir un attribut fme_color. Les nuages de points doivent avoir une composante de couleur ou d'intensité.
Raster à utiliser comme arrière-plan du raster de sortie. À moins que l'option Regrouper par ne soit utilisée, un seul raster sera accepté. Les agrégats ne sont pas pris en charge.
Cette entité doit être de type raster sinon une erreur apparaît.
Ports de sortie
Raster dessiné à partir d'un groupe d'entités
Les entités invalides seront dirigés vers le port <Rejected>.
Les entités rejetés auront un attribut fme_rejection_code avec l'une des valeurs suivantes :
INVALID_VECTOR_GEOMETRY_TYPE
INVALID_VECTOR_GEOMETRY_INTERPRETATION
INVALID_VECTOR_GEOMETRY_COLOR
INVALID_VECTOR_GEOMETRY_DIMENSION
EXTRA_RASTER_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.
Paramètres
Regrouper par |
Si le paramètre Regrouper par est défini, un raster par groupe est produit. |
||||
Traitement des regroupements |
Sélectionnez le moment du traitement où les groupes sont traités :
Considérations sur l'utilisation de Regrouper par
Il y a deux raisons typiques d'utiliser Quand le groupe change (avancé). La première concerne les données entrantes qui sont destinées à être traitées en groupes (et qui sont déjà classées ainsi). Dans ce cas, c'est la structure qui dicte l'utilisation de Regrouper par - et non des considérations de performance. La seconde raison possible est le potentiel gain de performances. Les gains de performance sont plus visibles quand les données sont déjà triées (ou lues en utilisant une déclaration SQL ORDER BY) puisque moins de travail est requis de la part de FME. Si les données doivent être ordonnées, elles peuvent être triées dans le traitement (bien que la surcharge de traitement supplémentaire puisse annuler tout gain). Le tri devient plus difficile en fonction du nombre de flux de données. Il peut être quasiment impossible de trier des flux de données multiples dans l'ordre correct, car toutes les entités correspondant à une valeur Regrouper par doivent arriver avant toute entité (de tout type d'entité ou jeu de données) appartenant au groupe suivant. Dans ce cas, l'utilisation de Regrouper par avec Lorsque toutes les entités sont reçues peut être une approche équivalente et plus simple. De multiples types d'entités et entités de multiples jeux de données ne vont généralement pas arriver dans l'ordre correct. Comme pour beaucoup de scénarios, tester différentes approches dans votre traitement avec vos données est le seul moyen sûr d'identifier le gain de performance. |
Valeur alpha (0-1) |
Spécifiez la valeur du canal alpha (0-1) pour les entités vectorielles, où 0 est transparent et 1 est opaque. |
Regrouper en utilisant une bande alpha |
Si Oui, les rasters devront avoir une bande alpha sélectionnée. Les entités vectorielles seront alors fusionnées avec le raster sous-jacent en fonction de leurs valeurs alpha, plutôt que de simplement écraser le raster sous-jacent. |
Anticrénelage |
Si Oui, les lignes en sortie seront aplanies en utilisant un algorithme d'anticrénelage |
Tolérance |
Le paramètre Tolérance est la distance maximale normalisée entre un segment de ligne ou un sommet de polygone et un pixel à rendre. Par exemple, une tolérance de 1.0 dessinera tous les pixels touchés par la ligne vectorielle d'entrée, tandis qu'une tolérance de 0.0 dessinera uniquement les pixels où la ligne vectorielle d'entrée passe directement par leur centre. La tolérance ne peut être sélectionnée que lorsque l'anticrénelage est désactivé. |
Composants en entrée |
Lors du dessin de nuages de points, les composants en entrée spécifient quel composant du point doit être utilisé pour définir la couleur du pixel du raster. Si Couleur, les points dans le nuage doivent avoir un composant couleur. Si Intensité, les points du nuage doivent avoir une composante d'intensité. La composante d'intensité est convertie en couleur à l'aide d'un continuum de niveaux de gris, où l'intensité minimale du nuage est noire et l'intensité maximale du nuage est blanche. |
Regrouper les attributs
Si activé, les attributs des entités vectorielles superposées seront fusionnés dans le raster en sortie.
Traitement des attributs |
Regrouper les vecteurs : les attributs de toutes les entités seront regroupés et, en cas de conflit, la valeur de Résolution de conflit sera utilisée. Préfixer les vecteurs : les attributs entrants seront présentés avec un préfixe défini dans le paramètre Préfixe. Remplacer par un vecteur unique : Seuls les attributs des vecteurs seront utilisés. |
Résolution de conflit |
Ce paramètre est activé lorsque le Traitement des attributs vaut Regrouper les attributs. Utiliser les attributs Raster et Utiliser les attributs vecteurs donnent respectivement la priorité aux raster ou vecteur en cas de conflits d'attributs. |
Préfixe |
La valeur est utilisée en tant que préfixe quand Traitement des attributs est Préfixer les vecteurs. |
Génération de liste
Quand activé, ajoute un attribut de liste à l'entité raster en sortie et les attributs des entités superposées sont ajoutées à cette liste, par ordre d'apparence.
Liste |
Entrer un nom de liste. 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 |
Tous les attributs: tous les attributs seront ajoutés aux entités 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 est définie sur Attributs sélectionnés. Indiquez les attributs que vous souhaitez inclure. |
É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.
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.
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.
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.
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. |
Plusieurs fonctions sont disponibles dans les deux éditeurs. | |
Fonctions Date/heure | Les fonctions de dates et heures sont disponibles dans l'Editeur texte. |
Ces opérateur sont disponibles dans l'éditeur arithmétique. | |
Elles retournent des valeurs spécifiques aux entités. | |
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.
Réordonner
|
Activé une fois que vous avez cliqué sur un élément de ligne. Les choix comprennent :
|
Couper, Copier et Coller
|
Activé une fois que vous avez cliqué sur un élément de ligne. Les choix comprennent :
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 |
|
Stockage des entités |
Oui |
Dépendances | Aucun |
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.