PROJAttributeReprojector

Des fichiers de grilles de correction peuvent être stockés localement si cela est préféré.

La page de téléchargement du site PROJ comprend des grilles, dans des archives nommées proj-data*.*. Pour les utiliser :

1. Téléchargez une archive proj-data. La version Current Release est généralement appropriée. N'utilisez pas les archives proj-datumgrid*.* plus anciennes.

2. Extrayez le contenu de l'archive dans le répertoire ProjData (ou un sous-répertoire de celui-ci) dans le répertoire utilisateur de FME, par système d'exploitation :
   ~/.fme/ProjData sur Linux
   ~/Library/Application Support/FME/ProjData sur macOS
   Documents/FME/ProjData sur Windows

Les grilles ajoutées de cette manière seront considérées avant les grilles en ligne (si elles sont activées). Elles seront également considérées en premier par ordre de préférence, à moins qu'un chemin absolu ou relatif ou une URL soit spécifié dans la définition de la transformation.

FME accède aussi à des grilles PROJ en ligne sur cdn.proj.org.

L'accès en ligne peut être activé ou désactivé via le menu FME Form - Outils > Options FME > Systèmes de coordonnées :

PROJ va chercher une grille appropriée, qui peut être accessible à plusieurs endroits. L'ordre de recherche est le suivant :

• Si la définition de la transformation contient un chemin absolu ou relatif vers un fichier de décalage de grille, seul ce fichier sera pris en compte. S'il ne peut être trouvé, le traitement se termine par une erreur.

• Si la définition de la transformation contient une URL pour le fichier shift de la grille (c'est-à-dire, commençant par http:// ou https://) ), PROJ tentera de télécharger le fichier. S'il ne peut être trouvé, le traitement se termine par une erreur.

• Si la définition de la transformation ne contient qu'un nom de fichier de grille sans chemin ou URL, PROJ cherchera dans cet ordre :

  1. Chemins de recherche configurés par FME :

     • - répertoire Reproject dans le répertoire d'installation

     • - répertoire ProjData dans le répertoire d'utilisateur FME

  2. Le répertoire enregistrable par l'utilisateur, tel que :

     • AppData/Local/proj sur Windows

     • ~/.local/share/proj sur Linux
     • ~/Library/Application Support/proj sur macOS

  3. La liste des répertoires spécifiés dans la variable d'environnement PROJ_LIB .

  4. Le répertoire dans lequel le fichier de le traitement FME est stocké.

  5. Si le nom du fichier n'est pas trouvé, PROJ recherchera les alias connus dans le même ordre :

     • ex: ca_nrc_ntv2_0.tif a pour alias ntv2_0.gsb

  6. Si aucun alias connu n'est trouvé, et que l'option Grilles en ligne est activée, PROJ tentera de télécharger la grille à partir du point de terminaison CDN spécifié.

  7. Si la mise en réseau échoue, alors les options de PROJ sont épuisées et une erreur est renvoyée.

Dans cet exemple, nous commençons avec un fichier CSV de sites historiques. Il n'a pas de géométrie, mais il contient les coordonnées des sites, avec un système de coordonnées UTM Zone 10 NAD27. Nous voulons le reprojeter en NAD83, en utilisant PROJ.

Les entités sont connectées à PROJAttributeReprojector.

Dans la fenêtre de paramètres, leType de transformation vaut manuelle.

La chaîne de caractères PROJ requise est saisie, qui fait référence à la fois aux définitions des systèmes de coordonnées source et destination et au fichier de décalage de grille souhaité.

Les attributs X et Y contenant les coordonnées sont identifiés.

Les nouvelles coordonnées sont calculées à l'aide de la bibliothèque PROJ, et remplacent les valeurs d'attributs existantes. Le Transformer ne crée pas de géométrie, il ne fait que fournir des valeurs.

L'exemple précédent pourrait également être réalisé en utilisant le texte connu (WKT2) pour décrire la transformation.

Description Transformation WKT2

CONCATENATEDOPERATION["Inverse of UTM zone 10N + NAD27 to NAD83 (4) + UTM zone 10N",
    SOURCECRS[
        PROJCRS["NAD27 / UTM zone 10N",
            BASEGEOGCRS["NAD27",
                DATUM["North American Datum 1927",
                    ELLIPSOID["Clarke 1866",6378206.4,294.978698213898,
                        LENGTHUNIT["metre",1]]],
                PRIMEM["Greenwich",0,
                    ANGLEUNIT["degree",0.0174532925199433]],
                ID["EPSG",4267]],
            CONVERSION["UTM zone 10N",
                METHOD["Transverse Mercator",
                    ID["EPSG",9807]],
                PARAMETER["Latitude of natural origin",0,
                    ANGLEUNIT["degree",0.0174532925199433],
                    ID["EPSG",8801]],
                PARAMETER["Longitude of natural origin",-123,
                    ANGLEUNIT["degree",0.0174532925199433],
                    ID["EPSG",8802]],
                PARAMETER["Scale factor at natural origin",0.9996,
                    SCALEUNIT["unity",1],
                    ID["EPSG",8805]],
                PARAMETER["False easting",500000,
                    LENGTHUNIT["metre",1],
                    ID["EPSG",8806]],
                PARAMETER["False northing",0,
                    LENGTHUNIT["metre",1],
                    ID["EPSG",8807]]],
            CS[Cartesian,2],
                AXIS["(E)",east,
                    ORDER[1],
                    LENGTHUNIT["metre",1]],
                AXIS["(N)",north,
                    ORDER[2],
                    LENGTHUNIT["metre",1]],
            ID["EPSG",26710]]],
    TARGETCRS[
        PROJCRS["NAD83 / UTM zone 10N",
            BASEGEOGCRS["NAD83",
                DATUM["North American Datum 1983",
                    ELLIPSOID["GRS 1980",6378137,298.257222101,
                        LENGTHUNIT["metre",1]]],
                PRIMEM["Greenwich",0,
                    ANGLEUNIT["degree",0.0174532925199433]],
                ID["EPSG",4269]],
            CONVERSION["UTM zone 10N",
                METHOD["Transverse Mercator",
                    ID["EPSG",9807]],
                PARAMETER["Latitude of natural origin",0,
                    ANGLEUNIT["degree",0.0174532925199433],
                    ID["EPSG",8801]],
                PARAMETER["Longitude of natural origin",-123,
                    ANGLEUNIT["degree",0.0174532925199433],
                    ID["EPSG",8802]],
                PARAMETER["Scale factor at natural origin",0.9996,
                    SCALEUNIT["unity",1],
                    ID["EPSG",8805]],
                PARAMETER["False easting",500000,
                    LENGTHUNIT["metre",1],
                    ID["EPSG",8806]],
                PARAMETER["False northing",0,
                    LENGTHUNIT["metre",1],
                    ID["EPSG",8807]]],
            CS[Cartesian,2],
                AXIS["(E)",east,
                    ORDER[1],
                    LENGTHUNIT["metre",1]],
                AXIS["(N)",north,
                    ORDER[2],
                    LENGTHUNIT["metre",1]],
            ID["EPSG",26910]]],
    STEP[
        CONVERSION["Inverse of UTM zone 10N",
            METHOD["Inverse of Transverse Mercator",
                ID["INVERSE(EPSG)",9807]],
            PARAMETER["Latitude of natural origin",0,
                ANGLEUNIT["degree",0.0174532925199433],
                ID["EPSG",8801]],
            PARAMETER["Longitude of natural origin",-123,
                ANGLEUNIT["degree",0.0174532925199433],
                ID["EPSG",8802]],
            PARAMETER["Scale factor at natural origin",0.9996,
                SCALEUNIT["unity",1],
                ID["EPSG",8805]],
            PARAMETER["False easting",500000,
                LENGTHUNIT["metre",1],
                ID["EPSG",8806]],
            PARAMETER["False northing",0,
                LENGTHUNIT["metre",1],
                ID["EPSG",8807]],
            ID["INVERSE(EPSG)",16010]]],
    STEP[
        COORDINATEOPERATION["NAD27 to NAD83 (4)",
            SOURCECRS[
                GEOGCRS["NAD27",
                    DATUM["North American Datum 1927",
                        ELLIPSOID["Clarke 1866",6378206.4,294.978698213898,
                            LENGTHUNIT["metre",1]]],
                    PRIMEM["Greenwich",0,
                        ANGLEUNIT["degree",0.0174532925199433]],
                    CS[ellipsoidal,2],
                        AXIS["geodetic latitude (Lat)",north,
                            ORDER[1],
                            ANGLEUNIT["degree",0.0174532925199433]],
                        AXIS["geodetic longitude (Lon)",east,
                            ORDER[2],
                            ANGLEUNIT["degree",0.0174532925199433]],
                    ID["EPSG",4267]]],
            TARGETCRS[
                GEOGCRS["NAD83",
                    DATUM["North American Datum 1983",
                        ELLIPSOID["GRS 1980",6378137,298.257222101,
                            LENGTHUNIT["metre",1]]],
                    PRIMEM["Greenwich",0,
                        ANGLEUNIT["degree",0.0174532925199433]],
                    CS[ellipsoidal,2],
                        AXIS["geodetic latitude (Lat)",north,
                            ORDER[1],
                            ANGLEUNIT["degree",0.0174532925199433]],
                        AXIS["geodetic longitude (Lon)",east,
                            ORDER[2],
                            ANGLEUNIT["degree",0.0174532925199433]],
                    ID["EPSG",4269]]],
            METHOD["HORIZONTAL_SHIFT_GTIFF"],
            PARAMETERFILE["Latitude and longitude difference file","ca_nrc_ntv2_0.tif"],
            OPERATIONACCURACY[1.5],
            ID["DERIVED_FROM(EPSG)",1313]]],
    STEP[
        CONVERSION["UTM zone 10N",
            METHOD["Transverse Mercator",
                ID["EPSG",9807]],
            PARAMETER["Latitude of natural origin",0,
                ANGLEUNIT["degree",0.0174532925199433],
                ID["EPSG",8801]],
            PARAMETER["Longitude of natural origin",-123,
                ANGLEUNIT["degree",0.0174532925199433],
                ID["EPSG",8802]],
            PARAMETER["Scale factor at natural origin",0.9996,
                SCALEUNIT["unity",1],
                ID["EPSG",8805]],
            PARAMETER["False easting",500000,
                LENGTHUNIT["metre",1],
                ID["EPSG",8806]],
            PARAMETER["False northing",0,
                LENGTHUNIT["metre",1],
                ID["EPSG",8807]],
            ID["EPSG",16010]]],
    USAGE[
        SCOPE["unknown"],
        AREA["Canada - onshore - Alberta; British Columbia; Manitoba; New Brunswick; Newfoundland and Labrador; Northwest Territories; Nova Scotia; Nunavut; Ontario; Prince Edward Island; Quebec; Saskatchewan; Yukon; offshore east coast."],
        BBOX[40.04,-141.01,83.17,-47.74]]]

Cet exemple montre les paramètres de PROJAttributeReprojector configurés pour utiliser un epoch avec un pipeline PROJ.

Notez que le modèle de déformation souhaité est référencé dans la chaîne de caractères du pipeline.

Les epochs peuvent également être fournies par une valeur d'attribut ou un paramètre publié.

Les systèmes de coordonnées ont généralement un nom et une définition, et la syntaxe de cette définition peut varier considérablement entre les formats de données spatiales et les autres bibliothèques de systèmes de coordonnées. Des systèmes de coordonnées personnalisés et locaux peuvent également être définis dans FME, ce qui complique encore les choses. Pour plus d'informations, consultez la documentation Travailler avec les systèmes de coordonnées.

Les reprojections sont généralement effectuées avec le moteur de reprojection de FME, qui est basé sur la bibliothèque de systèmes de coordonnées CS-Map. Cette valeur par défaut peut être remplacée pour chaque traitement, à l'aide du paramètre Paramètres de traitement > Traitement > Moteur de reprojection, et être définie sur Esri. Le cas échéant, FME utilisera le moteur de reprojection Esri s'il est sélectionné à cet endroit, qu'un produit Esri soit installé ou non.

Support système de coordonnées

Ces Transformers produisent différentes tâches relatives aux systèmes de coordonnées mais ne procèdent pas à de la reprojection.

Reprojection Système de coordonnées

Les différentes bibliothèques de systèmes de coordonnées (moteurs) ne contiennent pas seulement des définitions de systèmes de coordonnées, elles ont aussi des algorithmes de reprojection uniques. Les Transformers de reprojection génériques de FME, dans le premier tableau ci-dessous, utilisent par défaut la bibliothèque FME (CS-Map).

Une sélection d'autres bibliothèques est également disponible, dont certaines sont spécifiques à certaines régions du monde ou à certaines plateformes logicielles.

Les reprojections inhérentes, comme dans un traitement avec différents systèmes de coordonnées d'entrée et de sortie, utilisent par défaut la bibliothèque FME (CS-Map).

Si vous effectuez une reprojection explicite avec un Transformer dans le traitement, il est recommandé d'utiliser des Transformers spécifiques à la bibliothèque. Dans le cas de CsmapReprojector contre Reprojector (avec le moteur par défaut), la bibliothèque peut être identique, mais le CSMapReprojector gère les calculs de coordonnées verticales alors que le Reprojector ne le fait pas.

Transformers de reprojection générique

Transformers de Reprojection Library-Specific (Recommendé)

Entités dont les attributs contiennent les coordonnées à reprojeter.

Les entités avec les attributs reprojetés comme spécifié en 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.

Outils de tableau

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

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