R API-Referenz

Dokumentation für die Klassen und Methoden der mtbr-Pakete für R.

In diesem Thema

Package: mtbr
Konvertieren von einem Minitab-Datumsformat in ein R-Datumsformat
Fehler aus kombinierten Zeichensätzen auf Microsoft® Windows

Für die Integration von R in Minitab Statistical Software stellt Minitab, LLC die Bibliothek mtbr bereit. Die folgenden Beschreibungen der Klassen und Methoden aus dem mtbr-Paket unterstützen Sie beim Verfassen von R-Code, der in Minitab integriert werden kann.

Informationen zum Installieren des R-Pakets von Minitab und zum Ausführen von R aus Minitab finden Sie unter Installieren von R zur Verwendung mit der Minitab Statistical Software.

Weitere Informationen zu R finden Sie unter www.r-project.org.

Package: mtbr

`mtb_get_column`

Ruft eine Spalte aus einem Minitab-Arbeitsblatt für die Verwendung in R ab.

name: character: Gibt die abzurufende Spalte an. Sie können entweder die Spaltennummer (z. B. „C1“) oder den Spaltennamen (z. B. „Meine Spalte“) angeben.

Rückgabewert

Gibt die Spalte mit Daten aus dem aktiven Arbeitsblatt als Ratomic vector zurück. Die können atomic vector Zeichen- oder Zahlenwerte enthalten.

Beispiel

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

`mtb_get_constant`

Ruft eine Konstante aus einem Minitab-Arbeitsblatt für die Verwendung in R ab.

name: character: Gibt die abzurufende Konstante an. Sie können entweder die Konstantennummer (z. B. „K1“) oder den Konstantennamen (z. B. „Meine Konstante“) angeben.

Rückgabewert

Gibt eine Konstante zurück, die ein Zeichen-, Ganzzahl- oder numerischer Wert sein kann.

Beispiel

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

`mtb_get_matrix`

Ruft eine Matrix aus einem Minitab-Arbeitsblatt für die Verwendung in R ab.

name: character: Gibt die abzurufende Matrix an. Sie können entweder die Matrixnummer (z. B. „M1“) oder den Matrixnamen (z. B. „Meine Matrix“) angeben.

Rückgabewert

Gibt die Spalte mit Daten aus der Matrix als R-matrix zurück.

Beispiel

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

`mtb_add_message`

Fügt eine Nachricht in den Minitab-Ausgabebereich an.

message: character: Gibt die anzuzeigende Meldung an.

Rückgabewert

Null

Beispiel

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

`mtb_set_note`

Legt einen Hinweis oben im Minitab-Ausgabefenster fest.

note: character: Gibt den anzuzeigenden Text an.

Rückgabewert

Null

Beispiel

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

`mtb_set_title`

Legt den Titel oben im Minitab-Ausgabefenster fest.

title: character: Gibt den anzuzeigenden Text an.

Rückgabewert

Null

Beispiel

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

`mtb_add_image`

Füge ein Bild dem Minitab-Ausgabebereich hinzu, wenn du eine unterstützte Bilddatei hast.

filename: character: Gibt den Pfad zum Bild an.

Rückgabewert

Null

Beispiel

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

`mtb_add_image_bytes`

Füge ein Bild in den Minitab-Ausgabebereich an, wenn du ein Bytes-Objekt hast.

image_bytes: raw vector: Gibt die Datenbytes für ein Bild an. Zum Beispiel können Sie ein Parameter raw vector eingeben.

Rückgabewert

Null

Beispiel

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`

Fügt eine Tabelle an den Minitab-Ausgabebereich an.

columns: data.frame or list of atomic vectors: Gibt die Spalten mit Daten für die Tabelle als list von atomic vectors oder als einen data.frame zurück.
headers: character vector (Optional): Gibt die Spaltenüberschriften für die Tabelle an. Der Standardwert von headers ist eine leere character vector.
title: character (Optional): Gibt den Titel für die Tabelle an. Der Standardwert für title ist "".
footnote: character (Optional): Gibt die Fußnote unter der Tabelle an. Der Standardwert für footnote ist "".

Rückgabewert

Null

Beispiel

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)

Konvertieren von einem Minitab-Datumsformat in ein R-Datumsformat

Standardmäßig verwendet Minitab ein anderes datetime-Format als R. Um das datetime-Format von Minitab in das datetime-Format von Unix zu konvertieren, verwenden Sie die Funktion excel_numeric_to_date() aus dem R-Paket janitor. Das Hausmeisterpaket hat keine Lizenz und sollte hier gut nachgelesen werden können. Documentation for the specific function can be found at: https://www.rdocumentation.org/packages/janitor/versions/2.1.0/topics/excel_numeric_to_date

Fehler aus kombinierten Zeichensätzen auf Microsoft® Windows

R on Microsoft® Windows kann nicht immer Zeichenketten verarbeiten, die Zeichen aus verschiedenen Zeichensätzen haben. Wenn zum Beispiel Microsoft® Windows der japanische (Shift-JIS)-Zeichensatz verwendet wird und eine Zeichenkette Zeichen aus dem chinesischen (GBK)-Zeichensatz enthält, werden einige Zeichenketten nicht korrekt verarbeitet.

Aufgrund dieser Einschränkung ist eine mögliche Lösung, dass Zeichenketten Zeichen aus demselben Zeichensatz wie die Anzeigesprache Microsoft® Windows verwenden.