====== Página 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 //wiki// para colocar seu trabalho.
===== Instruções =====
Atenção __**PARA //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
[[http://bie5782.138098.n3.nabble.com/Aviso-Importante-sobre-o-trabalho-final-td4026734.html|Exemplo]]
No tópico abaixo [[#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 '''' ''
''
Usando esse flag o texto vai ficar como o que estão vendo agora nessa frase
Qualquer dúvida veja a página dos alunos do ano passado por exemplo [[05_curso_antigo:alunos2012:alunos:trabalho_final:tauana.cunha:start|Trabalho Final]]
==== Crie sua página ====
- Clique no linque do seu nome para criar a sua página do trabalho final.
- Formate a página com a mesma estrutura da página de exemplo do aluno fictício Fulano.
- Não se esqueça de colocar sua foto! Nos ajuda muito a nos familiarizarmos com a turma (especialmente com 82 alunos ;-) ).
- Depois de criada, o linque com seu nome levará à sua página.
==== Trabalho final====
===O que é?===
* 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.
* A página de ajuda deve estar no formato do R (modelo disponível {{:01_curso2009:material:modelo_help.txt|aqui}}).
* O código da função e o texto de ajuda devem estar formatados como código em sua página (use o //flag// '' ...
'', veja a [[wiki:syntax#non-parsed_blocks|seção de sintaxe do Dokuwiki]]).
* Será que seu código é bom o suficiente? Veja [[http://www.nature.com/news/2010/101013/full/467753a.html|aqui]].
===Etapas===
- Poste em sua página um texto curto com sua proposta de trabalho final.
- Prepare uma proposta alternativa ("plano B"), e também coloque na sua página.
- 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.
- 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.
===== A PROPOSTA =====
//**__Passos para uma boa proposta__**//
Uma boa proposta é um dos principais passos para um bom trabalho, não só nessa disciplina((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((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:
- descreva claramente a tarefa que a função irá realizar, independente do contexto particular
- 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!
* **troque**: //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//
* **por**:// 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 //
- 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 **um dos usos** da função!
- defina claramente os objetos e argumentos de entrada da função:
* **evite**: //entra os dados da planilha que coletei em campo//
* **use**: //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... //
- descreva claramente o objeto de saída e os gráficos gerados
* **evite**: //vai gerar um analise de dados e um gráfico descrito das variáveis//
* **use**: // 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//
- **busque um desafio que o estimule e que te tire da zona de conforto!**
=== Prazos ===
* Proposta: **20 de abril de 2014**
* Revisão final da proposta pelos professores e monitores: **25 de abril de 2014**
* Produto final: **18 de maio 2014**
===== Páginas 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 ((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")
*[[.:fulano:start|]]
*[[.:adgonzalez86:start|Adrian David Gonzalez Chaves ]]
*[[.:alers.dino:start|Alexandre Ribeiro da Silva ]]
*[[.:aline.mansur:start|Aline Luisa Mansur ]]
*[[.:arpiovezani:start|Amanda Rusiska Piovezani ]]
*[[.:andre.dangioli:start|Andre Mouro Dangioli ]]
*[[.:andre.vaquero:start|André Ramos Vaquero ]]
*[[.:anelisa:start|Anelisa Magalhães ]]
*[[.:rb.angelica:start|Angélica Robatino ]]
*[[.:anna.ferraroni:start|Anna Ferraroni ]]
*[[.:annelise_colin:start|Annelise Colin Holz ]]
*[[.:biatocci:start|Bianca Reis Castaldi Tocci ]]
*[[.:bruna.machado:start|Bruna Locardi Machado ]]
*[[.:bsano00:start|Bruno Sano ]]
*[[.:bruno.travassos:start|Bruno Travassos de Britto ]]
*[[.:caian.gerolamo:start|Caian Souza Gerolamo ]]
*[[.:copereira:start|Camila Ortulan Pereira ]]
*[[.:cmadelaire:start|Carla Bonetti Madelaire ]]
*[[.:fred:start|Carlos Frederico Alves de Vasconcelos Neto ]]
*[[.:siliprandi:start|Carolina Correia Siliprandi ]]
*[[.:Carol.signori:start|Caroline Signori Müller ]]
*[[.:czuluagaro:start|Catalina Zuluaga Rodriguez ]]
*[[.:clacorat:start|Clara de Souza Corat ]]
*[[.:sartordaniel:start|Daniel Sartor ]]
*[[.:daniela.ol.lima:start|Daniela Oliveira de Lima ]]
*[[.:ehmoretti:start|Eduardo Hermogenes Moretti ]]
*[[.:fsucunza:start|Federico Sucunza Perez ]]
*[[.:nandavascon:start|Fernanda de Vasconcellos Barros ]]
*[[.:fernando.silverio.ribeiro:start|Fernando Silverio Ribeiro ]]
*[[.:gabriela.marin:start|Gabriela de Lima Marin ]]
*[[.:geissianny:start|Geissianny Bessão de Assis ]]
*[[.:guilherme.antar:start|Guilherme de Medeiros Antar ]]
*[[.:gustavoburin:start|Gustavo Burin Ferreira ]]
*[[.:gustavo.agudelo:start|Gustavo Adolfo Agudelo Cantero ]]
*[[.:imartins:start|Iris Amati Martins ]]
*[[.:ivanreus:start|Ivan Réus Viana ]]
*[[.:jesus.ortega:start|Jesus Eduardo Ortega Chinchilla ]]
*[[.:joan:start|Joan Manel Alfaro Lucas ]]
*[[.:joana_araujo:start|Joana Carvalhaes Borba de Araujo ]]
*[[.:joyce_garcia:start|Joyce Rocha Garcia ]]
*[[.:joyce.prado:start|Joyce Rodrigues do Prado ]]
*[[.:juanphg:start|Juan Pablo Hurtado Gómez ]]
*[[.:juarez:start|Juarez de Castro Cabral ]]
*[[.:julia_ferrua:start|Júlia Ferrúa dos Santos ]]
*[[.:coelho.ju.08:start|Juliana Costa Coelho ]]
*[[.:jufreitas:start|Juliana Ribeirão de Freitas ]]
*[[.:schiesari:start|Luis Schiesari]]
*[[.:lcami.cabanzo10:start|Laura Camila Cabanzo Olarte ]]
*[[.:llemos:start|Leandro Nascimento Lemos ]]
*[[.:leticia.zimback:start|Leticia Bolian Zimback ]]
*[[.:a5115355:start|Letícia Bonfante Sicchieri ]]
*[[.:liedson.carneiro:start|Liedson Tavares de Sousa Carneiro ]]
*[[.:bonjorne:start|Lilian Bonjorne de Almeida ]]
*[[.:luisa.goncalves:start|Luísa Novara Monclar Gonçalves ]]
*[[.:mpombo:start|Maíra Pombo ]]
*[[.:magaiarsa:start|Marilia Palumbo Gaiarsa ]]
*[[.:previero:start|Marilia Previero ]]
*[[.:marina.brenha:start|Marina Rito Brenha ]]
*[[.:maushima:start|Mauricio Shimabukuro ]]
*[[.:maurobrumjr:start|Mauro Brum Monteiro Junior ]]
*[[.:milena:start|Milena Regina Wolf ]]
*[[.:myldred.spinelli:start|Myldred Ometto Spinelli ]]
*[[.:nati.aristizabal1:start|Natalia Aristizábal Uribe ]]
*[[.:helena.nathalia:start|Nathalia Helena Azevedo Pereira ]]
*[[.:paula.giroldo:start|Paula Zaterka Giroldo ]]
*[[.:pedrobalieiro:start|Pedro Balieiro de Almeida Vieira ]]
*[[.:pedrodiasherpeto:start|Pedro Henrique dos Santos Dias ]]
*[[.:raf4rick:start|Rafael dos Santos Henrique ]]
*[[.:renan_ptch:start|Renan Lopes Paitach]]
*[[.:ricardobertoncello:start|Ricardo Bertoncello ]]
*[[.:roberta.graboski:start|Roberta Graboski Mendes ]]
*[[.:paolinorm:start|Roberta Montanheiro Paolino ]]
*[[.:rodolfoprobst:start|Rodolfo da Silva Probst ]]
*[[.:ronaldo:start|Ronaldo Gonçalves Morato ]]
*[[.:lika_rlm:start|Roseli Lika Miashike ]]
*[[.:bolivarmz:start|Sergio David Bolívar Leguizamón ]]
*[[.:sergio.bogao:start|Sérgio Marques de Souza ]]
*[[.:silvio.augusto:start|Silvio Augusto ]]
*[[.:stefanozorzal:start|Stefano Zorzal de Almeida ]]
*[[.:thais.lopes:start|Thais Sasso Lopes ]]
*[[.:tuismara:start|Tulia Isabel Martinez Aguilar ]]
*[[.:vinicius.tonetti:start|Vinicius Rodrigues Tonetti ]]
*[[.:viviane.santos.silva:start|Viviane Santos da Silva ]]