Exécution de scripts R

Analysez une table Analytics dans un script R externe, puis renvoyez les données à partir de R pour créer une nouvelle table dans le projet Analytics. Les données source sont transmises à R en tant que cadre de données que vous pouvez référencer à l'aide d'une fonction fournie.

Utilisation des données Analytics dans R

Si vous préparez l'exécution du script R dans Analytics familiarisez-vous avec les méthodes de transmission et de retransmission des données entre Analytics et R. Vous devez utiliser les fonctions de Rvachev fournies par Analytics dans votre script R pour exécuter correctement la commande RCOMMAND.

Référence à des données Analytics dans le script R

La table Analytics est transmise au script sous forme de cadre de données R. Les cadres de données sont des objets de données tabulaires pouvant contenir des colonnes de différents modes - ou types - de données.

Pour utiliser le cadre de données créé par Analytics dans un script R, appelez la fonction acl.readData() et stockez le cadre de données renvoyé dans une variable :

# stocke la table Analytics dans un cadre de données appelé maTable qui peut être référencé tout au long du script
maTable<-acl.readData()

Pour extraire les données d'une cellule dans le cadre de données, vous pouvez utiliser l'une des approches suivantes :

Utilisation des coordonnées de ligne et de colonne :
```
# Extrait la valeur dans la première ligne et la deuxième colonne du cadre de données
maTable[1,2]
```
Remarque

Les coordonnées dépendent de l'ordre des champs indiqué dans la commande et non du format de table ou de la vue ouverte.
À l'aide des noms de ligne et de colonne :
```
# Extrait la valeur de la première ligne et de la colonne « monTitreColonne » du cadre de données
maTable["1";"monTitreColonne"]
```
Vous devez indiquer l'option KEEPTITLE de la commande pour utiliser les noms de table.

Les lignes sont intitulées « 1 », « 2 », « 3 » et incrémentées en conséquence. Vous pouvez également utiliser une combinaison de noms et de coordonnées.

Retransmission de données vers Analytics

Pour renvoyer un cadre de données ou une matrice dans Analytics et créer une nouvelle table, utilisez la syntaxe suivante :

# Retransmet le cadre de données de maNouvelleTable à Analytics pour créer une nouvelle table 
acl.output<-maNouvelleTable

Remarque

Vous devez renvoyer un cadre de données ou une matrice à Analytics lorsque le script R se termine. Assurez-vous que les colonnes du cadre de données ou de la matrice contiennent uniquement des valeurs atomiques et non des listes, des matrices, des tableaux ou des objets non atomiques. Si les valeurs ne peuvent pas être traduites en types de données Analytics, la commande échoue.

Mappage des données R

Les types de données Analytics sont traduits en types de données R à l'aide d'un processus de traduction entre le projet Analytics et le script R :

Type de données Analytics	Type(s) de données R
Logique	Logique
Numérique	Numérique
Caractère	Caractère
DateHeure	Date, POSIXct, POSIXlt

Limitation des performances et des tailles de fichiers

La durée d'exécution du script R et du traitement des données renvoyées est rallongée pour les données d'entrée supérieures à 1 Go. R ne prend pas en charge les fichiers d'entrée de 2 Go ou plus.

Le nombre d'enregistrements envoyés dans R influence aussi les performances. Dans le cas de deux tables présentant une taille de fichier identique mais un nombre d'enregistrements différent, le traitement de la table contenant le moins d'enregistrements sera plus rapide.

Gestion de données de type caractères multi-octets

Si vous envoyez des données à R dans un jeu de caractères multioctets, comme le chinois, vous devez définir le système local de manière approprié dans votre script R. Pour réussir l'envoi d'un table contenant des données multioctets à R, la première ligne du script R doit contenir la fonction suivante :

# Exemple qui définit les paramètres régionaux en chinois
Sys.setlocale("LC_ALL";"Chinois")

Pour obtenir plus d'informations sur Sys.setlocale( ), voir la documentation R.

Exemple Bonjour le monde

Commande Analytics

RCOMMAND FIELDS "Bonjour"; ", le monde !" TO "r_résultat" RSCRIPT "C:\scripts\r_scripts\analyse.r"

Script R (analyse.r)

srcTable<-acl.readData()

# créer une table à renvoyer dans ACL
output<-data.frame(
  c(srcTable[1,1]),
  c(srcTable[1,2])
)

# ajouter les noms des colonnes et renvoyer la table dans ACL
colnames(output) <- c("Bonjour";"Objet")
acl.output<-output

Exécuter un script R

Dans le menu, sélectionnez Analyser > R.
La boîte de dialogue RCOMMAND s'ouvre.
En regard du champ Script R, cliquez sur Parcourir, localisez sur votre ordinateur le script R que vous souhaitez exécuter.
Cliquez sur Sélectionner les champs et ajoutez un ou plusieurs champs à inclure dans le cadre de données qu'Analytics met à disposition dans le script R.
Astuce
Vous pouvez aussi inclure des expressions comme des champs dans le cadre de données. Pour créer une expression, cliquez sur Expr et utilisez les fonctions, champs et opérateurs à votre disposition dans la boîte de dialogue. Pour plus d'informations, consultez la rubrique Présentation du générateur d'expression.
Facultatif. Dans la section Options RCOMMAND, définissez comment vous souhaitez envoyer les données Analytics au script R.
Pour plus d'informations, consultez la section Options RCOMMAND.
Facultatif. Pour filtrer les enregistrements qui sont envoyés au script R, cliquez sur Si et utilisez la boîte de dialogue Générateur d'expression pour créer une expression conditionnelle à utiliser comme filtre.
Pour plus d'informations sur la création des expressions à l'aide du Générateur d'expression, consultez la rubrique Création d'expressions à l'aide du Générateur d'expression.
Pour indiquer la table de sortie, cliquez sur Vers, puis dans le champ Nom de fichier, saisissez un nom pour la table et le fichier .FIL associé.
Utilisez l'explorateur de dossiers pour accéder au dossier à utiliser pour stocker le fichier de données source.
Facultatif. Dans l'onglet Plus de la boîte de dialogue, indiquez des options d'étendue pour la commande.
Pour plus d'informations, consultez la section Onglet Plus.
Pour exécuter la commande, cliquez sur OK.

Options de la boîte de dialogue RCOMMAND

Options RCOMMAND

Option	Description
Exporter avec les noms de champs	Utilisez les titres de colonne de la table Analytics source comme valeurs d'en-tête pour le cadre de données R. Cette option définit l'option KEEPTITLE sur la commande et est requise si vous souhaitez récupérer les données à l'aide des noms des colonnes dans le script R.
Séparateur de colonnes	Caractère à utiliser comme séparateur entre les champs lors de l'envoi des données à R.
Identificateur de texte	Caractère à utiliser comme identificateur de texte pour identifier les valeurs des champs lors de l'envoi des données à R.

Onglet Plus

Option	Description
Toutes	Traite tous les enregistrements dans la vue (sélection par défaut).
Premier	Traite à partir du premier enregistrement de la table et inclut uniquement le nombre d'enregistrements indiqué.
Suivant	Traite à partir de l'enregistrement actuellement sélectionné dans la table et inclut uniquement le nombre d'enregistrements indiqué. Remarque Le nombre d'enregistrements indiqué dans les options Premier ou Suivant fait référence à l'ordre physique ou d'indexation des enregistrements dans une table, quels que soient les filtres ou les tris express appliqués à la vue. Toutefois, les résultats des opérations analytiques tiennent compte de tous les filtres appliqués. Si un tri express est appliqué à une vue, l'option Suivant se comporte comme l'option Premier. Attention Dans la version actuelle, il existe un problème connu avec l'option Suivant lors de l'exécution de RCOMMAND. Éviter d'utiliser cette option comme référence d'enregistrement peut rétablir la valeur sur le premier enregistrement, quel que soit l'enregistrement sélectionné.
Instruction WHILE	Utilisez une instruction WHILE pour limiter le traitement des enregistrements de la table principale selon des critères. Les enregistrements de la vue sont traités uniquement tant que la condition indiquée est vraie. Dès que la condition est fausse, le traitement s'arrête et aucun autre enregistrement n'est pris en compte. Pour plus d'informations, consultez la section Création d'expressions à l'aide du Générateur d'expression.

[ Retour au début ]

Aide d'Analytics 14.1