\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{Arthur Bottacin Cambler}{Arthur Bottacin Cambler}}
\label{sec:arthur_bottacin_cambler}


\includegraphics[keepaspectratio=true,width=0.8\textwidth]{bie5782/01_curso_atual/alunos/trabalho_final/arthur.cambler/definitiva}


Mestrando em Botânica pelo Instituto de Biociências da USP

Título do projeto: Adaptação do método de fracionamento de parede celular de cana-de-açúcar para análise de um grande número de amostras\\Orientador: Marcos Silveira Buckeridge

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



\section{\texorpdfstring{Meus Exercícios}{Meus Exercicios}}
\label{sec:meus_exercicios}


Resolução dos exercícios: \href{http://ecor.ib.usp.br/doku.php?id=05_curso_antigo:r2018:alunos:trabalho_final:arthur.cambler:exec}{.:exec}

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



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


\subsubsection{\texorpdfstring{Plano A: Preenchendo a ficha de Dungeons and Dragons}{Plano A Preenchendo a ficha de Dungeons and Dragons}}
\label{sec:plano_a_preenchendo_a_ficha_de_dungeons_and_dragons}


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


Para jogar “Dungeons and Dragons”, um RPG de mesa, é importante utilizar uma \href{http://ecor.ib.usp.br/doku.php?id=05_curso_antigo:r2018:alunos:trabalho_final:arthur.cambler:pdfs}{ficha de personagem} para organizar as informações do seu personagem.  Entretanto, preencher uma ficha de personagem não é algo trivial, sendo necessária a escolha da raça do seu personagem, de sua classe, o sorteio e distribuição dos seus atributos, a descrição de suas características e a escolha dos equipamentos e magias (\href{http://dnd.wizards.com/products/tabletop/players-basic-rules\#howtoplayparent_911}{Regras para criar personagens}). Todas estas escolhas e sorteios vão afetar diferentes aspectos do seu personagem, o que pode tornar o preenchimento da ficha uma tarefa bastante confusa e demorada. Por esse motivo, a minha função pretende auxiliar a montagem da ficha de personagem de “Dungeons and Dragons”, permitindo que o jogador escolha os diferentes parâmetros para o seu personagem de nível 1 e retornando os valores calculados e dados necessários para preencher a ficha. Em outras palavras, minha função recebe os argumentos definidos pelo usuário e utiliza-os para calcular, sortear ou escolher diferentes parâmetros (numéricos ou textuais) retornando para o usuário uma lista com diferentes tipos de informação

\paragraph{\texorpdfstring{Planejamento da função}{Planejamento da funao}}
\label{sec:planejamento_da_funao}


\textbf{Entrada:} fichaDnD (\texttt{atrib}, \texttt{ord}, \texttt{alinh}, \texttt{rac}, \texttt{clas}, \texttt{antec})

\texttt{atrib} = Escolha do modo como os atributos serão escolhidos (vetor composto por caracteres com dois possíveis argumentos)\\
\texttt{ord} = Ordem dos atributos, do que terá o maior valor para o menor em sequência (vetor composto por 6 caracteres em uma ordem específica determinada pelo usuário)\\
\texttt{alinh} = Escolha o seu alinhamento (vetor composto por caracteres escolhendo um frente a 9 possibilidades)\\
\texttt{rac} = Escolha da raça do personagem (vetor composto por caracteres escolhendo um frente a 9 possibilidades)\\
\texttt{clas} = Escolha da classe do personagem (vetor composto por caracteres escolhendo um frente a 12 possibilidades)\\
\texttt{antec} = Escolha dos antecedentes do personagem (vetor composto por caracteres escolhendo um frente a 13 possibilidades)

\textbf{Verificando os argumentos da função:}

Para \texttt{atrib}, \texttt{alinh}, \texttt{rac}, \texttt{clas} e \texttt{antec}: é um vetor de caracteres com um único elemento? Se não, retornar: “atrib/alinh/rac/clas/antec deve conter apenas caracteres e um único elemento”\\
Para \texttt{atrib}, \texttt{alinh}, \texttt{rac}, \texttt{clas} e \texttt{antec}: contém ao menos um dos argumentos possíveis? Se não, retornar: “atrib/alinh/rac/clas/antec tem X possíveis argumentos, (lista dos argumentos), escolha um deles”\\
\texttt{ord} é um vetor de caracteres com 6 elementos? Se não, retornar: “ord deve conter apenas caracteres e 6 elementos, “For”, “Des”, “Con”, “Int”, “Sab”, “Car”, do maior para o menor”\\
\texttt{ord} contém os elementos corretos? Se não, retornar: “ord deve conter 6 elementos denominados “For”, “Des”, “Con”, “Int”, “Sab”, “Car””\\

\textbf{Pseudo-código:}

1- Criar os objetos que vão compor a saída:\\
Data frame \emph{atributos}\\
Data frame \emph{dados.gerais}\\
Data frame \emph{teste.resist}\\
Data frame \emph{habilidades.pro}\\
Data frame \emph{habilidades.tot}\\
Vetor \emph{magias}\\
Data frame \emph{especiais}\\
Data frame \emph{caracteristicas}\\
Data frame \emph{equipamentos}\\
Data frame \emph{proficiencias}\\
Data frame \emph{info}

2- A partir do argumento \texttt{atrib} fazer:\\
- Sorteio dos valores (uso de um \textbf{for} para colocar cada valor sorteado em uma coluna)\\
OU\\
- Usar valores fixos pré-determinados (livro do jogador)

3- Com os valores definidos, ordená-los conforme o argumento \texttt{ord} e guardar no objeto \emph{atributos}.\\
Alterações no objeto \emph{dados.gerais}

4, 5, 6 e 7- Usar de \textbf{if}s encadeados ou da função \textbf{switch} para os argumentos \texttt{rac}, \texttt{clas}, \texttt{alinh} e \texttt{antec} permitindo que cada um deles execute uma tarefa diferente.\\
- \texttt{rac} vai gerar alterações nos objetos \emph{atributos}, \emph{dados.gerais} e \emph{info}.\\
- \texttt{clas} vai alterar os objetos \emph{especiais}, \emph{dados.gerais}, \emph{proficiências}, \emph{equipamentos}, \emph{teste.resist} e \emph{magias}.\\
- \texttt{alinh} vai alterar o objeto \emph{características}\\
- \texttt{antec} vai alterar o objeto \emph{caracteristicas}. Para isso é necessário sortear as características usando um \textbf{for} e checar a compatibilidade com o argumento \texttt{alinh} usando de \textbf{if}s.

8- De resto serão feitos 4 tipos de procedimento para os diferentes objetos de modo a obter os números e textos necessários para o preenchimento da ficha de personagem:\\
- Acrescentar valores pré-definidos (livro do jogador) de acordo com os argumentos escolhido\\
- Seleção e cópia de números entre data frames (por indexação)\\
- Uso de valores contidos em data frames para cálculos diversos em outros data frames (por indexação)\\
- Operações matemáticas básicas

9- Retornar ao usuário texto informando sobre alguns cálculos que não serão feitos e como ele deve fazê-lo (função \textbf{message})

\textbf{Saída:}\\
Lista juntando todos os objetos criados:\\
Data frame \emph{atributos} (2 linhas e 6 colunas)\\
Data frame \emph{dados.gerais} (2 linhas e 6 colunas)\\
Data frame \emph{teste.resist} (1 linhas e 6 colunas)\\
Vetor \emph{habilidades.pro}\\
Data frames \emph{habilidades.tot} (1 linha e 18 colunas)\\
Vetor \emph{magias}\\
Data frame \emph{especiais} (1 linha, número variável de colunas)\\
Data frame \emph{caracteristicas} (1 linha e 5 colunas)\\
Data frame \emph{equipamentos} (4 linhas e 4 colunas)\\
Data frame \emph{proficiencias} (3 linhas e 4 colunas)\\
Data frame \emph{info} (5 linhas e 2 colunas)

\href{http://ecor.ib.usp.br/doku.php?id=05_curso_antigo:r2018:alunos:trabalho_final:arthur.cambler:funcoes_detalhadas}{Versão mais detalhada da função}

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



\subsubsection{\texorpdfstring{Plano B: Escolha de disciplinas da pós graduação}{Plano B Escolha de disciplinas da pos graduaao}}
\label{sec:plano_b_escolha_de_disciplinas_da_pos_graduaao}


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


A busca pelas disciplinas para cursar durante o semestre no sistema \href{https://uspdigital.usp.br/janus/componente/disciplinasOferecidasInicial.jsf}{Janus} demanda a atenção para diferentes aspectos. Além do interesse pelo curso é necessário verificar diversos fatores como o número de créditos oferecidos, os dias da semana em que as disciplinas vão ocorrer, o período do dia em que as aulas serão ministradas e em qual instituto ou faculdade ocorrerão as aulas. Apesar de importante para organizar seu semestre a obtenção destes dados pode ser bastante tediosa e demorada, sendo necessário acessar cada disciplina de interesse individualmente para poder acessar estas informações. Minha função pretende evitar essa busca manual pelas informações das disciplinas, permitindo que o aluno determine parâmetros que retornem somente as disciplinas oferecidas para aquele semestre que condigam com suas necessidades. Em outras palavras, os argumentos da função permitirão escolher os parâmetros de busca e a função retornará um data frame contendo os resultados (disciplinas) compatíveis e as informações correspondentes a esses resultados.

\paragraph{\texorpdfstring{Planejamento da função}{Planejamento da funao}}
\label{sec:planejamento_da_funao2}


\textbf{Entrada:} disciplinas.ofeRecidas (\texttt{dia}, \texttt{inic}, \texttt{fim}, \texttt{cred}, \texttt{loc}, \texttt{per})\\
\texttt{dia} = dia da semana a ser escolhido (vetor composto por caracteres com 7 possibilidades)\\
\texttt{inic} = mês de início da disciplina (vetor composto por números inteiros onde 0 \textless  inic \textless  13)\\
\texttt{fim} = mês de término da disciplina (vetor composto por números inteiros onde 0 \textless  fim \textless  13)\\
\texttt{cred} = número de créditos oferecidos (vetor composto por números inteiros onde 0 \textless  cred \textless  11 )\\
\texttt{loc} = Instituto ou faculdade em que serão procuradas as disciplinas (vetor composto por caracteres)\\
\texttt{per} = Período do dia em que a disciplina será ministrada (vetor composto por caracteres com 5 possibilidades)

\textbf{Verificando os argumentos da função:}\\
Para \texttt{dia}, \texttt{loc} e \texttt{per}: é um vetor de caracteres com um único argumento? Se não, retornar: ”dia/loc/per deve conter apenas caracteres e um único elemento”\\
Para \texttt{dia}, \texttt{loc} e \texttt{per}: contém ao menos um dos argumentos permitidos? Se não, retornar: “dia/loc/per tem X possíveis argumentos, (lista dos argumentos), escolha um deles”\\
Para \texttt{inic} e \texttt{fim}: é um vetor de números inteiros com um único argumento maior do que zero e menor do que 13? Se não, retornar: “inic/fim deve conter apenas um número inteiro maior do que 0 e menor do que 13”\\
\texttt{inic} é menor do que fim? Se não, retornar: “inic precisa ser menor do que fim”\\
\texttt{cred} é um vetor de números inteiros com um único argumento maior do que zero e menor do que 11? Se não, retornar: “cred deve conter apenas um número inteiro maior do que 0 e menor do que 11”\\

\textbf{Pseudo-código:}\\
1- Criar o objeto que vai compor a saída: Data frame \emph{disciplinas}

2- Ler as informações da página “Disciplinas oferecidas” do sistema Janus a partir do URL

3- De acordo com o argumento \texttt{loc}, acessar a página do local escolhido pelo URL\\
- Acessar e guardar os dados referentes a cada disciplina do local escolhido no objeto disciplinas

4- De acordo com os argumentos de \texttt{dia}, \texttt{inic}, \texttt{fim}, \texttt{cred} e \texttt{per}, buscar em \emph{disciplinas} apenas as disciplinas compatíveis com as exigências dos argumentos\\
- Caso existam disciplinas que correspondam a todos os argumentos pedidos retornar o data frame \emph{disciplinas} com a lista das disciplinas selecionadas e as informações sobre as mesmas\\
- Caso não existam disciplinas que correspondam a todos os argumentos pedidos retornar “Infelizmente não foram encontradas disciplinas com as características desejadas”

\textbf{Saída:}\\
Data frame \emph{disciplinas} com as informações das disciplinas filtradas pela função

\href{http://ecor.ib.usp.br/doku.php?id=05_curso_antigo:r2018:alunos:trabalho_final:arthur.cambler:funcoes_detalhadas}{Versão mais detalhada da função}

Olá Arthur,
Você postou duas propostas detalhadas e com os respetivos pseudocódigos. Ambas são de uso para um amplo público, cumplem uma tarefa aplicável recorrentemente além de fornecer ao usuário varias opções de variações na tarefa.  No caso da proposta A, você propõe e descreve bem sua função que resultaria em um objeto de saída que considero ira cumprir o seu objetivo de facilitar preencher a ficha de ,,Dungeons and Dragons". De forma similar a porposta B, de escolha de disciplinas da pós graduação, explica o processo para cumprir o seu objetivo.  Considero que a proposta A é criativa e também um pouco mais desafiante do que a proposta B. Além disso, supeito que o tema de RPG será muito empolgante para você e isso pode te estimular a fazer um ótima função. Por isso sugiro continuar desenvolvendo a função da proposta A. Bom trabalho!

. --- \emph{\href{mailto:solimarygarcia@gmail.com}{SolimaryGarcia} 2018/05/10 20:40}

Olá Solimary,

Está certo, farei a proposta A. E sem dúvida, a função estar relacionada a RPG traz uma motivação extra para fazê-la! =) Obrigado pelo retorno!

. --- \emph{Arthur 2018/05/11 11:56}

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



\subsubsection{\texorpdfstring{Função finalizada}{Funao finalizada}}
\label{sec:funao_finalizada}


Link para a função finalizada: \href{http://ecor.ib.usp.br/doku.php?id=05_curso_antigo:r2018:alunos:trabalho_final:arthur.cambler:funcao_finalizada}{fichaDnD}

Link para o help da função: \href{http://ecor.ib.usp.br/doku.php?id=05_curso_antigo:r2018:alunos:trabalho_final:arthur.cambler:help}{Help}

Arquivo com a função: \href{media/bie5782/01_curso_atual/alunos/trabalho_final/arthur.cambler/fichadnd3.r}{fichaDnD}

\end{document}
