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