BlueGit

blue-star cellular-evolution

Files

cellular-evolution / src / dnastring.js

dnastring.js

dnastring.js 3.7 KiB Download Raw
1/**
2 * DNA strings contain the makeup of a creature, seriving as a template for the creature factory
3 * The DNA string must be automatically generatable so that random mutations can occur.
4 *
5 * In essence, it is a list of cell types with potential Synapses. Any 'sensor' cell can have one or more connections to 'activatable' cells such as locomotion cells or mouths.
6 *
7 * A DNA string should be able to be parsed to a simple string (hence the name), meaning the factory must be able to interpret relations from a data structure that doesn't support references.
8 *
9 * definitions:
10 * - cell: one out of many objects of uniform size that make up a creature
11 * - sensor: a cell that is able to detect things
12 * - activator: a cell that can respond to the signal of a Synapse, using energy from Stomach cells. When no energy is available, the Activators are unable to do anything and as such the creature will essentially be 'dead'
13 * - Synapse: a connection between a sensor and an activator
14 * - braincell: a cell that acts as a hybrid activator/sensor. It receives inputs like an activator would, but instead of doing something on its own, it has outbound Synapse connections of its own to one or more sensors (or other brain cells)
15 *
16 * Types of mutations that can occur:
17 * - add or remove connections between sensors and activators
18 * - add or remove cells of any type
19 * - change the strength of Synapses
20 *
21 * Types of cells:
22 * ACTIVATORS
23 * - Mouth: can Bite, which will eat whatever is in front of it, be that a cell or a food pellet
24 * - Locomotor: When activated, pushes the creature in the direction of the creature's center, relative from the locomotor cell
25 * - Rotator: Applies torque when activated. 0.5 is neural, 0 is full left, 1 is full right
26 *
27 * SENSORS
28 * - Eye: Activates whenever there is a cell or food pellet near it within a certain range and in a certain direction
29 *
30 * OTHER
31 * - Stomach: Can contain energy. Each cell/pellet eaten increases energy in any available Stomach cells. All Activators require an amount of energy from any of the available Stomach cells to function.
32 * - Meat: A cell which does nothing except connect other cells. (and potentially function as armor)
33 * - Heart: Does nothing, but when the heart is destroyed the creature will die. Creature cannot have more than one Heart, which is always at 0,0
34 *
35 * A creature will multiply when all its Stomach cells are completely full, draining each of them by 50%. This spawns an Egg which will hatch into a copy of the parent creature with a slight mutation applied as soon as there is space available (read: the parent creature has moved suffficiently far away).
36 *
37 * Examples:
38 * One cell:
39 * {
40 * ID : number. Each new cell will take the first available number so that numbers from deleted cells are re-used
41 * Type: number, corresponding to the cell type.
42 * In: [array of ID's to inbound Synapses and strength, e.g.: {ID:5,Strength:1.2},{ID:8,Strength:1.2}]
43 * Pos: {X, Y} vector, where 0,0 is the center of a creature which will ALWAYS be a Heart. (note that center of mass, as in the average position of all cells, will be used to determine direction for locomotors and such, not 0,0)
44 * }
45 *
46 * The output of a Cell is determined as follows:
47 * OUT = Sigmoid ( IN1Val*IN1Weight + IN2Val*IN2Weight + IN3Val*IN3Weight + ... )
48 * Sigmoid will accept numbers from negative infinity up until positive infinity, and as such the weights of all Synapses need not be clamped. Sigmoid will always output a value between zero and one.
49 *
50 * Note that any cells which would be disconnected from the heart should be automatically removed from the DNA string
51 */
52
53 function sigmoid(z)
54 {
55 return 1 / (1 + Math.exp(-z));
56 }