CRITTERDING(1)						    critterding Debian manpage						    CRITTERDING(1)

NAME

       crittering - Evolving Artificial Life

SYNOPSIS

       critterding [OPTION]...

DESCRIPTION

       This manual page was written for the Debian distribution because critterding does not have a manual page. It provides information taken
       from "critterding --help" output and project homepage.

       Critterding is a "Petri dish" universe in 3D that demonstrates evolving artificial life. Critters start out with completely random brains
       and bodies, but will automatically start evolving into something with much better survival skills.

       Critters are informed by sensors:

       - if their head touches food unit.
       - their head touches another critter
       - if they are able to procreate
       - about their energy state
       - about their age
       - about the state of their joints
       - what the world looks like (RGBA vision)

       Critters can make use of the following motor neurons (actions):

       - bend joint
       - bend joint in other direction
       - eat
       - procreate

       At default, the program sets up a small world with a relatively large amount of food units and keeps throwing in critters with randomly
       generated brains and bodies.

       After a while, one of these idiot critters will unavoidably be good enough to maintain a small population:

       Slowly but surely, their behaviour will become a lot less random as they demonstrate increasingly better survival skills.

KEYS

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

       Use F1 in the simulation for more information about keys.

OPTIONS

       --autoload num
	    autoload critters from ~/.critterding/load
	    (default: 0, range: 0-1)

       --autoloadlastsaved num
	    autoload critters from ~/.critterding/lastsaved
	    (default: 0, range: 0-1)

       --benchmark num
	    run the critterding benchmark
	    (default: 0, range: 0-1)

       --body_maxbodyparts num
	    maximum body parts per critter
	    (default: 30, range: 0-1000000)

       --body_maxbodypartsatbuildtime num
	    maximum body parts for a new critter
	    (default: 6, range: 1-1000000)

       --body_maxbodypartsize num
	    maximum size of a critters body part
	    (default: 200, range: 1-1000000)

       --body_maxheadsize num
	    maximum size of a critters head
	    (default: 80, range: 1-1000000)

       --body_maxmutations num
	    maximum mutations on a body mutant
	    (default: 3, range: 1-1000000)

       --body_minbodypartsize num
	    minimum size of a critters body part
	    (default: 20, range: 1-1000000)

       --body_minheadsize num
	    minimum size of a critters head
	    (default: 30, range: 1-1000000)

       --body_mutationrate num
	    percentage of newborns that mutate bodies
	    (default: 10, range: 0-100)

       --body_percentmutateeffectaddbodypart num
	    chance of adding a body part
	    (default: 1, range: 0-100)

       --body_percentmutateeffectchangecolor num
	    chance of changing body color
	    (default: 1, range: 0-100)

       --body_percentmutateeffectchangecolor_slightly num
	    chance of changing body color
	    (default: 5, range: 0-100)

       --body_percentmutateeffectchangeconstraintangles num
	    chance of changing a joints position angles
	    (default: 1, range: 0-100)

       --body_percentmutateeffectchangeconstraintangles_slightly num
	    chance of changing a joints position angles
	    (default: 5, range: 0-100)

       --body_percentmutateeffectchangeconstraintlimits num
	    chance of changing a joints motion limits
	    (default: 1, range: 0-100)

       --body_percentmutateeffectchangeconstraintlimits_slightly num
	    chance of slightly changing a joints motion limits
	    (default: 5, range: 0-100)

       --body_percentmutateeffectchangeconstraintposition num
	    chance of changing a joints position
	    (default: 1, range: 0-100)

       --body_percentmutateeffectchangeconstraintposition_slightly num
	    chance of slightly changing a joints position
	    (default: 5, range: 0-100)

       --body_percentmutateeffectremovebodypart num
	    chance of removing a body part
	    (default: 1, range: 0-100)

       --body_percentmutateeffectrepositionhead num
	    chance of repositioning head
	    (default: 5, range: 0-100)

       --body_percentmutateeffectresizebodypart num
	    chance of resizing a body part
	    (default: 1, range: 0-100)

       --body_percentmutateeffectresizebodypart_slightly num
	    chance of slightly resizing a body part
	    (default: 5, range: 0-100)

       --body_percentmutateeffectresizehead num
	    chance of resizing a head
	    (default: 1, range: 0-100)

       --body_percentmutateeffectresizehead_slightly num
	    chance of slightly resizing a head
	    (default: 5, range: 0-100)

       --brain_costfiringmotorneuron num
	    cost of firing a motor neuron
	    (default: 100, range: 0-1000000)

       --brain_costfiringneuron num
	    cost of firing a neuron
	    (default: 10, range: 0-1000000)

       --brain_costhavingneuron num
	    cost of having a neuron (1/100000 energy)
	    (default: 50, range: 0-1000000)

       --brain_costhavingsynapse num
	    cost of having a synapse
	    (default: 1, range: 0-1000000)

       --brain_maxdendridicbranches num
	    maximum number of dendrites per neuron
	    (default: 3, range: 1-1000000)

       --brain_maxfiringthreshold num
	    maximum firingthreshold of a neuron
	    (default: 10, range: 1-1000000)

       --brain_maxmutations num
	    maximum mutations on a brain mutant
	    (default: 10, range: 1-1000000)

       --brain_maxneurons num
	    maximum neurons per critter
	    (default: 1000, range: 1-1000000)

       --brain_maxneuronsatbuildtime num
	    maximum neurons for a new critter
	    (default: 200, range: 1-1000000)

       --brain_maxplasticitystrengthen num
	    maximum weight by which plastic synapses strengthen
	    (default: 1000, range: 1-1000000)

       --brain_maxplasticityweaken num
	    maximum weight by which plastic synapses weaken
	    (default: 10000, range: 1-1000000)

       --brain_maxsynapses num
	    maximum synapses per neuron
	    (default: 100, range: 1-1000000)

       --brain_maxsynapsesatbuildtime num
	    maximum synapses for a new neuron of a new critter
	    (default: 40, range: 1-1000000)

       --brain_minfiringthreshold num
	    minimum firingthreshold of a neuron
	    (default: 2, range: 1-1000000)

       --brain_minneuronsatbuildtime num
	    minimum neurons for a new critter
	    (default: 50, range: 1-1000000)

       --brain_minplasticitystrengthen num
	    minimum weight by which plastic synapses strengthen
	    (default: 100, range: 1-1000000)

       --brain_minplasticityweaken num
	    minimum weight by which plastic synapses weaken
	    (default: 1000, range: 1-1000000)

       --brain_minsynapses num
	    minimum synapses per neuron
	    (default: 1, range: 1-1000000)

       --brain_minsynapsesatbuildtime num
	    minimum synapses for a new neuron
	    (default: 1, range: 1-1000000)

       --brain_mutate_maxdendridicbranches num
	    mutate this value
	    (default: 0, range: 0-1)

       --brain_mutate_maxfiringthreshold num
	    mutate this value
	    (default: 0, range: 0-1)

       --brain_mutate_minfiringthreshold num
	    mutate this value
	    (default: 0, range: 0-1)

       --brain_mutate_mutateeffects num
	    mutate mutation effects
	    (default: 0, range: 0-1)

       --brain_mutate_percentchanceconsistentsynapses num
	    mutate this value
	    (default: 0, range: 0-1)

       --brain_mutate_percentchanceinhibitoryneuron num
	    mutate this value
	    (default: 0, range: 0-1)

       --brain_mutate_percentchanceinhibitorysynapses num
	    mutate this value
	    (default: 0, range: 0-1)

       --brain_mutate_percentchancemotorneuron num
	    mutate this value
	    (default: 0, range: 0-1)

       --brain_mutate_percentchanceplasticneuron num
	    mutate this value
	    (default: 0, range: 0-1)

       --brain_mutate_percentchancesensorysynapse num
	    mutate this value
	    (default: 0, range: 0-1)

       --brain_mutate_plasticityfactors num
	    mutate min/max plasticity values
	    (default: 0, range: 0-1)

       --brain_mutationrate num
	    percentage of newborns that mutate brains
	    (default: 10, range: 0-100)

       --brain_percentchanceconsistentsynapses num
	    percent chance a neurons synapses are all inhibitory or excitatory
	    (default: 0, range: 0-100)

       --brain_percentchanceinhibitoryneuron num
	    percent chance a neuron is inhibotory
	    (default: 50, range: 0-100)

       --brain_percentchanceinhibitorysynapses num
	    percent chance a synapse is inhibitory
	    (default: 50, range: 0-100)

       --brain_percentchancemotorneuron num
	    percent chance a neuron is a motor neuron
	    (default: 50, range: 0-100)

       --brain_percentchanceplasticneuron num
	    percent chance a neuron has plastic synapses
	    (default: 20, range: 0-100)

       --brain_percentchancesensorysynapse num
	    percent change a synapse connects to an input
	    (default: 20, range: 0-100)

       --brain_percentmutateeffectaddneuron num
	    chance of adding a neuron
	    (default: 1, range: 0-100)

       --brain_percentmutateeffectaddsynapse num
	    chance of adding a synapse
	    (default: 5, range: 0-100)

       --brain_percentmutateeffectaltermutable num
	    mutate value of a mutatable option
	    (default: 1, range: 0-100)

       --brain_percentmutateeffectalterneuron num
	    chance of altering a neuron
	    (default: 2, range: 0-100)

       --brain_percentmutateeffectremoveneuron num
	    chance of removing a neuron
	    (default: 1, range: 0-100)

       --brain_percentmutateeffectremovesynapse num
	    chance of removing a synapse
	    (default: 5, range: 0-100)

       --camerasensitivity num
	    sensitivity of the camera
	    (default: 20, range: 1-1000)

       --colormode num
	    colors genetically exact critters identically
	    (default: 0, range: 0-1)

       --critter_autoexchangeinterval num
	    save critters every n seconds
	    (default: 0, range: 0-1000000)

       --critter_autosaveinterval num
	    save critters every n seconds
	    (default: 0, range: 0-1000000)

       --critter_enableomnivores num
	    enables critters to eat each other
	    (default: 1, range: 0-1)

       --critter_insertevery num
	    inserts a random critter every n frames
	    (default: 0, range: 0-1000000)

       --critter_killhalfat num
	    kill 50% of critters if population reaches n
	    (default: 120, range: 2-1000000)

       --critter_maxenergy num
	    maximum amount of energy a critter has
	    (default: 5000, range: 1-1000000)

       --critter_maxlifetime num
	    maximum number of frames a critter lives
	    (default: 40000, range: 1-1000000)

       --critter_minenergyproc num
	    energy a critters needs to procreate
	    (default: 3000, range: 1-1000000)

       --critter_procinterval num
	    minimum frames between procreations
	    (default: 20, range: 1-1000000)

       --critter_raycastvision num
	    use raycast vision instead of opengl
	    (default: 0, range: 0-1)

       --critter_retinasize num
	    size of a critters eye retina
	    (default: 8, range: 1-1000)

       --critter_sightrange num
	    distance a critter can see (10 = 1 worldsize)
	    (default: 70, range: 1-1000000)

       --critter_startenergy num
	    energy a new critter (adam) starts with
	    (default: 3000, range: 1-1000000)

       --drawscene num
	    draw the scene
	    (default: 1, range: 0-1)

       --energy num
	    energy in the system by number of food cubes
	    (default: 400, range: 0-1000000)

       --exit_if_empty num
	    exit simulation if there are no critters
	    (default: 0, range: 0-1)

       --food_maxenergy num
	    maximum amount of energy a food unit has
	    (default: 1500, range: 1-1000000)

       --food_maxlifetime num
	    maximum number of frames a food unit exists
	    (default: 40000, range: 1-1000000)

       --food_size num
	    size of a food unit
	    (default: 200, range: 1-1000000)

       --fpslimit num
	    frames per second for the fps limiter
	    (default: 30, range: 1-1000)

       --fsX num
	    fullscreen resolution X
	    (default: 800, range: 1-1000000)

       --fsY num
	    fullscreen resolution Y
	    (default: 600, range: 1-1000000)

       --fullscreen num
	    enable fullscreen mode
	    (default: 0, range: 0-1)

       --headless num
	    do not open gl context
	    (default: 0, range: 0-1)

       --killhalf_decrenergypct num
	    decrease energy by n percent when killhalfat triggers
	    (default: 1, range: 0-100)

       --killhalf_decrmaxlifetimepct num
	    decrease critter_maxlifetime by n when killhalfat triggers
	    (default: 0, range: 0-100)

       --killhalf_incrworldsizeX num
	    increase worldsizeX by n when killhalfat triggers
	    (default: 0, range: 0-100)

       --killhalf_incrworldsizeY num
	    increase worldsizeY by n when killhalfat triggers
	    (default: 0, range: 0-100)

       --mincritters num
	    minimum number of critters
	    (default: 10, range: 0-1000)

       --race num
	    enable race simulation
	    (default: 0, range: 0-1)

       --retinasperrow num
	    number of vision retinas to stack per row onscreen
	    (default: 20, range: 1-1000)

       --roundworld num
	    enable round planet
	    (default: 0, range: 0-1)

       --startseed num
	    enable fullscreen mode
	    (default: 0, range: 0-4000000000)

       --testworld num
	    a world for test purposes
	    (default: 0, range: 0-1)

       --threads num
	    threads to use
	    (default: 1, range: 1-16)

       --worldsizeX num
	    size of the world along axis X
	    (default: 23, range: 1-5000)

       --worldsizeY num
	    size of the world along axis Y
	    (default: 13, range: 1-5000)

       --worldwalls num
	    enable walls around the world
	    (default: 1, range: 0-1)

SEE ALSO

	http://critterding.sourceforge.net/

1.0								    2010-03-17							    CRITTERDING(1)