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



\section{\texorpdfstring{João Callefe}{Joao Callefe}}
\label{sec:joao_callefe}


\includegraphics[keepaspectratio=true,width=0.8\textwidth]{bie5782/01_curso_atual/alunos/trabalho_final/joaocallefe/foto}


Mestrando em Ciência Animal no programa de Epidemiologia Experimental Aplicada às Zoonoses (FMVZ-USP).

O título da minha dissertação de mestrado é ,,Sistemas de vigilância em Saúde Animal: proposta para brucelose e tuberculose bovinas", orientado pelo Prof. Dr. José Soares Ferreira Neto. 

\subsection{\texorpdfstring{Meus exercícios}{Meus exercicios}}
\label{sec:meus_exercicios}


\href{http://ecor.ib.usp.br/doku.php?id=05_curso_antigo:r2019:alunos:trabalho_final:joaocallefe:exec}{.:exec}

\subsubsection{\texorpdfstring{Proposta de trabalho final}{Proposta de trabalho final}}
\label{sec:proposta_de_trabalho_final}


\begin{center}
\line(1,0){250}
\end{center}



\paragraph{\texorpdfstring{Proposta A}{Proposta A}}
\label{sec:proposta_a}


\subparagraph{\texorpdfstring{Contextualização}{Contextualizaao}}
\label{sec:contextualizaao}


Muitos bancos e planilhas de dados gerados a partir da coleta de informações de interesse podem apresentar problemas de completude. A completude consiste na proporção entre de dados coletados e não coletados, mas que tinham intenção de coleta. A falta de preenchimento, assim como erros ou variações na grafia dificultam o aproveitamento dos dados e podem tornar a análise inviável.

Na medicina veterinária, isso é bastante comum devido aos diferentes modos de se referir a uma espécie animal no momento em que esse dado é coletado. Por exemplo, ao referir-se a um bovino, o operador pode escrever e/ou abreviar de diferentes maneiras: bovino, bovis, boi, vaca, gado, bov, bovi, etc. Isso pode dificultar e atrasar a análise dos dados, pois o responsável pela análise precisará corrigir cada observação, e isso se torna bastante inapropriado quando o número de registros é alto.

Para resolver este problema, uma função que ajude a filtrar, corrigir e dimensionar os erros de preenchimento pode der bastante útil. A função (complete.vet) permite que o usuário tenha uma visão geral do banco de dados, sobre a quantidade de campos não preenchidos e corrija o campo de espécie em diferentes grafias dentre as especies de animais domésticos utilizados na produção. 

\textbf{Planejamento da função}

\textbf{Entrada:} \texttt{complete.vet} (\texttt{file}, \texttt{colm}, \texttt{specie}, \texttt{fill}, \texttt{completeness} )

\begin{center}
\line(1,0){250}
\end{center}



\texttt{file}: class \texttt{data.frame} no formato .csv

\texttt{colm}:vetor de classe \texttt{character} com a espécie do animal que foi registrada.

\texttt{specie}: determinar qual espécie devem ser identificadas no vetor \texttt{colm}.

\texttt{fill}: definir qual nome padrão deve ser utilizado para preencher o vetor \texttt{colm}.

\texttt{completness}: vetor lógico \texttt{= TRUE} calcula a proporção de NAs no banco se houver upload de \texttt{file}. 

\textbf{Verificando parâmetros}

\texttt{file} deve ser no fomato .csv, se não, escrever: ,,\texttt{file} deve ser em formato .csv"

\texttt{colm} deve ser vetor da classe \texttt{character}.Se não, escrever: ,,\texttt{colm} deve ser da classe \texttt{character}.

\textbf{Pseudo-código}

Criar objeto \texttt{file} para carregar arquivos

Criar objeto \texttt{colm} para determinar qual coluna do \texttt{data.frame} ou vetor deve ser utilizado para identificar os padrões de escrita

Criar objeto \texttt{specie} que contenha diveros níveis com as possíveis grafias que se refiram aos animais domésticos: bovino, suino, ave, equino, caprino, ovino, cão, gato.

Filtrar todas as possíveis grafias

Criar objeto \texttt{fill} atribuido pelo usuário para substituir as grafias por um padrão determinado

Criar objeto \texttt{completness} com um vetor lógico \texttt{ = TRUE} quando houver interesse em determinar a proporção de incompletude do banco. Soma os NAs e divide pelo número de campos disponíveis para o preenchimento.

\textbf{Saída}

Data frame ou vetor corrigido com o nome padrão para espécie 

Proporção de completude 

\begin{center}
\line(1,0){250}
\end{center}



\paragraph{\texorpdfstring{Proposta B}{Proposta B}}
\label{sec:proposta_b}


\subparagraph{\texorpdfstring{Contextualização}{Contextualizaao}}
\label{sec:contextualizaao2}


Doenças infecciosas de importância para saúde pública e animal são contempladas, geralmente, com sistemas de vigilância epidemiológica que visam estratégias de prevenção, rápida detecção e combate a focos e disseminação. Para isso, além de componentes de vigilância passiva, como as notificações mandatórias respaldadas por legislação específica (dependendo do agravo em questão), são necessárias medidas ativas, ou seja, busca de potenciais casos de doença numa população suscetível.

Deste modo, componentes ativos de busca de doenças podem ser realizados a partir da coleta de espécimes biológicos para diagóstico, uma vez que o processo de investigação seja desencadeado. Para tal, o processo de amostragem é essencial, dado que a coleta censitária seria extremanete onerosa e infactível.

Esse processo de amostragem é geralmente realizado em dois níveis: agragado (representando fazendas, abatedouros, granjas, por exemplo) ou individual (animais ou carcaças). 

A ideia desta função (smart.sample) é definir o número necessário de fazendas e/ou de animais que devem ser amostrados. Além disso, quando necessario, o usuario poderá de imediato saber quais animais devem ser coletados para avaliar a prevalência aparente de determinada região ou fazenda.
\begin{itemize}
  \item Em nível agregado: utilização de amostragem aleatória simples entre as fazendas ou abatedoutros de uma região determinada
\end{itemize}

\begin{itemize}
  \item Amostragem a nível individual:
\end{itemize}


Amostragem para proporção ou prevalência aparente (estudo transversal em população infinita ou finita), sem considerar a imperfeição do teste. Onde P é a proporção esperada:

\centering\includegraphics[keepaspectratio=true,width=0.8\textwidth]{bie5782/01_curso_atual/alunos/trabalho_final/joaocallefe/screenshot_2019-06-03_at_11.51.54}


\textbf{Planejamento da função}

\textbf{Entrada:} \texttt{smart.sample} ( \texttt{dado}, \texttt{population}, \texttt{N}, \texttt{confidence}, \texttt{precision}, \texttt{position}, \texttt{P} )

\begin{center}
\line(1,0){250}
\end{center}



\texttt{dado}:\texttt{data.frame} deve conter a identificação do agregado (agr) e/ou indivíduo (ind), caso \texttt{position = TRUE}. class \texttt{data.frame}.

\texttt{population}: magnitude da população. \texttt{=TRUE} considerado finita e utiliza o valor ajustado. Default (\texttt{= FALSE}).

\texttt{N}: tamanho de cada população (classe: integer, \texttt{N} \textgreater  0). \texttt{population} deve ser \texttt{= TRUE}.

\texttt{confidence}: confiança desejada (classe: numeric com 2 casas decimais 0 \textgreater  \texttt{confidence} \textless  1). Default (\texttt{= 0.95})

\texttt{precision}:precisão desejada (classe: numeric com 2 casas decimais \texttt{e} \textgreater  0).

\texttt{position}: vetor lógico (\texttt{=TRUE}) determina que a função mostre quais animais ou fazendas devem ser amostrados. Default (\texttt{= FALSE}). 

\texttt{P}: proporcao esperada para o agravo. (\texttt{numeric})

\textbf{Verificando parâmetros}

\texttt{file}: deve conter a identificação do agregado e/ou indivíduo, caso \texttt{position = TRUE}. class (\texttt{data.frame}). Se não, escrever:,,O arquivo deve ser em formato \texttt{.csv} separado por ";" e conter a identificação de agregados e/ou indivíduos. \texttt{position} deve ser \texttt{= TRUE}.

\texttt{N}: tamanho de cada população (classe: integer, \texttt{N} \textgreater  0). \texttt{population} deve ser \texttt{= TRUE}. Se não, escrever: \texttt{N} deve ser maior que zero )aplicável se \texttt{population = TRUE} e \texttt{imperfection = TRUE}.

\texttt{confidence}:(classe: numeric com 2 casas decimais 0 \textgreater  \texttt{confidence} \textless  1). Se não, escrever: class deve ser numeric e entre 0 e 1.

\texttt{precision}: classe: numeric com 2 casas decimais \texttt{e} \textgreater  0). Se não, escrever: class deve ser numeric e maior que 0.

\textbf{Pseudo-código}

Cria objeto \texttt{dado}

Cria objeto \texttt{population} determinando a partir de um vetor lógico se a população é finita (\texttt{=FALSE}) ou infinita (\texttt{=TRUE}). Se \texttt{population=FALSE}utiliza formula ajustada e necessita do valor de \texttt{N}, quando \texttt{imperfection = TRUE}. 

Cria objeto \texttt{N} para identificar o número de individuos de uma população finita. Objeto \texttt{N} com NAs.

Cria objeto \texttt{confidence} que determina o valor de tabela Z para o valor de confiança atribuida.

Cria objeto \texttt{precision} para o valor designado pelo usuário. 

Cria objeto \texttt{position} quando existe o upload de \texttt{file} e se \texttt{position = TRUE}. Determina quais individuos ou agregados foram amostrados.

Os parâmetros e vetores lógicos são criados a partir desta interação por meio dos controladores de fluxo \texttt{if}/\texttt{else}.

Preenche a fórmula de acordo com os parâmetros e as perguntas respondidas pelo usuário

Para casos onde \texttt{position = TRUE} faz um sorteio dentro do \texttt{data.frame} (aleatória simples) para determinar quais os individuos ou agregados devem ser amostrados, baseados no número determinado pela fórmula. 

\textbf{Saída}:

Determina o número de individuos ou agregados que devem ser amostrados para determinar a prevalência de um agravo ou fenômeno determinado.

Determina quais individuos ou agregados devem ser amostrados frente ao valor estipulado em populacoes finitas.

Oi João, achei que os dois planos são factíveis e trazem algo de interessante, mas gostei mais do plano B.

Só tenho como recomendação que vc explique melhor o que está acontecendo na hora de escrever o help da função. Muitos dos termos que vc usou parecem ser jargões da área de epidemiologia/zoonoses que eu não entendi, mas acho que vc consegue explicar melhor.

Uma dica sobre data.frames e arquivos. É melhor que sua função receba um data.frame, e não um nome de arquivo. Com isso, o usuário pode guardar os dados no formato que quiser, ler conforme esse formato, e depois passar pra sua função só o data.frame. Facilita a vida de todo mundo!

Uma dica sobre usabilidade. NÃO É UMA BOA IDÉIA escrever funções interativas. O melhor é que a função tenha argumentos que representem as respostas a essas perguntas. Não tem problema se forem muitos argumentos. Funções interativas geram códigos de baixa reproducibilidade, o que tira uma das grandes vantagens de usar o R.

Minha recomendação, então, é seguir o plano B, mas sem interatividade e sem receber nomes de arquivos. A função receberia o data.frame no formato especificado (tem que ficar bem explicado no help!) e uma série de parâmetros descrevendo o que o usuário quer/espera de sua amostragem.

Danilo G Muniz

\subsubsection{\texorpdfstring{Trabalho final: Determinacao do numero amostral e identificacao de elementos sorteados}{Trabalho final Determinacao do numero amostral e identificacao de elementos sorteados}}
\label{sec:trabalho_final_determinacao_do_numero_amostral_e_identificacao_de_elementos_sorteados}


\paragraph{\texorpdfstring{Código da funçao 'smart.sample'}{Codigo da funao smartsample}}
\label{sec:codigo_da_funao_smartsample}


\href{http://ecor.ib.usp.br/doku.php?id=05_curso_antigo:r2019:alunos:trabalho_final:joaocallefe:codigo}{.:Codigo}

\paragraph{\texorpdfstring{Help da funçao 'smart.sample'}{Help da funao smartsample}}
\label{sec:help_da_funao_smartsample}


\href{http://ecor.ib.usp.br/doku.php?id=05_curso_antigo:r2019:alunos:trabalho_final:joaocallefe:help}{.:Help}

\end{document}
