def __init__(self, automataFactory, food, artifacts, frame): self.automata = [] # Public self.food = food self.artifacts = artifacts self.frame = frame # Private self.automataFactory = automataFactory self.stagnator = Stagnator()
class Field(object):
'''
A container and environ for automata.
Resources: food and artifacts
'''
def __init__(self, automataFactory, food, artifacts, frame):
self.automata = []
# Public
self.food = food
self.artifacts = artifacts
self.frame = frame
# Private
self.automataFactory = automataFactory
self.stagnator = Stagnator()
def append(self, automata):
self.automata.append(automata)
#print("append Automata ", len(self.automata) )
def kill(self, automata):
''' Remove automata from field. '''
assert automata in self.automata
self.automata.remove(automata)
def automataGenerator(self):
'''
Generate (in Python sense, not in family generation sense)
!!! Since we are concurrently mutating (adding to) list, generate from copy.
In Python, undefined behaviour to iterate over a mutating list.
'''
automataCopy = self.automata[:]
for automata in automataCopy:
yield automata
'''
Population limit implies little about density: all automata could be crowded together.
'''
def isOverPopulated(self):
return len(self.automata) >= config.maxPopulation
def isTerminal(self):
'''
Generic: is conditions to end simulation?
Specific: is most of the food gone. (Not explicitly depend on population.)
Many other formulations are possible.
The formulation: 'is every automata starved' didn't work well, ended simulation with much food remaining.
!!! User has enough control to create conditions where simulation stagnates (in terms of food being eaten.)
Terminate simulation in that case.
'''
return self.food.isMostlyGone() or self.stagnator.isStagnant(newValue=self.food.eatenAmount())
def perunitDone(self):
''' Float in range [0, 1.0] of completeness (not of image consumed, but of amount user wants to consume.) '''
return self.food.perunitDone()
def populate(self):
'''
Dispatch populate on setting.
'''
if config.startPattern == 0:
self.populateCenter()
else:
self.populateUniformly()
def populateCenter(self):
'''
Populate one set of automata in center.
If the center has no food the simulation will stop immediately?
Depending on other parameters, automata may divide and spread quickly,
leaving little evidence that we started in center.
'''
# Create one automata for each channel (factory switches to next channel on each call.)
for _ in range(0, self.food.pixmap.bpp):
automata = self.automataFactory.produce(position=self.frame.center(), field=self)
self.append(automata)
def populateUniformly(self):
'''
Spread populus uniformly randomly over the field.
'''
# ??? if user does not touch population, is a float? So cast it to int.
assert config.maxPopulation > 0
for _ in range(0, int(config.maxPopulation)):
automata = self.automataFactory.produce(position=self.randomCoordOn(), field=self)
self.append(automata)
def randomCoordOn(self):
'''
Coord chosen uniformly randomly that is on the field (not clipped.)
'''
x = random.randint(0, self.frame.width)
y = random.randint(0, self.frame.height)
coord = Coord(x, y)
return coord
