R Referências de API

Documentação para as classes e métodos do pacote mtbr para R.

Neste tópico

Package: mtbr
Conversão de um formato de data Minitab para um formato de data R
Erros de conjuntos combinados de caracteres em Microsoft® Windows

Para realizar a integração do R com o Minitab Statistical Software, a Minitab, LLC disponibiliza o pacote mtbr. As descrições a seguir das funções do pacote mtbr preparam você para escrever código R que se integra ao Minitab.

Para obter informações sobre como instalar o pacote R do Minitab e como executar o R no Minitab, acesse Instalação do R para uso com Minitab Statistical Software.

Para obter mais informações sobre o R, consulte as orientações disponíveis em www.r-project.org.

Package: mtbr

`mtb_get_column`

Recupera uma coluna de uma worksheet do Minitab a ser usada noR.

name: character: Especifica a coluna a ser recuperada. É possível especificar o número da coluna (por exemplo, "C1") ou o nome da coluna (por exemplo, "Minha Coluna").

Valor de retorno

Retorna a coluna de dados da worksheet ativa como uma atomic vector do R. O atomic vector computador pode conter valores de caracteres ou numéricos.

Exemplo

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

`mtb_get_constant`

Recupera uma constante de uma worksheet do Minitab a ser usada noR.

name: character: Especifica a constante a ser recuperada. É possível especificar o número constante (por exemplo, "K1") ou o nome constante (por exemplo, "Minha constante").

Valor de retorno

Retorna uma constante que pode ser um caractere ou valor numérico.

Exemplo

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

`mtb_get_matrix`

Recupera uma matriz de uma worksheet do Minitab a ser usada noR.

name: character: Especifica a matriz a ser recuperada. É possível especificar o número da matriz (por exemplo, "M1") ou o nome da matriz (por exemplo, "Minha Matriz").

Valor de retorno

Retorna os dados da matriz como uma matrixR.

Exemplo

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

`mtb_add_message`

Adiciona uma mensagem ao painel de saída do Minitab.

message: character: Especifica a mensagem a ser exibida.

Valor de retorno

Null

Exemplo

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

`mtb_set_note`

Define uma anotação no topo do painel de saída do Minitab.

note: character: Especifica o texto a ser exibido.

Valor de retorno

Null

Exemplo

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

`mtb_set_title`

Define o título no topo do painel de Saída do Minitab.

title: character: Especifica o texto a ser exibido.

Valor de retorno

Null

Exemplo

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

`mtb_add_image`

Anexa uma imagem ao painel de Saída do Minitab quando você tem um arquivo de imagem suportado.

filename: character: Especifica o caminho para a imagem.

Valor de retorno

Null

Exemplo

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

`mtb_add_image_bytes`

Adiciona uma imagem ao painel de saída do Minitab quando você tem um objeto bytes.

image_bytes: raw vector: Especifica os bytes de dados para uma imagem. Por exemplo, você pode inserir um raw vector como parâmetro.

Valor de retorno

Null

Exemplo

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`

Anexa uma tabela ao painel de Saída do Minitab.

columns: data.frame or list of atomic vectors: Especifica as colunas de dados para a tabela como uma list de atomic vectors ou um data.frame.
headers: character vector (Optional): Especifica os cabeçalhos de coluna para a tabela. O headers padrão é uma character vector vazia.
title: character (Optional): Especifica o título para a tabela. O title padrão é "".
footnote: character (Optional): Especifica a nota de rodapé abaixo da tabela. O footnote padrão é "".

Valor de retorno

Null

Exemplo

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)

Conversão de um formato de data Minitab para um formato de data R

Por padrão, o Minitab usa um formato de datetime diferente do usado pelo R. Para converter do formato de datetime do Minitab para o formato de datetime do Unix, use a função excel_numeric_to_date() do pacote janitorR.

Erros de conjuntos combinados de caracteres em Microsoft® Windows

R ligado Microsoft® Windows nem sempre pode processar cadeias que tenham caracteres de conjuntos de caracteres diferentes. Por exemplo, se Microsoft® Windows usar o conjunto de caracteres japonês (Shift-JIS) e uma string incluir caracteres do conjunto de caracteres chinês (GBK), algumas strings não serão processadas corretamente.

Por causa dessa limitação, uma possível solução é que as strings usem caracteres do mesmo conjunto de caracteres da Microsoft® Windows linguagem de exibição.