Índice

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.

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 Exemplo

<box 70% red| Atenção na formatação ao postar seu trabalho> 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 <code> </code>

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 Trabalho Final </box>

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.

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 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 <code> … </code>, veja a seção de sintaxe do Dokuwiki).
Será que seu código é bom o suficiente? Veja 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¹⁾. Investir em uma boa descrição da função vai poupar trabalho posterior e ajudar a ganhar créditos com os monitores e professores²⁾. 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

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 ³⁾.

Veja um exemplo na página do aluno Fulano de Tal (vá à página e e clique na opção “exibir código”)