gazela.saltitante                package:unknown                R Documentation

Jogo didático da teoria da sinalização honesta

Description:

  A "gazela.saltitante" é um jogo didático que ajuda estudantes a compreenderem 
  como funciona a teoria da sinalização honesta de uma forma mais lúdica. A função 
  cria 3 personagens (2 gazelas e 1 leão), e no cenário interativo o usuário escolhe 
  qual gazela o leão irá perseguir baseado no salto de sinalização de cada uma. 
  No cenário de simulação, o jogo se repete tantas vezes quando o usuário definiu no
  argumento 'repetir' e retorna um gráfico, de forma que o estudante pode observar 
  como o modelo ocorre em uma população.

Usage:

  gazela.saltitante(simular = TRUE, repetir = 100, rodadas = 15)

Arguments:

   * simular
  Vetor lógico de valor TRUE ou FALSE. Se simular for verdadeiro, a função irá 
  repetir o jogo tantas vezes quando o usuário definiu no argumento 'repetir' e 
  retornará um gráfico. Se simular for falso, o jogo rodará uma vez e retornará 
  uma lista com um data.frame e uma frase sobre o que aconteceu com a gazela. 

    * repetir
  Vetor numérico inteiro que estabelece quantas vezes o jogo será repetido se 
  simular for verdadeiro.

    * rodadas
  Vetor numérico inteiro que estabelece quantas rodadas o jogo deve ter. 


Value:

  Se simular=TRUE retorna um gráfico com o tanto de gazelas (separadas por classe) 
  que morreram ou fugiram.
     
  Se simular=FALSE a função retorna a seguinte lista:

  * Um data.frame contendo o número do indivíduo, o vigor, a classe, o salto, as 
  rodadas jogadas e a quantidade de energia que cada personagem gastou.

  * Uma frase especificando o que aconteceu com a gazela ao fim do jogo.

 Warning:

 * Se algum dos argumentos não for inserido da forma correta, a função não irá funcionar.
  
 * Para valores altos de repetir e rodadas a função pode demorar um pouco a executar.

    
Author(s):

 Ingrid Pinheiro Paschoaletto
 e-mail: ingrid.paschoaletto@gmail.com

References:

 https://smg.media.mit.edu/library/Grafen.BioSignalsHandicaps.pdf


Examples:

## gazela.saltitante(simular = TRUE, repetir = 100, rodadas = 15)
## gazela.saltitante(simular = FALSE, repetir = 100, rodadas = 15)
## gazela.saltitante(simular = TRUE, repetir = 1000, rodadas = 15)
## gazela.saltitante(simular = FALSE, repetir = 100, rodadas = 5)