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



\section{\texorpdfstring{Página dos alunos e trabalho final}{Pagina dos alunos e trabalho final}}
\label{sec:pagina_dos_alunos_e_trabalho_final}


O trabalho final da disciplina é criar uma função e sua página de ajuda, no formato usado pelo R. Cada aluno abrirá uma página neste \emph{wiki} para colocar seu trabalho.

\subsection{\texorpdfstring{Instruções}{Instruoes}}
\label{sec:instruoes}


 Atenção \underline{\textbf{PARA \emph{NOVAS INSTRUÇÕES}}}
ATENÇÃO!!

QueRid@s alun@s, um aviso importante sobre o trabalho final:
TODAS AS LINHAS DO CÓDIGO DEVEM POSSUIR COMENTÁRIOS EXPLICATIVOS! TODAS!! 

Os objetivos dessa exigência são: 
- incentivá-los a cultivar o hábito saudável de sempre comentar seus códigos 
- ajudar os monitores a entender o código de vocês. 
- ajudar futuros alunos que consultem suas funções a entender o código também. 

A regra é clara: toda linha de código tem que ter um comentário explicando o que a linha faz. 
Além disso, comentários gerais no começo ou no meio da função são bem vindos. A idéia é explicar cada passo da lógica da sua função. As únicas linhas de código que dispensam comentários são abre chaves e fecha chaves. 

No Fórum tem um exemplo de uma função bem simples com comentários em todas as linhas
\href{http://bie5782.138098.n3.nabble.com/Aviso-Importante-sobre-o-trabalho-final-td4026734.html}{Exemplo} Atenção na formatação ao postar seu trabalho
No tópico abaixo Trabalho Final (\autoref{sec:Trabalho Final}) há uma indicação clara para colocarem a função e o help com o formato de código na página. Isso ajuda muito na correção e permite que usuários vejam o código da função sem a necessidade de baixar o arquivo em seus computadores.
Para fazer isso é muito simples, basta colocar todo o texto do código, da maneira como fez no arquivo (copy/paste) na sua página com texto entre os flags de código \texttt{\textless code\textgreater } \texttt{\textless /code\textgreater }
\lstset{frame=single}
\begin{lstlisting}
Usando esse flag o texto vai ficar como o que estão vendo agora nessa frase \end{lstlisting}



Qualquer dúvida veja a página dos alunos do ano passado por exemplo Trabalho Final

\subsubsection{\texorpdfstring{Crie sua página}{Crie sua pagina}}
\label{sec:crie_sua_pagina}

\begin{enumerate}
  \item Clique no linque do seu nome para criar a sua página do trabalho final. 
  \item Formate a página com a mesma estrutura da página de exemplo do aluno fictício Fulano.
  \item Não se esqueça de colocar sua foto! Nos ajuda muito a nos familiarizarmos com a turma (especialmente com 82 alunos ;-) ).
  \item Depois de criada, o linque com seu nome levará à sua página.
\end{enumerate}


\subsubsection{\texorpdfstring{Trabalho final}{Trabalho final}}
\label{sec:trabalho_final}


\paragraph{\texorpdfstring{O que é?}{O que e}}
\label{sec:o_que_e}

\begin{itemize}
  \item O trabalho final consiste em publicar em sua página o código da função, o arquivo da função, e a página de ajuda.
  \item A página de ajuda deve estar no formato do R (modelo disponível \href{media/bie5782/01_curso2009/material/modelo_help.txt}{aqui}).
  \item O código da função e o texto de ajuda devem estar formatados como código em sua página (use o \emph{flag} \texttt{\textless code\textgreater  ... \textless /code\textgreater }, veja a \href{http://labtrop.ib.usp.br/doku.php?id=wiki:syntax\%23non-parsed_blocks}{seção de sintaxe do Dokuwiki}).
  \item Será que seu código é bom o suficiente? Veja \href{http://www.nature.com/news/2010/101013/full/467753a.html}{aqui}.
\end{itemize}


\paragraph{\texorpdfstring{Etapas}{Etapas}}
\label{sec:etapas}

\begin{enumerate}
  \item Poste em sua página um texto curto com sua proposta de trabalho final. 
  \item Prepare uma proposta alternativa (,,plano B"), e também coloque na sua página.
  \item A equipe de professores e monitores postará na sua página a avaliação de viabilidade de sua proposta, e também dicas e sugestões.
  \item Poste o seu trabalho final, que é o código da função e página de ajuda na sua página. Suba também o script da função e coloque-o disponível para download na sua página.
\end{enumerate}


\subsection{\texorpdfstring{A PROPOSTA}{A PROPOSTA}}
\label{sec:a_proposta}


\emph{\textbf{\underline{Passos para uma boa proposta}}}

Uma boa proposta é um dos principais passos para um bom trabalho, não só nessa disciplina\footnote{no seu mestrado e doutorado tb,,}. Investir em uma boa descrição da função vai poupar trabalho posterior e ajudar a ganhar créditos com os monitores e professores\footnote{eles estão te avaliando o tempo todo!}. Nossa experiência tem demonstrado que boas propostas normalmente levam a bons/ótimos trabalhos e que propostas mal planejadas levam a trabalhos medianos com esforço muito grande.   
Abaixo algumas dicas e sugestões de passos:
\begin{enumerate}
  \item descreva claramente a tarefa que a função irá realizar, independente do contexto particular   
  \item evite iniciar a descrição da proposta com o seus dados e sua área de atuação, tente descrever a tarefa o mais independente possível do grupo taxonômico, área de atuação ou preferências religiosas ou sexuais! 

  \begin{itemize}
      \item \textbf{troque}: \emph{minha função ira tratar os dados da circunferência da barriga de coelhos da páscoa que coletei na semana santa e fazer um teste de permutação da diferença entre as médias do tamanho da pança de machos e fêmeas}
      \item \textbf{por}:\emph{ a função irá tratar dados de duas variáveis quantitativas e gerar um teste de permutação da diferença entre as médias das variáveis }
    \end{itemize}
  \item caso sinta necessidade de explicar melhor a tarefa descrita no primeiro tópico, exemplifique o uso da função no contexto do seu trabalho (finalmente!), de preferência apenas como \textbf{um dos usos} da função!
  \item  defina claramente os objetos e argumentos de entrada da função:

  \begin{itemize}
      \item \textbf{evite}: \emph{entra os dados da planilha que coletei em campo}
      \item \textbf{use}: \emph{um vetor numérico quantitivo, um dataframe com variáveis x e y, um argumento lógico de exclusão de NA, um argumento que define o tipo de índice que será calculado com as seguintes opções... }   
    \end{itemize}
  \item descreva claramente o objeto de saída e os gráficos gerados

  \begin{itemize}
      \item \textbf{evite}: \emph{vai gerar um analise de dados e um gráfico descrito das variáveis}
      \item \textbf{use}: \emph{ vai retornar um data-frame com as seguintes colunas..., uma lista com os seguintes resultados, um boxplot da variável y e um scatterplot de xy e a linha do modelo linear}
    \end{itemize}
  \item \textbf{busque um desafio que o estimule e que te tire da zona de conforto!} 
\end{enumerate}


\paragraph{\texorpdfstring{Prazos}{Prazos}}
\label{sec:prazos}

\begin{itemize}
  \item Proposta: \textbf{20 de abril de 2014} 
  \item Revisão final da proposta pelos professores e monitores: \textbf{25 de abril de 2014}
  \item Produto final: \textbf{18 de maio 2014}
\end{itemize}


\subsection{\texorpdfstring{Páginas dos Alunos}{Paginas dos Alunos}}
\label{sec:paginas_dos_alunos}


Ao clicar pela primeira vez no linque de sua página, você poderá criá-la caso esteja devidamente autenticado. Confira seu usuário verificando o endereço que aparece posicionando o ponteiro do mouse no linque da sua página \footnote{bie5782:01\_curso\_atual:alunos:trabalho\_final:,,seu usuário":start}. 

Veja um exemplo na página do aluno Fulano de Tal (vá à página e e clique na opção ,,exibir código")
\begin{itemize}
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:fulano:start}{.:fulano:start}
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:adgonzalez86:start}{Adrian David Gonzalez Chaves }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:alers.dino:start}{Alexandre Ribeiro da Silva }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:aline.mansur:start}{Aline Luisa Mansur }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:arpiovezani:start}{Amanda Rusiska Piovezani }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:andre.dangioli:start}{Andre Mouro Dangioli }
  \itemAndré Ramos Vaquero 
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:anelisa:start}{Anelisa Magalhães }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:rb.angelica:start}{Angélica Robatino }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:anna.ferraroni:start}{Anna Ferraroni }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:annelise_colin:start}{Annelise Colin Holz }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:biatocci:start}{Bianca Reis Castaldi Tocci }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:bruna.machado:start}{Bruna Locardi Machado }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:bsano00:start}{Bruno Sano }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:bruno.travassos:start}{Bruno Travassos de Britto }
  \itemCaian Souza Gerolamo 
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:copereira:start}{Camila Ortulan Pereira }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:cmadelaire:start}{Carla Bonetti Madelaire }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:fred:start}{Carlos Frederico Alves de Vasconcelos Neto }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:siliprandi:start}{Carolina Correia Siliprandi }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:carol.signori:start}{Caroline Signori Müller }
  \itemCatalina Zuluaga Rodriguez 
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:clacorat:start}{Clara de Souza Corat }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:sartordaniel:start}{Daniel Sartor }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:daniela.ol.lima:start}{Daniela Oliveira de Lima }
  \itemEduardo Hermogenes Moretti 
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:fsucunza:start}{Federico Sucunza Perez }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:nandavascon:start}{Fernanda de Vasconcellos Barros }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:fernando.silverio.ribeiro:start}{Fernando Silverio Ribeiro }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:gabriela.marin:start}{Gabriela de Lima Marin }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:geissianny:start}{Geissianny Bessão de Assis }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:guilherme.antar:start}{Guilherme de Medeiros Antar }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:gustavoburin:start}{Gustavo Burin Ferreira }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:gustavo.agudelo:start}{Gustavo Adolfo Agudelo Cantero }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:imartins:start}{Iris Amati Martins }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:ivanreus:start}{Ivan Réus Viana }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:jesus.ortega:start}{Jesus Eduardo Ortega Chinchilla }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:joan:start}{Joan Manel Alfaro Lucas }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:joana_araujo:start}{Joana Carvalhaes Borba de Araujo }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:joyce_garcia:start}{Joyce Rocha Garcia }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:joyce.prado:start}{Joyce Rodrigues do Prado }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:juanphg:start}{Juan Pablo Hurtado Gómez }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:juarez:start}{Juarez de Castro Cabral }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:julia_ferrua:start}{Júlia Ferrúa dos Santos }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:coelho.ju.08:start}{Juliana Costa Coelho }
  \itemJuliana Ribeirão de Freitas 
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:schiesari:start}{Luis Schiesari}
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:lcami.cabanzo10:start}{Laura Camila Cabanzo Olarte }
  \itemLeandro Nascimento Lemos 
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:leticia.zimback:start}{Leticia Bolian Zimback }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:a5115355:start}{Letícia Bonfante Sicchieri }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:liedson.carneiro:start}{Liedson Tavares de Sousa Carneiro }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:bonjorne:start}{Lilian Bonjorne de Almeida }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:luisa.goncalves:start}{Luísa Novara Monclar Gonçalves }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:mpombo:start}{Maíra Pombo }
  \itemMarilia Palumbo Gaiarsa 
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:previero:start}{Marilia Previero }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:marina.brenha:start}{Marina Rito Brenha }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:maushima:start}{Mauricio Shimabukuro }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:maurobrumjr:start}{Mauro Brum Monteiro Junior }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:milena:start}{Milena Regina Wolf }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:myldred.spinelli:start}{Myldred Ometto Spinelli }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:nati.aristizabal1:start}{Natalia Aristizábal Uribe }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:helena.nathalia:start}{Nathalia Helena Azevedo Pereira }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:paula.giroldo:start}{Paula Zaterka Giroldo }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:pedrobalieiro:start}{Pedro Balieiro de Almeida Vieira }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:pedrodiasherpeto:start}{Pedro Henrique dos Santos Dias }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:raf4rick:start}{Rafael dos Santos Henrique }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:renan_ptch:start}{Renan Lopes Paitach}
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:ricardobertoncello:start}{Ricardo Bertoncello }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:roberta.graboski:start}{Roberta Graboski Mendes }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:paolinorm:start}{Roberta Montanheiro Paolino }
  \itemRodolfo da Silva Probst 
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:ronaldo:start}{Ronaldo Gonçalves Morato }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:lika_rlm:start}{Roseli Lika Miashike }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:bolivarmz:start}{Sergio David Bolívar Leguizamón }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:sergio.bogao:start}{Sérgio Marques de Souza }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:silvio.augusto:start}{Silvio Augusto }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:stefanozorzal:start}{Stefano Zorzal de Almeida }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:thais.lopes:start}{Thais Sasso Lopes }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:tuismara:start}{Tulia Isabel Martinez Aguilar }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:vinicius.tonetti:start}{Vinicius Rodrigues Tonetti }
  \item\href{http://labtrop.ib.usp.br/doku.php?id=cursos:ecor:05_curso_antigo:r2014:alunos:trabalho_final:viviane.santos.silva:start}{Viviane Santos da Silva }
\end{itemize}


\end{document}
