COMPILING
 - Compiling instructions can be found in the INSTALL file

USAGE
	start an ecosim
	> ./src/critterding

	start a race
	> ./src/critterding --profile profiles/race

TERMINOLOGY

 - Adam
      : new (random) critter

 - Adam Distance (ad)
      : generations with mutations since adam

OPTIONS

  option                                                    [default] [range]      [comment]

  --autoload                                                  0         0-1          autoload critters from ~/.critterding/load
  --autoloadlastsaved                                         0         0-1          autoload critters from ~/.critterding/lastsaved
  --benchmark                                                 0         0-1          run the critterding benchmark
  --benchmark_frames                                          1000      1-2147483647 length of benchmark in frames
  --body_costhavingbodypart                                   10        0-2147483647 cost of having a bodypart (1/100000 energy)
  --body_costtotalweight                                      10        0-2147483647 cost multiplier of total body weight (1/100000 energy)
  --body_maxbodyparts                                         30        0-2147483647 maximum body parts per critter
  --body_maxbodypartsatbuildtime                              8         1-2147483647 maximum body parts for a new critter
  --body_maxbodypartsize                                      100       1-2147483647 maximum size of a critters body part
  --body_maxconstraintangle                                   31416     0-2147483647 maximum amount of rotation on a contraint
  --body_maxconstraintlimit                                   7853      0-2147483647 maximum limit of a contraint
  --body_maxheadsize                                          50        1-2147483647 maximum size of a critters head
  --body_maxmutations                                         10        1-2147483647 maximum mutations on a body mutant
  --body_minbodyparts                                         2         0-2147483647 minimum body parts per critter
  --body_minbodypartsatbuildtime                              4         1-2147483647 minimum body parts for a new critter
  --body_minbodypartsize                                      10        1-2147483647 minimum size of a critters body part
  --body_minheadsize                                          5         1-2147483647 minimum size of a critters head
  --body_mutationrate                                         100       0-1000       rate of body mutation (permille)
  --body_percentmutateeffectaddbodypart                       2         0-100        chance of adding a body part
  --body_percentmutateeffectchangecolor                       2         0-100        chance of changing body color
  --body_percentmutateeffectchangecolor_slightly              5         0-100        chance of changing body color
  --body_percentmutateeffectchangeconstraintangles            2         0-100        chance of changing a joints position angles
  --body_percentmutateeffectchangeconstraintangles_slightly   5         0-100        chance of changing a joints position angles
  --body_percentmutateeffectchangeconstraintlimits            2         0-100        chance of changing a joints motion limits
  --body_percentmutateeffectchangeconstraintlimits_slightly   5         0-100        chance of slightly changing a joints motion limits
  --body_percentmutateeffectchangeconstraintposition          2         0-100        chance of changing a joints position
  --body_percentmutateeffectchangeconstraintposition_slightly 0         0-100        chance of slightly changing a joints position
  --body_percentmutateeffectremovebodypart                    2         0-100        chance of removing a body part
  --body_percentmutateeffectrepositionhead                    5         0-100        chance of repositioning head
  --body_percentmutateeffectresizebodypart                    2         0-100        chance of resizing a body part
  --body_percentmutateeffectresizebodypart_slightly           5         0-100        chance of slightly resizing a body part
  --body_percentmutateeffectresizehead                        2         0-100        chance of resizing a head
  --body_percentmutateeffectresizehead_slightly               5         0-100        chance of slightly resizing a head
  --body_selfcollisions                                       0         0-1          critters can exploit physics glitches
  --brain_costfiringmotorneuron                               300       0-2147483647 cost of firing a motor neuron
  --brain_costfiringneuron                                    2         0-2147483647 cost of firing a neuron
  --brain_costhavingneuron                                    8         0-2147483647 cost of having a neuron (1/100000 energy)
  --brain_costhavingsynapse                                   1         0-2147483647 cost of having a synapse
  --brain_maxfiringthreshold                                  12        1-2147483647 maximum firingthreshold of a neuron
  --brain_maxmutations                                        20        1-2147483647 maximum mutations on a brain mutant
  --brain_maxneurons                                          1000      1-2147483647 maximum neurons per critter
  --brain_maxneuronsatbuildtime                               300       1-2147483647 maximum neurons for a new critter
  --brain_maxplasticitystrengthen                             1000      1-2147483647 maximum weight by which plastic synapses strengthen
  --brain_maxplasticityweaken                                 10000     1-2147483647 maximum weight by which plastic synapses weaken
  --brain_maxsynapses                                         1000      1-2147483647 maximum synapses per neuron
  --brain_maxsynapsesatbuildtime                              200       1-2147483647 maximum synapses for a new neuron of a new critter
  --brain_minfiringthreshold                                  2         1-2147483647 minimum firingthreshold of a neuron
  --brain_minneuronsatbuildtime                               10        1-2147483647 minimum neurons for a new critter
  --brain_minplasticitystrengthen                             100       1-2147483647 minimum weight by which plastic synapses strengthen
  --brain_minplasticityweaken                                 1000      1-2147483647 minimum weight by which plastic synapses weaken
  --brain_minsynapses                                         1         1-2147483647 minimum synapses per neuron
  --brain_minsynapsesatbuildtime                              10        1-2147483647 minimum synapses for a new neuron
  --brain_mutate_maxfiringthreshold                           0         0-1          mutate this value
  --brain_mutate_minfiringthreshold                           0         0-1          mutate this value
  --brain_mutate_mutateeffects                                0         0-1          mutate mutation effects
  --brain_mutate_percentchanceconsistentsynapses              0         0-1          mutate this value
  --brain_mutate_percentchanceinhibitoryneuron                0         0-1          mutate this value
  --brain_mutate_percentchanceinhibitorysynapses              0         0-1          mutate this value
  --brain_mutate_percentchancemotorneuron                     0         0-1          mutate this value
  --brain_mutate_percentchanceplasticneuron                   0         0-1          mutate this value
  --brain_mutate_percentchancesensorysynapse                  0         0-1          mutate this value
  --brain_mutate_plasticityfactors                            0         0-1          mutate min/max plasticity values
  --brain_mutationrate                                        120       0-1000       rate of brain mutation (permille)
  --brain_percentchanceconsistentsynapses                     0         0-100        percent chance a neurons synapses are all inhibitory or excitatory
  --brain_percentchanceinhibitoryneuron                       50        0-100        percent chance a neuron is inhibotory
  --brain_percentchanceinhibitorysynapses                     50        0-100        percent chance a synapse is inhibitory
  --brain_percentchancemotorneuron                            100       0-100        percent chance a neuron is a motor neuron
  --brain_percentchanceplasticneuron                          20        0-100        percent chance a neuron has plastic synapses
  --brain_percentchancesensorysynapse                         20        0-100        percent change a synapse connects to an input
  --brain_percentmutateeffectaddneuron                        1         0-100        chance of adding a neuron
  --brain_percentmutateeffectaddsynapse                       5         0-100        chance of adding a synapse
  --brain_percentmutateeffectaltermutable                     1         0-100        mutate value of a mutatable option
  --brain_percentmutateeffectalterneuron                      2         0-100        chance of altering a neuron
  --brain_percentmutateeffectremoveneuron                     1         0-100        chance of removing a neuron
  --brain_percentmutateeffectremovesynapse                    5         0-100        chance of removing a synapse
  --camerasensitivity_look                                    20        1-1000       sensitivity of the camera when looking around
  --camerasensitivity_move                                    20        1-1000       sensitivity of the camera when moving
  --colormode                                                 0         0-1          colors genetically exact critters identically
  --critter_autoexchangeinterval                              0         0-2147483647 save critters every n seconds
  --critter_autosaveinterval                                  0         0-2147483647 save critters every n seconds
  --critter_enableomnivores                                   0         0-1          enables critters to eat each other
  --critter_insertevery                                       0         0-2147483647 inserts a random critter every n frames
  --critter_maxenergy                                         5000      1-2147483647 maximum amount of energy a critter has
  --critter_maxlifetime                                       32000     1-2147483647 maximum number of frames a critter lives
  --critter_minenergyproc                                     3000      1-2147483647 energy a critters needs to procreate
  --critter_procinterval                                      500       1-2147483647 minimum frames between procreations
  --critter_raycastvision                                     0         0-1          use raycast vision instead of opengl
  --critter_retinasize                                        16        1-1000       size of a critters eye retina
  --critter_sightrange                                        100       1-2147483647 distance a critter can see (10 = 1 worldsize)
  --critter_startenergy                                       3000      1-2147483647 energy a new critter (adam) starts with
  --drawscene                                                 1         0-1          draw the scene
  --energy                                                    1000      0-2147483647 energy in the system by number of food cubes
  --exit_if_empty                                             0         0-1          exit simulation if there are no critters
  --food_maxenergy                                            1500      1-2147483647 maximum amount of energy a food unit has
  --food_maxlifetime                                          32000     1-2147483647 maximum number of frames a food unit exists
  --food_size                                                 100       1-2147483647 size of a food unit
  --fpslimit                                                  0         0-1          enable fps limiter
  --fpslimit_frames                                           60        1-1000       frames per second for the fps limiter
  --fsX                                                       1920      1-2147483647 fullscreen resolution X
  --fsY                                                       1200      1-2147483647 fullscreen resolution Y
  --headless                                                  0         0-1          do not open gl context
  --mincritters                                               20        0-1000       minimum number of critters
  --population_double                                         0         0-2147483647 duplicate all critters if population reaches n
  --population_eliminate_portion                              180       2-2147483647 eliminate a percentage of critters if population reaches n
  --population_eliminate_portion_bodymutationratechange       0         0-1          change mutationrate of brain between min and max
  --population_eliminate_portion_bodymutationratemax          0         0-100        maximum mutationrate of brain
  --population_eliminate_portion_bodymutationratemin          0         0-100        minimum mutationrate of brain
  --population_eliminate_portion_brainmutationratechange      0         0-1          change mutationrate of brain between min and max
  --population_eliminate_portion_brainmutationratemax         0         0-100        maximum mutationrate of body
  --population_eliminate_portion_brainmutationratemin         0         0-100        minimum mutationrate of body
  --population_eliminate_portion_decrenergy                   5         0-100        decrease energy by n when killhalfat triggers
  --population_eliminate_portion_decrmaxlifetimepct           0         0-100        decrease critter_maxlifetime by n when killhalfat triggers
  --population_eliminate_portion_incrworldsizeX               0         0-100        increase worldsizeX by n when killhalfat triggers
  --population_eliminate_portion_incrworldsizeY               0         0-100        increase worldsizeY by n when killhalfat triggers
  --population_eliminate_portion_percent                      50        1-100        eliminate n% of critters if population reaches population_eliminate_portion
  --population_limit_energy                                   120       0-2147483647 population limit
  --population_limit_energy_percent                           50        0-100        if population limit is exceeded drop energy to percentage
  --race                                                      0         0-1          enable race simulation
  --roundworld                                                0         0-1          enable round planet
  --startseed                                                 0         0-2147483647 startseed for random number generation
  --threads                                                   1         1-2147483647 threads to use
  --window_color_bits                                         24        16-32        window framebuffer color bits per pixel
  --window_depth_bits                                         24        8-32         window framebuffer depth bits per pixel
  --window_doublebuffer                                       1         0-1          double buffered window
  --window_fullscreen                                         0         0-1          enable fullscreen window
  --window_hardware_gl                                        1         0-1          enable hardware GL window
  --window_height                                             600       1-2147483647 window client height in pixels
  --window_multisamples                                       0         0-16         window framebuffer multisamples
  --window_resizable                                          1         0-1          enable resizable window
  --window_stencil_bits                                       0         0-32         window framebuffer stencil bits per pixel
  --window_vsync                                              0         0-1          vsynced window
  --window_width                                              900       1-2147483647 window client width in pixels
  --worldsizeX                                                250       1-2147483647 size of the world along axis X
  --worldsizeY                                                140       1-2147483647 size of the world along axis Y
  --worldwalls                                                1         0-1          enable walls around the world


 To save the default settings to a profile, press "s" in the simulation.
 It will be saved to ./profiles/(timestamp).pro and can be loaded by using "--profile profiles/(timestamp).pro"

 Use F1 in the simulation for more information about keys.



Bob Winckelmans <bob.winckelmans@telenet.be>
IRC: #critterding@irc.freenode.org