R Référence de l'API

Documentation sur les classes et les méthodes du package mtbr pour R.

Sur ce thème

Package: mtbr
Conversion d’un format de date Minitab en format de date R
Erreurs issues des ensembles de caractères combinés sur Microsoft® Windows

Pour accomplir l'intégration de R avec Minitab Statistical Software, Minitab, LLC. fournit le package mtbr. Les descriptions suivantes des classes et des méthodes du package mtbr vous préparent à l’écriture de code R qui s’intègre à Minitab.

Pour plus d'informations sur la façon d'installer la bibliothèque R de Minitab et la façon d'exécuter R à partir de Minitab, rendez-vous sur Installation de R pour une utilisation avec Minitab Statistical Software.

Pour plus d'informations sur R, consultez la documentation disponible sur www.r-project.org.

Package: mtbr

`mtb_get_column`

Récupère une colonne à partir d'une feuille de travail Minitab pour l'utiliser dans R.

name: character: Spécifie la colonne à récupérer. Vous pouvez spécifier soit le numéro de la colonne (par exemple, "C1") soit le nom de la colonne (par exemple, "Ma colonne").

Valeur renvoyée

Renvoie la colonne de données de la feuille de travail active sous forme de atomic vectorR. Ils atomic vector peuvent contenir des valeurs de caractères ou numériques.

Exemple

library(mtbr) column1 <- mtb_get_column("C1") column2 <- mtb_get_column("My Column")

`mtb_get_constant`

Récupère une constante à partir d'une feuille de travail Minitab pour l'utiliser dans R.

name: character: Spécifie la constante à récupérer. Vous pouvez spécifier soit le numéro de la constante (par exemple, "K1") soit le nom de la constante (par exemple, "Ma constante").

Valeur renvoyée

Renvoie une constante qui peut être soit un caractère, un entier ou une valeur numérique.

Exemple

library(mtbr) constant1 <- mtb_get_constant("K1") constant2 <- mtb_get_constant("My Constant")

`mtb_get_matrix`

Récupère une matrice d'une feuille de travail Minitab pour l'utiliser dans R.

name: character: Spécifie la matrice à récupérer. Vous pouvez spécifier soit le numéro de la matrice (par exemple, "M1") soit le nom de la matrice (par exemple, "Ma matrice").

Valeur renvoyée

Renvoie les données de la matrice sous forme de Rmatrix.

Exemple

library(mtbr) matrix1 <- mtb_get_matrix("M1") matrix2 <- mtb_get_matrix("My Matrix")

`mtb_add_message`

Ajoute un message au panneau des résultats de Minitab.

message: character: Spécifie le message à afficher.

Valeur renvoyée

Null

Exemple

library(mtbr) mtb_add_message("This is a message.")

`mtb_set_note`

Ajoute une remarque en haut du panneau des résultats de Minitab.

note: character: Spécifie le texte à afficher.

Valeur renvoyée

Null

Exemple

library(mtbr) mtb_set_note("The output contains one note.")

`mtb_set_title`

Ajoute un titre en haut du panneau des résultats de Minitab.

title: character: Spécifie le texte à afficher.

Valeur renvoyée

Null

Exemple

library(mtbr) mtb_set_title("The output contains one title.")

`mtb_add_image`

Ajoute une image au panneau des résultats de Minitab lorsque vous disposez d’un fichier d’image pris en charge.

filename: character: Spécifie le chemin vers l’image.

Valeur renvoyée

Null

Exemple

library(mtbr) png("histogram.png") hist(airquality$Temp) dev.off() mtb_add_image("histogram.png")

`mtb_add_image_bytes`

Ajoute une image au panneau des résultats de Minitab lorsque vous disposez d’un objet d’octets.

image_bytes: raw vector: Spécifie les octets de données pour une image. Par exemple, vous pouvez entrer un raw vector paramètre comme paramètre.

Valeur renvoyée

Null

Exemple

library(mtbr) image_data <- as.raw(c(0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a, 0x00, 0x00, 0x00, 0x0d, 0x49, 0x48, 0x44, 0x52, 0x00, 0x00, 0x00, 0x09, 0x00, 0x00, 0x00, 0x09, 0x08, 0x02, 0x00, 0x00, 0x00, 0x6f, 0xf3, 0x91, 0x47, 0x00, 0x00, 0x00, 0x01, 0x73, 0x52, 0x47, 0x42, 0x00, 0xae, 0xce, 0x1c, 0xe9, 0x00, 0x00, 0x00, 0x04, 0x67, 0x41, 0x4d, 0x41, 0x00, 0x00, 0xb1, 0x8f, 0x0b, 0xfc, 0x61, 0x05, 0x00, 0x00, 0x00, 0x09, 0x70, 0x48, 0x59, 0x73, 0x00, 0x00, 0x16, 0x25, 0x00, 0x00, 0x16, 0x25, 0x01, 0x49, 0x52, 0x24, 0xf0, 0x00, 0x00, 0x00, 0x22, 0x49, 0x44, 0x41, 0x54, 0x18, 0x57, 0x63, 0xd8, 0x61, 0xbb, 0x8b, 0x81, 0x01, 0x27, 0x49, 0xba, 0x04, 0x01, 0x69, 0x9c, 0x12, 0x04, 0xa4, 0x71, 0x4a, 0x10, 0x90, 0xc6, 0x29, 0xb1, 0xc3, 0x76, 0x17, 0x00, 0xfc, 0x0b, 0x45, 0x08, 0x6f, 0x2c, 0xff, 0xe2, 0x00, 0x00, 0x00, 0x00, 0x49, 0x45, 0x4e, 0x44, 0xae, 0x42, 0x60, 0x82)) mtb_add_image_bytes(image_data)

`mtb_add_table`

Ajoute un tableau au panneau des résultats de Minitab.

columns: data.frame or list of atomic vectors: Définit les colonnes de données du tableau sous forme de list de atomic vectors ou de data.frame.
headers: character vector (Optional): Définit les en-têtes de colonnes du tableau. La valeur par défaut de headers est une character vector vide.
title: character (Optional): Définit le titre de la table. La valeur par défaut de title est "".
footnote: character (Optional): Définit le commentaire sous le tableau. La valeur par défaut de footnote est "".

Valeur renvoyée

Null

Exemple

library(mtbr) mytitle <- "Air Quality Data" myheaders <- names(airquality) mycolumns <- airquality myfootnote <- gsub("\"", "", paste0(capture.output(summary(airquality)[4,]), collapse = "\n")) mtb_add_table(columns=mycolumns, headers=myheaders, title=mytitle, footnote=myfootnote)

Conversion d’un format de date Minitab en format de date R

Par défaut, Minitab utilise un format datetime différent de celui de R. Pour convertir le format datetime de Minitab au format datetime Unix, utilisez la fonction excel_numeric_to_date() du package janitorR :

Erreurs issues des ensembles de caractères combinés sur Microsoft® Windows

R on Microsoft® Windows ne peut pas toujours traiter les chaînes contenant des caractères issus de différents ensembles de caractères. Par exemple, si Microsoft® Windows on utilise le jeu de caractères japonais (Shift-JIS) et qu’une chaîne inclut des caractères du jeu chinois (GBK), certaines chaînes ne seront pas traitées correctement.

En raison de cette limitation, une solution possible est que les chaînes utilisent des caractères issus du même jeu de caractères que le langage d’affichage Microsoft® Windows .