Índice

Criação de livros
Adicionar esta página ao seu livro

Criação de livros
Remover esta página de seu livro

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

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 rsplus> </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

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 rsplus> … </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”)