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

Para realizar a integração do R com o Minitab Statistical Software, a Minitab, LLC disponibiliza o pacote mtbr. As descrições das classes e métodos do pacote mtbr a seguir preparam-no para escrever o 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.

column_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. A atomic vector pode conter caracteres, inteiros ou valores 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.

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

matrix_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`

Anexa uma mensagem ao painel Saída do Minitab.

message: character: Especifica a mensagem a ser exibida.

Valor de retorno

None

Exemplo

library(mtbr)

mtb_add_message("This is a message.")

`mtb_set_note`

Define uma nota na parte superior do painel Saída do Minitab.

message: character: Especifica o texto a ser exibido.

Valor de retorno

None

Exemplo

library(mtbr)

mtb_set_note("The output contains one note.")

`mtb_set_title`

Define o título na parte superior do painel Saída do Minitab.

title: character: Especifica o texto a ser exibido.

Valor de retorno

None

Exemplo

library(mtbr)

mtb_set_title("The output contains one title.")

`mtb_add_image`

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

path: character: Especifica o caminho para a imagem.

Valor de retorno

None

Exemplo

library(mtbr)

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

`mtb_add_image_bytes`

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

data: character: Especifica os bytes de dados para uma imagem. Por exemplo, você pode inserir um caractere de bytes como parâmetro.

Valor de retorno

None

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 Saída do Minitab.

columns: dataframe or list of atomic vectors: Especifica as colunas de dados para a tabela como uma list de atomic vectors ou um dataframe.
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

None

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.