\documentclass[a4paper, oneside, 10pt]{article}
\usepackage[english]{babel}
\usepackage[unicode]{hyperref}
\usepackage[utf8x]{inputenc}
\usepackage{graphicx}
\graphicspath{{media/}}
\usepackage{listings}
\date{\today}
\title{}
\author{}
\begin{document}



\section{\texorpdfstring{2. Primeiros Passos}{2 Primeiros Passos}}
\label{sec:2_primeiros_passos}


\subsection{\texorpdfstring{Instalação do R}{Instalaao do R}}
\label{sec:instalaao_do_r}


Os arquivos necessários para instalar o ambiente R estão disponíveis gratuitamente no sítio oficial \url{http://www.r-project.org/}.

A página oficial do R é a referência básica para seus usuários e desenvolvedores, onde você também encontra instruções de instalação, listas de discussão, tutoriais, documentação e muitas informações úteis.

\subsection{\texorpdfstring{Iniciando o R}{Iniciando o R}}
\label{sec:iniciando_o_r}


Em ambiente UNIX (como o Linux, por exemplo), podemos iniciar o R a partir do interpretador de comandos (\emph{shell}) digitando o comando \texttt{R}:\lstset{frame=single}
\begin{lstlisting}

parsival@jatai $ R
\end{lstlisting}



Já no sistema MS-Windows,  é necessário clicar no ícone apropriado (no desktop) ou buscar o programa a partir do menu \textbf{Iniciar}.

Independentemente de como inicia, o R apresenta uma tela com (aproximadamente) a seguinte forma:\lstset{frame=single}
\begin{lstlisting}

R version 2.7.0 (2008-04-22)
Copyright (C) 2008 The R Foundation for Statistical Computing
ISBN 3-900051-07-0

R é um software livre e vem sem GARANTIA ALGUMA.
Você pode redistribuí-lo sob certas circunstâncias.
Digite 'license()' ou 'licence()' para detalhes de distribuição.

R é um projeto colaborativo com muitos contribuidores.
Digite 'contributors()' para obter mais informações e
'citation()' para saber como citar o R ou pacotes do R em publicações.

Digite 'demo()' para demonstrações, 'help()' para o sistema on-line de ajuda,
ou 'help.start()' para abrir o sistema de ajuda em HTML no seu navegador.
Digite 'q()' para sair do R.

[Área de trabalho anterior carregada]

>                                                                           

\end{lstlisting}



\subsubsection{\texorpdfstring{A Linha de Comando}{A Linha de Comando}}
\label{sec:a_linha_de_comando}


O R é uma linguagem interativa, ou seja, que permite ao usuário enviar um comando por vez e receber o resultado\footnote{é possível também de executar um lote de comandos, mas neste wiki trabalharemos apenas com o modo interativo.}. Para isso, usamos a linha de comando, que tem o sinal ,,\texttt{\textgreater }" quando o R está pronto para receber um comando. 

Os outros dois estados da linha de comando são o de execução e o de espera para a conlusão do comando. No modo de execução não é exibido nenhum sinal e não é possível digitar outro comando. Você só perceberá isso se der um comando que tenha um tempo de execução muito longo. 

O estado de espera ocorre quando o usuário envia um comando incompleto, o que é indicado por um sinal de ,,\texttt{+}":\lstset{frame=single}
\begin{lstlisting}

>
> log(2
+ )
[1] 0.6931472
>               
\end{lstlisting}



Na primeira linha, não fechamos os parênteses da função \texttt{log} e demos \emph{enter}. O R responde com o sinal de espera (\texttt{+}), indicando que o comando está incompleto. Digitando o parêntese que falta e apertando a tecla \emph{enter} novamente o R retorna o resultado do comando, precedido de um índice numérico.\footnote{o significado desse índice ficará claro na seção sobre \href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:03_apostila:04-dados\%23subconjuntos_e_indexacao}{indexação}. Por enquanto basta saber que os resultados do R são precedidos por um indicador numérico entre colchetes}

\subsubsection{\texorpdfstring{Sintaxe Básica dos Comandos}{Sintaxe Basica dos Comandos}}
\label{sec:sintaxe_basica_dos_comandos}


Um comando no R em geral inclui uma ou mais funções, que seguem a seguinte sintaxe:\textbf{função(argumento1 = valor, argumento2 = valor , ...)}

Como nos exemplos abaixo:\lstset{frame=single}
\begin{lstlisting}

> plot(x=area,y=riqueza)
> plot(area, riqueza)
> plot(area,riqueza,xlab="Área (ha)", ylab="Riqueza")
\end{lstlisting}


\begin{itemize}
  \item  No primeiro caso, o valor de cada argumento usado está explicitado. O argumento \texttt{x} da função \texttt{plot} é a variável independente, e o argumento \texttt{y} é a variável dependente. 
  \item Se o nome dos argumentos é omitido, como no segundo caso, o R usa o critério de posição: o primeiro valor é atribuído ao primeiro argumento, o segundo valor ao segundo argumento, e assim por diante. Como os dois primeiros argumentos da função plot são \texttt{x} e \texttt{y}, o segundo comando acima equivale ao primeiro.
  \item Os dois critérios podem ser combinados, como no terceiro comando: como x e y são os dois primeiros argumentos, não é preciso declará-los. Como os outros dois argumentos que se deseja usar (\texttt{xlab} e \texttt{ylab}) não vêm em seguida, é preciso declará-los.
\end{itemize}


Mais detalhes na \href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:03_apostila:03-funcoes\%23as_funcoes_no_r}{seção sobre funções}.

\subsubsection{\texorpdfstring{Criação de Objetos: Atribuição}{Criaao de Objetos Atribuiao}}
\label{sec:criaao_de_objetos_atribuiao}


Você pode ,,guardar" o resultado de um comando com a operação de \emph{atribuição}, que tem a sintaxe:\textbf{objeto} \emph{recebe} \textbf{valor}


Há dois operadores que atribuem valores a um objeto dessa maneira:
\begin{itemize}
  \item Sinal de menor seguido de hífen, formando uma seta para a esquerda:  \texttt{\textless }\texttt{-}
  \item Sinal de igual: \texttt{=}
\end{itemize}


Uma forma de atribuição menos usada é:\textbf{valor} \emph{atribuído a} \textbf{objeto}


Nesse caso, o sinal de atribuição é o hífen seguido de sinal de maior, formando uma seta para direita:  
\texttt{-}\texttt{\textgreater }

Há, portanto, três maneiras de guardar os resultados de um comando em um objeto:\lstset{frame=single}
\begin{lstlisting}

> a <- sqrt(4)
> b = sqrt(4)
> sqrt(4) -> c
\end{lstlisting}



Para exibir o conteúdo de um objeto, basta digitar seu nome\lstset{frame=single}
\begin{lstlisting}

> a
[1] 2
> b
[1] 2
> c
[1] 2
\end{lstlisting}



Se a atribuição é para um objeto que não existe, esse objeto é criado. \textbf{Mas cuidado}: se já há um objeto com o mesmo nome na sua área de trabalho, seus valores serão substituídos:\lstset{frame=single}
\begin{lstlisting}

> a <- sqrt(4)
> a
[1] 2
> a <- 10^2
> a
[1] 100
\end{lstlisting}



\subsubsection{\texorpdfstring{Mensagens de Erro e de Avisos}{Mensagens de Erro e de Avisos}}
\label{sec:mensagens_de_erro_e_de_avisos}


Como em qualquer linguagem, o R tem regras de sintaxe e grafia. Mas contrário das linguagens humanas, mesmo um pequeno erro torna a mensagem incompreensível para o R, que então retorna uma mensagem de erro:\lstset{frame=single}
\begin{lstlisting}

> logaritmo(2)
Erro: não foi posssível encontrar a função "logaritmo"
> log(2))
Erro: unexpected ')' in "log(2))"
> log(2, basse=10)
Erro: unused argument(s) (basse = 10)
> log(2, base=10)
[1] 0.30103
\end{lstlisting}



Em outros casos, o comando pode ser executado, mas com um resultado que possivelmente você não desejava. O R cria mensagens de alerta para os casos mais comuns desses resultados que merecem atenção :\lstset{frame=single}
\begin{lstlisting}

> log(-2)
[1] NaN
Warning message:
In log(-2) : NaNs produzidos
\end{lstlisting}



\subsection{\texorpdfstring{Para Sair}{Para Sair}}
\label{sec:para_sair}


Para sair do R, a forma mais fácil é usar o comando \texttt{q} (do inglês \emph{quit}).  Nesse caso o R, lhe pergunda se você deseja \emph{salvar} (gravar)
sua sessão de trabalho.\lstset{frame=single}
\begin{lstlisting}

> q()
Save workspace image? [y/n/c]: 
\end{lstlisting}



As opções são: \texttt{y = yes, n = no, c = cancel}.

\subsection{\texorpdfstring{Como o R Guarda os Dados?}{Como o R Guarda os Dados}}
\label{sec:como_o_r_guarda_os_dados}


O que significa a pergunta feita quando damos o comando \texttt{q()}?

A resposta passa por três conceitos importantíssimos, que são o \textbf{diretório de trabalho}, a \textbf{sessão} e a \textbf{área virtual de trabalho (\emph{workspace})}. 

Cada vez que você inicia o R, dizemos que se inicia uma \textbf{sessão}. 

O diretório a partir do qual você iniciou o R é o  \textbf{diretório de trabalho} dessa sessão. Para verificar seu diretório de trabalho, use o comando \texttt{getwd}\footnote{acrônimo de ,,get working directory"}: \lstset{frame=single}
\begin{lstlisting}

> getwd()
[1] "/home/paulo/work/Pos_grad/Eco_USP/cursoR"
\end{lstlisting}



Para alterar o diretório de trabalho há a função \texttt{setwd}:\lstset{frame=single}
\begin{lstlisting}

> setwd("/home/paulo/work/treinos_R/")
> getwd()
[1] "/home/paulo/work/treinos_R"
\end{lstlisting}



A sessão iniciada está ligada a uma área de trabalho particular chamada de \textbf{workspace}.

Tudo o que você faz durante uma sessão (leitura de dados, cálculos, análises estatísticas) é realizado no \textbf{workspace}.

Mas o \textbf{workspace permanece na memória do computador}.  Somente quando você dá o comando de sair (\texttt{q()}) é que o
R lhe pergunta se você deseja \textbf{gravar} o seu \textbf{workspace}. Se você responde 'y', o R grava um arquivo chamado \texttt{.RData}\footnote{este é um arquivo oculto, pois seu nome inicia-se com um ponto} em seu \textbf{diretório de trabalho}. Na próxima vez que o R for chamado desse diretório, o conteúdo do arquivo \texttt{.RData} será carregado para o ,,workspace".

\subsubsection{\texorpdfstring{Aprenda este Comando para Não Perder Seu Trabalho}{Aprenda este Comando para Nao Perder Seu Trabalho}}
\label{sec:aprenda_este_comando_para_nao_perder_seu_trabalho}


Se acontecer do computador ser desligado durante uma sessão do R, tudo que foi feito será perdido!!!
Para evitar isso, é interessante gravar com frequência o \textbf{workspace} utilizando o comando \texttt{'save.image()}':\lstset{frame=single}
\begin{lstlisting}

> save.image()
>
\end{lstlisting}



Por \emph{default}, o R gravará o workspace no arquivo \texttt{.RData}, e quando você reiniciar uma sessão, o R automaticamente \textbf{carrega} esse arquivo.
Mas você pode salvar em outro arquivo utilizando o \textbf{argumento} \texttt{file} da função:\lstset{frame=single}
\begin{lstlisting}

> save.image(file="minha-sessao-introdutoria.RData")
>
\end{lstlisting}



Como o R carrega automaticamente apenas o arquivo \texttt{.RData} que está no diretório de trabalho, caso deseje carregar outros arquivos você deverá usar a função \texttt{load}:\lstset{frame=single}
\begin{lstlisting}

># Carrega um arquivo de workspace no mesmo diretório
> load(file="minha-sessao-introdutoria.RData")
># Carrega o arquivo default de workspace de outro diretório:
> load(file="/home/paulo/work/treinos_R/.RData")
\end{lstlisting}



No código acima podemos ver o símbolo ,,\#" seguido de comentários que explicam o que a função está fazendo. Quando você coloca ,,\#", o R irá ignorar o que vem depois do símbolo na linha. Ou seja, se você copiar uma linha começando com ,,\#" no console e pedir para o R executar a mesma, não vai acontecer nada. Este símbolo é muito útil para comentar o seu código.

Se você quiser salvar apenas alguns objetos (digamos, os resultados das suas análises), você pode usar o comando \texttt{save}:\lstset{frame=single}
\begin{lstlisting}

> save(modelo1, file="meu_modelo.RData")
> save(dados, modelo1, modelo2, file="meus_modelos.RData")
\end{lstlisting}



Tome cuidado com a sintaxe do comando \texttt{save}: ele aceita o nome de vários objetos que existem no seu workspace e um nome de arquivo, que deve ser passado com \texttt{file=}.

O comando \texttt{save} aceita o resultado de outros comandos. Por exemplo, o código abaixo equivale ao comando save.image():\lstset{frame=single}
\begin{lstlisting}

> save (list=ls(), file="tudo.RData")
\end{lstlisting}



\subsubsection{\texorpdfstring{Aprenda este Procedimento para Organizar Seu Trabalho}{Aprenda este Procedimento para Organizar Seu Trabalho}}
\label{sec:aprenda_este_procedimento_para_organizar_seu_trabalho}


Crie um diretório de trabalho para cada análise, ou mesmo para versões diferentes da mesma análise, e chame o R desse diretório. Fazendo isso você recupera seu trabalho de maneira simples, bastando salvar as alterações regularmente com o comando \texttt{save.image()} e confirmar a gravação das alterações ao encerrar a sessão. 

Ao contrário do que você pode estar acostumado(a), não é uma boa idéia manter vários arquivos com diferentes versões dos dados ou análises em um mesmo diretório. Os usuários de R em geral mantém o padrão da linguagem, de um único arquivo \emph{default} por análise, o \texttt{.RData}, criando quantos diretórios forem necessários para organizar o trabalho. 

\subsection{\texorpdfstring{Gerenciando a Área de Trabalho}{Gerenciando a Area de Trabalho}}
\label{sec:gerenciando_a_area_de_trabalho}


\subsubsection{\texorpdfstring{Listando Objetos}{Listando Objetos}}
\label{sec:listando_objetos}


O comando \texttt{ls} lista todo o conteúdo da área de trabalho, se não é fornecido argumento:\lstset{frame=single}
\begin{lstlisting}

> ls()
[1] "consoantes" "CONSOANTES" "vogais" "VOGAIS"
\end{lstlisting}



A função \texttt{ls} possui argumentos que podem refinar seus resultados, consulte a ajuda para os detalhes.

\subsubsection{\texorpdfstring{Apagando Objetos}{Apagando Objetos}}
\label{sec:apagando_objetos}


O comando \texttt{rm} apaga objetos da área de trabalho:\lstset{frame=single}
\begin{lstlisting}

> ls()
[1] "consoantes" "CONSOANTES" "vogais"     "VOGAIS"
> rm(consoantes)
> ls()
[1] "CONSOANTES" "vogais"     "VOGAIS"
\end{lstlisting}



Consulte a ajuda da função \texttt{rm} para seus argumentos.

\begin{center}
\line(1,0){250}
\end{center}



\subsubsection{\texorpdfstring{Exercícios}{Exercicios}}
\label{sec:exercicios}
 \emph{\textbf{2.1. Exercício para Usuários Windows:}  Diretório de Trabalho} 
\begin{enumerate}
  \item Crie um diretório para seus exercícios da disciplina.
  \item Chame o R, clicando no ícone da área de trabalho ou na barra de tarefas.
  \item Verifique o seu diretório de trabalho.
  \item Mude o diretório de trabalho para o diretório que você criou.
  \item Verifique o conteúdo da área de trabalho.
  \item Carregue o arquivo \href{media/dados/letras.rdata.pdf}{letras.RData (apagar extensão .pdf)}.
  \item Verifique novamente sua área de trabalho.
  \item Saia do R, tomando o cuidado de salvar sua área de trabalho.
  \item Repita os passos 2 a 5.
\end{enumerate}


\textbf{Pergunta}: Que problemas você percebeu? Há uma maneira de iniciar o R no windows que evite esses problemas?

\subsection{\texorpdfstring{Como Conseguir Ajuda no R}{Como Conseguir Ajuda no R}}
\label{sec:como_conseguir_ajuda_no_r}


No R é essencial aprender a procurar auxílio e manuais sozinho.  Após um aprendizado inicial, não há meio de evoluir no conhecimento
do ambiente R se não se buscar os \textbf{\emph{helps}} que ele possui.

\subsubsection{\texorpdfstring{O Comando ''help''}{O Comando help}}
\label{sec:o_comando_help}


Para conseguir ajuda sobre um comando pode ser usada a função \texttt{help}:\lstset{frame=single}
\begin{lstlisting}

> help(mean)
\end{lstlisting}



ou então o operador de ajuda que é o sinal de interrogação  '?':\lstset{frame=single}
\begin{lstlisting}

?mean
\end{lstlisting}



No caso se buscar ajuda sobre um \textbf{operador} (símbolo para operações aritméticas e algébricas) devemos utilizar as aspas duplas:\lstset{frame=single}
\begin{lstlisting}

> help("+")
> ?"*"
\end{lstlisting}



Ao utilizar esses comandos (help e ?) o R abre uma página hipertexto no seu navegador, contendo as informações de ajuda para o tema solicitado (função ou operador).

\textbf{\underline{Help no terminal ou linha de comando do prompt}}

Caso esteja rodando o R diretamente no shell ou no prompt do windows, ao rodar a função \texttt{help} ele entrará no modo \textbf{\emph{help interativo}}.  

Essa \textbf{\emph{help page}} pode ser examinada usando os seguintes comandos de teclado:
\begin{itemize}
  \item tecla de espaço = um página para frente;
  \item tecla ,,f" = uma página para frente;
  \item tecla ,,b" = uma página para trás;
  \item tecla enter = uma linha para frente;
  \item tecla j = uma linha para frente;
  \item tecla k = uma linha para trás;
  \item tecla q = sai do modo \textbf{help interativo} e retorna à linha de comando.
\end{itemize}


No modo \textbf{help interativo} também é possível se fazer uma busca por uma palavra (\emph{string}) usando a tecla '/', na forma:\lstset{frame=single}
\begin{lstlisting}

/string
\end{lstlisting}



Executado um comando de busca temos dois novos comandos válidos:
\begin{itemize}
  \item tecla n = próxima string, e
  \item tecla N = string anterior.
\end{itemize}


\paragraph{\texorpdfstring{A Tela de Ajuda}{A Tela de Ajuda}}
\label{sec:a_tela_de_ajuda}


O conteúdo do \textbf{help} pode parecer árido à primeira vista, mas é extremamente informativo, assim que nos acostumamos com ele. As seções são padronizadas, e seguem sempre a mesma ordem:
\begin{itemize}
  \item Um cabeçalho com o nome da função, o pacote do R à qual pertence, e a classe do documento de ajuda
  \item O nome completo da função
  \item A sintaxe da função, que pode estar especificada para diferentes tipos de dados ou métodos
  \item A explicação de cada um dos argumentos da função
  \item O valor retornado pela função
  \item Referências bibliográficas
  \item Indicação de outras funções relacionadas
  \item Exemplos (colar esses comandos no R é uma das melhores maneiras de entender uma função).
\end{itemize}


\subparagraph{\texorpdfstring{Abaixo o conteúdo da ajuda para a função ''mean'':}{Abaixo o conteudo da ajuda para a funao mean}}
\label{sec:abaixo_o_conteudo_da_ajuda_para_a_funao_mean}
\lstset{frame=single}
\begin{lstlisting}

mean                  package:base                  R Documentation

Arithmetic Mean

Description:

     Generic function for the (trimmed) arithmetic mean.

Usage:

     mean(x, ...)

     ## Default S3 method:
     mean(x, trim = 0, na.rm = FALSE, ...)

Arguments:

       x: An R object.  Currently there are methods for numeric data
          frames, numeric vectors and dates.  A complex vector is
          allowed for 'trim = 0', only.

    trim: the fraction (0 to 0.5) of observations to be trimmed from
          each end of 'x' before the mean is computed.

   na.rm: a logical value indicating whether 'NA' values should be
          stripped before the computation proceeds.

     ...: further arguments passed to or from other methods.

Value:

     For a data frame, a named vector with the appropriate method being
     applied column by column.

     If 'trim' is zero (the default), the arithmetic mean of the values
     in 'x' is computed, as a numeric or complex vector of length one.
     If any argument is not logical (coerced to numeric), integer,
     numeric or complex, 'NA' is returned, with a warning.

     If 'trim' is non-zero, a symmetrically trimmed mean is computed
     with a fraction of 'trim' observations deleted from each end
     before the mean is computed.

References:

     Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) _The New S
     Language_. Wadsworth & Brooks/Cole.

See Also:

     'weighted.mean', 'mean.POSIXct'

Examples:

     x <- c(0:10, 50)
     xm <- mean(x)
     c(xm, mean(x, trim = 0.10))

     mean(USArrests, trim = 0.2)
\end{lstlisting}



\subsubsection{\texorpdfstring{Ajuda em Hipertexto: ''help.start''}{Ajuda em Hipertexto helpstart}}
\label{sec:ajuda_em_hipertexto_helpstart}


Para os que preferem trabalhar com ajuda em hipertexto (html), há o comando \texttt{help.start()}:\lstset{frame=single}
\begin{lstlisting}

> help.start()
Making links in per-session dir ...
If 'sensible-browser' is already running, it is *not* restarted, and
    you must switch to its window.
Otherwise, be patient ...
> 
\end{lstlisting}



Após esta mensagem, um portal de ajuda em hipertexto será aberto no navegador de internet padrão do sistema. A partir dessa página inicial é possível fazer pesquisas por palavras-chave, consultar funções por pacote ou por ordem alfabética, obter textos introdutórios sobre a linguagem, e muito mais.

\includegraphics[keepaspectratio=true,width=0.8\textwidth]{bie5782/03_apostila/fetch}


\begin{center}
\line(1,0){250}
\end{center}



\subsubsection{\texorpdfstring{Pesquisa por Palavras-Chave na Ajuda}{Pesquisa por PalavrasChave na Ajuda}}
\label{sec:pesquisa_por_palavraschave_na_ajuda}


Outro comando muito útil é o \texttt{apropos}.  Ele possibilita sabermos quais funções do R tem no nome uma certa palavra (\emph{string}):\lstset{frame=single}
\begin{lstlisting}

> apropos(plot)
 [1] "biplot"              "interaction.plot"    "lag.plot"           
 [4] "monthplot"           "plot.density"        "plot.ecdf"          
 [7] "plot.lm"             "plot.mlm"            "plot.spec"          
[10] "plot.spec.coherency" "plot.spec.phase"     "plot.stepfun"       
[13] "plot.ts"             "plot.TukeyHSD"       "preplot"            
[16] "qqplot"              "screeplot"           "termplot"           
[19] "ts.plot"             "assocplot"           "barplot"            
[22] "barplot.default"     "boxplot"             "boxplot.default"    
[25] "cdplot"              "coplot"              "fourfoldplot"       
[28] "matplot"             "mosaicplot"          "plot"               
[31] "plot.default"        "plot.design"         "plot.new"           
[34] "plot.window"         "plot.xy"             "spineplot"          
[37] "sunflowerplot"       "boxplot.stats"       ".__C__recordedplot" 
\end{lstlisting}



Para pesquisas mais complexas e refinadas há ainda a função \texttt{help.search()}. Por exemplo, para pesquisar funções que tenham a palavra ,,skew"no título:\lstset{frame=single}
\begin{lstlisting}

> help.search(field="title","skew")

Help files with title matching 'skew' using regular expression
matching:



skewnormal1(VGAM)       Univariate Skew-Normal Distribution Family
                        Function
snorm(VGAM)             Skew-Normal Distribution
k3.linear(boot)         Linear Skewness Estimate



Type 'help(FOO, package = PKG)' to inspect entry 'FOO(PKG) TITLE'.
\end{lstlisting}



\subsubsection{\texorpdfstring{Busca de Exemplos e de Argumentos das Funções}{Busca de Exemplos e de Argumentos das Funoes}}
\label{sec:busca_de_exemplos_e_de_argumentos_das_funoes}


Para obter apenas os exemplos que estão na ajuda de uma função, use a função \texttt{example}:\lstset{frame=single}
\begin{lstlisting}

> example(mean)

mean> x <- c(0:10, 50)

mean> xm <- mean(x)

mean> c(xm, mean(x, trim = 0.1))
[1] 8.75 5.50

mean> mean(USArrests, trim = 0.2)
  Murder  Assault UrbanPop     notGood
    7.42   167.60    66.20    20.16
\end{lstlisting}



Muitas vezes precisamos apenas nos lembrar dos argumentos de uma função. Para isso, use a função \texttt{args}, que retorna os argumentos de uma função:\lstset{frame=single}
\begin{lstlisting}

> args(chisq.test)
function (x, y = NULL, correct = TRUE, p = rep(1/length(x), length(x)),
    rescale.p = FALSE, simulate.p.value = FALSE, B = 2000)
NULL
\end{lstlisting}



Argumentos com valores atribuídos são os valores \emph{default} da função. Por exemplo, por \emph{default} a função de teste de Qui-quadrado estima a significância pela distribuição de Qui-quadrado e não por randomização (argumento \texttt{simulate.p.value=FALSE}).

\subsubsection{\texorpdfstring{Exercícios}{Exercicios}}
\label{sec:exercicios2}
 \emph{\textbf{Exercício 2.2.}  Use a Ajuda para Conhecer Argumentos das Funções} 
\begin{enumerate}
  \item Execute o R, usando o diretório de trabalho criado no exercício anterior.
  \item Use a função \texttt{load} para carregar o arquivo \href{media/dados/bichos.rdata.pdf}{bichos.RData (apagar extensão .pdf)} no \emph{workspace}.
  \item Consulte a ajuda da funções \texttt{rm} e \texttt{ls} para descobrir como apagar apenas os objetos cujos nomes começam com ,,temp".                                                                                      
\end{enumerate}


\subsection{\texorpdfstring{Pacotes}{Pacotes}}
\label{sec:pacotes}


Pacotes são conjuntos de funcionalidades (funções e dados) distribuídos em conjunto para realizar tarefas específicas. Por exemplo, o pacote \textbf{vegan} carrega na sua área de trabalho (deixa disponível para uso) um conjunto de ferramentas para análises de dados de ecologia de comunidades. Para usar os pacotes disponíveis no R 
\footnote{,, Currently, the CRAN package repository features 14270 available packages." --- \emph{\href{mailto:aleadalardo@gmail.com}{Alexandre Adalardo de Oliveira} 2019/05/22 14:14}


,,Currently, the CRAN package repository features 5217 available packages."  --- \emph{\href{mailto:aleadalardo@gmail.com}{Alexandre Adalardo de Oliveira} 2014/02/17 14:31}}

é necessário entender as diferenças entre \textbf{baixar} (download) o pacote do repositório e \textbf{carregar} em sua área de trabalho.
Para baixar algum pacote disponível no repositório CRAN do R é necessário utilizar o comando \emph{install.packages()} com o nome do pacote entre ,," dentro do parenteses\footnote{ a princípio todas as palavras que escrevemos sem aspas no R ele busca como sendo objetos presentes em nossa área de trabalho ou pacotes carregados ou instalados}.\lstset{frame=single}
\begin{lstlisting}

install.packages("vegan")
\end{lstlisting}



Outra forma é usar o menu da interface gráfica e selecionar. Siga as instruções: (1) selecione o repositório mais próximo (p.ex: \emph{Brazil(SP1)}) e em seguida navegue na barra de pacotes e selecione o que deseja.
Se não houver nenhuma mensagem de erro, significa que o download do pacote foi realizado com sucesso. 

Caso o pacote esteja instalado ele aparecerá entre os hiperlinks da página de ajuda hipertexto (\autoref{sec:Ajuda em Hipertexto: ''help.start''}) da função \emph{help.start()}. Entre na página do pacote e navegue pelas opções e funções que forem de seu interesse. Escolha uma função (decorana) e em seguida tente apresentar o ajuda dela pelo R:\lstset{frame=single}
\begin{lstlisting}

help.start()
help(decorana)

\end{lstlisting}



A mensagem (ou algo similar): \emph{,,No documentation for ‘decorana’ in specified packages and libraries..."}, significa que a sua sessão do R não encontrou a documentação referente a função, apesar do pacote estar instalado em nosso computador. Isso aconteceu porque não carregamos a função em nossa área de trabalho, para cada projeto, precisamos carregar aqueles pacotes que vamos necessitar (normalmente nas primeiras linhas de comando do nosso código):\lstset{frame=single}
\begin{lstlisting}

library(vegan)

example(vegan)

\end{lstlisting}



Podemos imaginar a nossa sessão do R como uma bancada de trabalho em uma oficina, cercada por vários armários que contém as ferramentas que precisamos para realizar uma tarefa. Dependendo da tarefa que vamos realizar (arrumar uma moto, construir uma cadeira...) abrimos os armários que contem as ferramentas necessárias à tarefa desejada e apenas esses (função \emph{library()}). Caso não tenhamos as ferramentas necessárias para uma tarefa específica (consertar um relógio), precisamos ir na loja de ferramentas (repositório) e comprar  conjunto de ferramentas de relojoeiro (função \emph{ install.packates(,,watch")} que vem em um armário que colocamos ao lado dos outros em nossa oficina.

\subsection{\texorpdfstring{Particularidades dos Comandos no R}{Particularidades dos Comandos no R}}
\label{sec:particularidades_dos_comandos_no_r}


Como em toda linguagem, o R tem algumas regras básicas de sintaxe e grafia:
\begin{enumerate}
  \item O nome de comandos e objetos no R pode ser compostos de:

  \begin{itemize}
          \item letras (minúsculas ou maiúsculas),
          \item números, e
          \item o ponto (.).
        \end{itemize}
  \item Evite qualquer outro caracter especial, incluindo \emph{o espaço em branco}.
  \item O nome \emph{não pode ser iniciado} por um número.
  \item O R diferencia maiúscula e minúsculas:  o comando \texttt{q} é diferente do comando \texttt{Q} (que não existe!!!).
\end{enumerate}


Para que um comando seja \textbf{executado} pelo R é necessário ser acompanhado de parênteses '()'.
Compare esse comando\lstset{frame=single}
\begin{lstlisting}

> q()
Save workspace image? [y/n/c]: c
> 
\end{lstlisting}



com o comando\lstset{frame=single}
\begin{lstlisting}

> q
function (save = "default", status = 0, runLast = TRUE) 
.Internal(quit(save, status, runLast))
<environment: namespace:base>
> 
\end{lstlisting}



O comando sem os parênteses é na verdade o \textbf{nome do comando}.  Sendo o R um software de código aberto, toda vez que se digita o
nome de um comando, ele \textbf{não executa} o comando mas \textbf{mostra o conteúdo} do comando (o código).

\end{document}
