R Référence de l'API

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

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.

column_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. La atomic vector peut contenir des caractères, des entiers ou des valeurs 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.

constant_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.

matrix_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
None
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.

message: character
Spécifie le texte à afficher.
Valeur renvoyée
None
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
None
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.

path: character
Spécifie le chemin vers l’image.
Valeur renvoyée
None
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.

data: character
Spécifie les octets de données pour une image. Vous pouvez saisir par exemple un caractère d'octets comme paramètre.
Valeur renvoyée
None
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: dataframe or list of atomic vectors
Définit les colonnes de données du tableau sous forme de list de atomic vectors ou de dataframe.
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
None
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 :