Obter ajuda

Nelson Areal

Ajuda | Usando o RStudio

Podemos usar a pesquisa de ajuda do RStudio:

RStudio help

Ajuda | Usando o R

O R contém um sistema de ajuda:

  1. Se não souber exactamente qual o nome da função que procura, poderá digitar na consola:
help.search("normal distribution")

ou alternativamente:

??"normal distribution"
  1. Se conhecer o nome da função, use então:
help(rnorm)

ou alternativamente:

?rnorm

Ajuda | Usando o R

É até possível procurar ajuda sobre operadores, como por exemplo +:

?"+"

Ajuda | Usando o R

A maior parte das páginas contém no seu final uma secção de exemplos. Pode correr todos os exemplos de uma determinada função usando:

example(rnorm)

rnorm> require(graphics)

rnorm> dnorm(0) == 1/sqrt(2*pi)
[1] TRUE

rnorm> dnorm(1) == exp(-1/2)/sqrt(2*pi)
[1] TRUE

rnorm> dnorm(1) == 1/sqrt(2*pi*exp(1))
[1] TRUE

rnorm> ## Using "log = TRUE" for an extended range :
rnorm> par(mfrow = c(2,1))

rnorm> plot(function(x) dnorm(x, log = TRUE), -60, 50,
rnorm+      main = "log { Normal density }")

rnorm> curve(log(dnorm(x)), add = TRUE, col = "red", lwd = 2)

rnorm> mtext("dnorm(x, log=TRUE)", adj = 0)

rnorm> mtext("log(dnorm(x))", col = "red", adj = 1)

rnorm> plot(function(x) pnorm(x, log.p = TRUE), -50, 10,
rnorm+      main = "log { Normal Cumulative }")

rnorm> curve(log(pnorm(x)), add = TRUE, col = "red", lwd = 2)

rnorm> mtext("pnorm(x, log=TRUE)", adj = 0)

rnorm> mtext("log(pnorm(x))", col = "red", adj = 1)

rnorm> ## if you want the so-called 'error function'
rnorm> erf <- function(x) 2 * pnorm(x * sqrt(2)) - 1

rnorm> ## (see Abramowitz and Stegun 29.2.29)
rnorm> ## and the so-called 'complementary error function'
rnorm> erfc <- function(x) 2 * pnorm(x * sqrt(2), lower = FALSE)

rnorm> ## and the inverses
rnorm> erfinv <- function (x) qnorm((1 + x)/2)/sqrt(2)

rnorm> erfcinv <- function (x) qnorm(x/2, lower = FALSE)/sqrt(2)

Ajuda | Usando o R

Se não soubermos o nome de uma função, podemos pesquisar pela sua documentação usando a função apropos:

apropos("rno")
[1] "psmirnov" "qsmirnov" "rnorm"    "rsmirnov"
apropos("norm")
 [1] "dlnorm"        "dnorm"         "norm"          "normalizePath"
 [5] "plnorm"        "pnorm"         "qlnorm"        "qnorm"        
 [9] "qqnorm"        "rlnorm"        "rnorm"

Nota: É possível usar expressões regulares (regular expressions) na expressão de pesquisa.

Ajuda | Usando o R

A função find(), dá-no o pacote que define uma determinada função, por exemplo:

find("rnorm")
[1] "package:stats"

Ajuda | Usando o R

Muitos pacotes tem documentos designados de vignettes que contém uma descrição mais detalhada de como pode usar o pacote em questão.

Para listar esses documentos para os pacotes que estão carregados usar:

vignette(all = FALSE)

Para listar esses documentos para todos os pacotes instalados usar:

vignette(all = TRUE)

A função abaixo irá abrir uma página no seu navegador com uma lista de todos esses documentos:

browseVignettes()

Ajuda | Usando o R

Se conhecer o nome do documento vignette poderá aceder a ele directamente através de:

vignette("reshape")

Ajuda | Fora do R

Manuais do R

Vá a https://cran.r-project.org/ e seleccione Manuals na barra esquerda.

Ajuda | Fora do R

Fóruns e listas

A recente Comunidade RStudio é um fórum amigável para colocar questões sobre o R e RStudio.

O R tem também uma lista, para a pesquisar, vá a https://cran.r-project.org/ e seleccione Search

Notes: Também pode usar RSiteSearch("rnorm") para fazer essa pesquisa através da consola do R.

Ajuda | Fora do R

Google

O truque é adicionar ao termo de pesquisa, “in R” ou apenas “R”: Go to https://google.com

Nota: Tente pesquisar por random normal numbers in r

Ajuda | Fora do R

Outras boas fontes, que lhe poderão ajudar nos seus problemas com o R são:

  • Stack Overflow para problemas com o R (use a etiqueta [r] nas suas pesquisas)
  • Cross Validated para problemas estatísticos (também pode usar a etiqueta [r])

Ajuda | Antes de colocar uma questão

Antes de colocar uma questão, verifique que:

  1. Pesquisou por uma solução antes de colocar a questão
  2. Reduziu a dimensão do problema à sua essência
  3. É explicito em relação ao que pretende fazer, e consegue descrever qual seria o resultado esperado.

Ajuda | Um exemplo replicável

Tente sempre apresentar um exemplo que possa ser replicável, que exemplifique o seu problema.

  1. Inclua a lista de pacotes que você tem carregado
  2. Propocione os dados mínimos para reproduzir o problema
  3. Inclua o código necessário para identificar o problema
  4. Qual o resultado que obtem e qual o que esperava ter obtido

Ajuda | Um exemplo replicável

Para mais informações consulte:

Folha de referência

O Rstudio contém uma variedade de folhas de referência com a principal informação sobre vários pacotes ou tarefas em R. São uma boa ajuda para quem está a começar:

Vamos praticar

Coloque em prática estes conhecimentos fazendo os exercícios abaixo.