RCaller

list<-c(1,2,2,2,2,3,3,3)

fmeOutput<-data.frame(mean=mean(list), median=median(list))

Notez que dans l'exemple ci-dessus, vous pouvez associer une liste à la valeur d'une colonne numérique de table (par exemple list<-myInput$testColumn)

La sortie du script sera une unique entité avec en sortie moyenne et median

Imaginons avoir, comme données sources, des données relatives à des arbres dont le diamètre des troncs dans l'attribut Diamètre.

Si le jeu de données est Arbres, lors de la connexion de ce jeu de données à RCaller, un port d'entrée Arbres sera créé.

Assurez-vous que l'attribut Diamètre apparaisse bien dans la table Entrée.

Dans la section R Script, spécifier fmeOutput<-data.frame(MeanDiameter=mean(Trees$Diameter)) permettra de calculer le diamètre moyen des arbres.

Spécifier MeanDiameter dans le paramètre Attributs à exposer permet d'exposer l'attribut Moyenne de sorte à l'utiliser dans la suite du traitement.

Télécharger l'installeur R :

https://www.r-project.org/

Windows :

Installer R sous Windows.

Pour plus d'information consulter https://cran.r-project.org/bin/windows/base/.

macOS :

Pour installer R sous Mac OS, vous pouvez télécharger :

https://www.r-project.org/

Ou utiliser la commande de gestion de package :

brew install R

Pour cela, le gestionnaire de paquets homebrew doit être installé sur le système. Homebrew peut être téléchargé à partir de :

https://brew.sh/

Linux :

Exécuter /opt/<FME version>/utilities/rcaller_setup from the command line (for example, /opt/fme-desktop-2020/utilities/rcaller_setup)

Le script de configuration Linux dans la section Installation de l'interpréteur R installera les paquets R les plus utilisés. Si d'autres sont nécessaires, essayez d'abord de les installer via les paquets système r-cran-* (souvent disponibles sur Debian et Ubuntu). Ce n'est que si un paquet système n'existe pas qu'ils doivent être installés via les instructions de l'invite de commande R ci-dessous.

1. Ouvrir l'invite de commande R
   • Windows : Exécuter l'interface graphique R en tant qu'administrateur en cliquant avec le bouton droit de la souris dans le menu Démarrer et en sélectionnant "Exécuter en tant qu'administrateur..." .
   • Linux/macOS : Lancez la console R (en tant que root, sauf si R a déjà été configuré pour trouver des paquets par utilisateur).
2. Exécutez la commande suivante à l'invite de commande de R :
   
   install.packages("<nom du paquet>")
   
   Par exemple :
   
   install.packages("sqldf")
3. Cela lancera une fenêtre vous invitant à sélectionner un miroir de téléchargement. Une fois le miroir sélectionné, le paquetage sera installé dans la bibliothèque R du système. Il est important que cette opération soit effectuée avec des privilèges administratifs, sinon le paquetage sera installé dans une bibliothèque utilisateur et FME ne pourra pas l'utiliser.
4. Pour vérifier que le paquet a été installé correctement, vérifiez l'emplacement indiqué lorsque vous exécutez
   
   .libPaths()
   
   sur la ligne de commande. Il doit y avoir un dossier appelé "<nom du paquet>".

En option, vous pouvez placer vos bibliothèques R dans un dossier de ressources partagées. L'emplacement racine de ce dossier est défini dans FME Workbench sous Outils > Options FME > Chemins par défaut > Dossiers FME partagés. Dans la structure des dossiers FME partagés, les packages R doivent être placés dans le répertoire R, situé sous un répertoire Plugins. Vous devrez peut-être créer manuellement ces répertoires :

<Shared_FME_Folder>\Plugins\R

Pour plus d'informations, voir Chemins par défaut.

RCaller nécessite la définition d'une ou plusieurs tables, qui deviendront des ports d'entrée pour le Transformer. Le bouton Importer... offre un moyen rapide de remplir les définitions des tables d'entrée à partir des types d'entités sources dans le traitement.

Notez que certains noms d'attributs et de tables FME peuvent ne pas être valides dans R comme noms de colonnes ou de cadres de données (notamment les noms d'attributs commençant par un trait de soulignement "_"). Pour éviter tout problème, ces noms seront convertis en noms R valides. Les noms ajustés seront affichés dans la section Data frames à gauche de l'éditeur de script.

RCaller a un seul port de sortie. Les attributs créés dans le script doivent être saisis par l'utilisateur dans le paramètre Attributs à exposer afin qu'ils apparaissent dans les Transformers suivants ou dans la vue tableau de FME Data Inspector. Les attributs définis sur l'entité sont déterminés par les colonnes définies dans le cadre de données fmeOutput au moment de l'exécution. Un éditeur utile est utilisé pour construire le script R, et fournit un accès pratique par glisser-déposer aux cadres de données, aux colonnes, et aux paramètres publiés et privés qui peuvent être utilisés dans le script.

Le nombre d'entités produites dépendra de la longueur de la plus grande colonne du cadre de données fmeOutput. De cette façon, le RCaller peut être utilisé pour sortir une seule valeur, une liste ou une matrice de valeurs.

Lorsque le package R raster est chargé, les rasters sont pris en charge en entrée et en sortie. En entrée, la géométrie raster dans FME sera convertie en un objet RasterBrick dans R sous la colonne raster de cette table. Autrement dit, la colonne InputTableName$raster contiendra un objet RasterBrick pour chaque entité ayant une géométrie raster, et NA pour chaque entité n'en ayant pas. En sortie, les objets raster de la colonne fmeOutput$raster de R seront convertis en géométrie raster dans FME.

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.