\documentclass[a4paper, oneside, 10pt]{article}
\usepackage[unicode]{hyperref}
\usepackage[utf8x]{inputenc}
\usepackage[english]{babel}
\date{\today}
\title{}
\author{}
\begin{document}



\section{\texorpdfstring{Trabalho final}{Trabalho final}}
\label{sec:trabalho_final}


O curso do ano de 2020 foi adiado devido às restrições associadas à pandemia do Coronavírus e readapatado para uma versão totalmente remota. Devido a isso, o trabalho final será reorganizado, consistindo em atividade de exercicios na plataforma \textbf{notaR}.

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 no \emph{wiki} para colocar seu trabalho. Caso ainda não tenha criado sua página, veja instruções em: . Sempre que desejar acessar sua página entre no menu lateral na sessão \textbf{Área Alunos} link Wiki Alunos.

\subsection{\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/bie5782/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\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}


O que deve ter uma funcao 

\subsection{\texorpdfstring{Etapas}{Etapas}}
\label{sec:etapas}


\subsubsection{\texorpdfstring{Proposta}{Proposta}}
\label{sec:proposta}

\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.
\end{enumerate}


\paragraph{\texorpdfstring{A TAREFA}{A TAREFA}}
\label{sec:a_tarefa}


Sua função irá realizar uma tarefa, assim como um script de código. Para caracterizar uma tarefa como algo que merece ser colocado dentro de uma função, ou seja, ir além de um script, a tarefa deve ter algumas características:
\begin{enumerate}
  \item ser uma tarefa geral ou aplicável recorrentemente;
  \item fornecer ao usuário algumas opções de variações na tarefa;
  \item uma tarefa que saiba realizar, ou que possa aprender a realizá-la a tempo de entregar o trabalho.
\end{enumerate}


\paragraph{\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 ajuda a valorizar seu trabalho final. Nossa experiência demonstra que boas propostas normalmente levam a bons/ótimos trabalhos e que propostas mal planejadas derivam trabalhos medianos, em geral com maior esforço associado.   
Abaixo algumas dicas e sugestões para a sua proposta:
\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 bonito}
      \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 tente ser conciso, uma proposta muito longa dificulta a correção. Explicações específicas devem ser colocadas em linques externos. Caso tenha algum conceito importante e específico, crie um linque para uma fonte confiável.
  \item lembre-se: o R não faz mágica, se você não tem nenhum conhecimento sobre a tarefa que será executada pela sua função, vislumbramos dois caminhos: (1) aprender a fazer mágica; (2)  pagar alguém que conheça a tarefa que será executada e domine o R! Desaconselhamos a buscar ambas as saídas: a mágica, porque não acreditamos e o programador porque vai sair caro!
  \item Buque uma tarefa factível, mas que ao mesmo tempo seja \textbf{um desafio estimulante e que te tire da zona de conforto!} 
\end{enumerate}


\emph{\textbf{\underline{\#ficadica}}}
Caso ainda esteja na dúvida de como escrever sua proposta, olhe as propostas dos coleguinhas dos anos anteriores! Explore! 

Aqui vai um bom exemplo de proposta da ex-aluna e atual monitora \href{http://ecologia.ib.usp.br/bie5782/doku.php?id=bie5782:05_curso_antigo:r2017:alunos:trabalho_final:carol.mendonca.bio:start}{Carol Mendonça}

\paragraph{\texorpdfstring{Cópia de código}{Copia de codigo}}
\label{sec:copia_de_codigo}


O código livre tem como premissa que as pessoas podem utilizar o código alheio para modificar e disseminar. 

Entretanto, se apoderar de código alheio sem o devido crédito ao autor, além de moralmente condenável, será interpretado como plágio pela equipe da disciplina.  Incorporar parte de código de outros na sua função é permitido, desde que as linhas ou partes do código copiado sejam indicados claramente, assim como citada a fonte, tanto no código como na documentação da função.

Além disso, a função deve conter parte considerável de código de autoria própria, afinal, o trabalho  avalia a capacidade de produzir uma função. 

Caso a equipe entenda que houve plágio, definido aqui como cópia total ou parcial de código sem a indicação da fonte, a nota do trabalho será zero, o que ocasiona  a reprovação do aluno. Caso a fonte esteja citada, a equipe avaliará se há construção de código próprio suficiente para caracterizar o bom desempenho do aluno, nesse caso a cópia não ocasionará nenhum penalidade ao aluno, e sua função será avaliada normalmente.

\subsubsection{\texorpdfstring{Minha função}{Minha funao}}
\label{sec:minha_funao}

\begin{enumerate}
  \item invista em uma boa proposta,
  \item use o fórum para postar dúvidas,
  \item lembre-se: os monitores querem ajudá-lo,
  \item não acabe com a paciência dos professores,
  \item não esqueça: vc. irá sobreviver!
\end{enumerate}


\paragraph{\texorpdfstring{O Código}{O Codigo}}
\label{sec:o_codigo}


TODAS AS LINHAS DO CÓDIGO DEVEM POSSUIR COMENTÁRIOS EXPLICATIVOS! TODAS!! 

Os objetivos dessa exigência são:
\begin{enumerate}
  \item incentivá-los a cultivar o hábito saudável de sempre comentar seus códigos 
  \item ajudar os monitores e professores a entender o código de vocês. 
  \item ajudar futuros alunos que consultem suas funções a entender o código também. 
\end{enumerate}


A regra é clara: toda linha de código devem 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}

\paragraph{\texorpdfstring{A formatação do Trabalho Final}{A formataao do Trabalho Final}}
\label{sec:a_formataao_do_trabalho_final}


No inicio dessa página  Trabalho Final (\autoref{sec:Trabalho Final}) há uma indicação clara sobre o formato de postagem da função e do help. 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.

São exigências muito simples de formatação, qualquer dúvida poste no fórum, converse com um monitor ou veja página dos alunos de outros anos.

\subsection{\texorpdfstring{Prazos}{Prazos}}
\label{sec:prazos}


Os prazos foram mudados. Fique atento aos novos prazos.
\begin{itemize}
  \item Proposta (primeira versão): \textbf{07 de junho de 2019} 
  \item Revisão final da proposta pelos professores e monitores: \textbf{12-14 de junho de 2019}\footnote{data prorrogada até dia 14 de junho devido a mudança na entrega das propostas}
  \item Produto final \textbf{01 de julho 2019}
\end{itemize}


\subsection{\texorpdfstring{Quanto vale minha função?}{Quanto vale minha funao}}
\label{sec:quanto_vale_minha_funao}


Não sabemos! Uma boa função pode ter um valor inestimável. Imagine que sua função busque e ordene páginas web a partir de palavra(as) chaves\footnote{antes do google, logicamente}? Valeria uma fortuna em 1995! No caso da disciplina, o trabalho final tem peso 7/10 na nota final, veja pesos da avaliação em  . 

\underline{\emph{\textbf{Pontos considerados na avaliação do trabalho final}}}
\begin{enumerate}
  \item a função roda o exemplo do help;
  \item a função cumpre a descrição da proposta acordada;
  \item há generalidade no seu uso;
  \item a documentação é adequada e informativa;
  \item demonstra domínio básico da linguagem;
  \item os comentários são informativos; 
  \item há redundâncias no código;
  \item complexidade da tarefa executada;
\end{enumerate}


\end{document}
