Traduções desta página:

Ferramentas do usuário

Ferramentas do site


05_curso_antigo:r2014:alunos:trabalho_final:start

Essa é uma revisão anterior do documento!


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

Crie sua página

  1. Clique no linque do seu nome para criar a sua página do trabalho final.
  2. Formate a página com a mesma estrutura da página de exemplo do aluno fictício Fulano.
  3. Não se esqueça de colocar sua foto! Nos ajuda muito a nos familiarizarmos com a turma (especialmente com 82 alunos ;-) ).
  4. 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 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

  1. Poste em sua página um texto curto com sua proposta de trabalho final.
  2. Prepare uma proposta alternativa (“plano B”), e também coloque na sua página.
  3. 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.
  4. 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 disciplina1). Investir em uma boa descrição da função vai poupar trabalho posterior e ajudar a ganhar créditos com os monitores e professores2). 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:

  1. descreva claramente a tarefa que a função irá realizar, independente do contexto particular
  2. 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
  3. 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!
  4. 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…
  5. 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
  6. 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 3).

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

1)
no seu mestrado e doutorado tb“
2)
eles estão te avaliando o tempo todo!
3)
bie5782:01_curso_atual:alunos:trabalho_final:“seu usuário”:start
05_curso_antigo/r2014/alunos/trabalho_final/start.1597223093.txt.gz · Última modificação: 2020/08/12 06:04 por 127.0.0.1