cybertools/brain/interfaces.py
helmutm 4d5d9239cc added brain package, a simple experimental proof-of-concept neural network implementation
git-svn-id: svn://svn.cy55.de/Zope3/src/cybertools/trunk@1257 fd906abe-77d9-0310-91a1-e0d9ade77398
2006-07-07 18:04:30 +00:00

79 lines
2.5 KiB
Python

#
# Copyright (c) 2006 Helmut Merz helmutm@cy55.de
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
#
"""
Interfaces for a sort of neural network.
$Id$
"""
from zope.interface import Interface, Attribute
class ISynapsis(Interface):
""" A synapsis connects two neurons.
"""
sender = Attribute("The sender neuron for this synapsis")
reciever = Attribute("The receiver neuron for this synapsis")
transformation = Attribute("A transformation is used to transform "
"the sender neuron's state.")
class INeuron(Interface):
state = Attribute("The current state of the neuron")
senders = Attribute("The sender synapses")
receivers = Attribute("The receiver synapses")
stateMerger = Attribute("Merges a state with a list of other states "
"in order to create a new state.")
def trigger():
""" Notifies the neuron that something has happened. This method
should get the transformed states from all sender synapses
and merge them in order to calculate the neuron's new state;
then it should call the trigger() method on all downstream
(receiver)neurons.
In addition it may perform side effects like changing
transition properties of adjacent synapses or even create new
synapses or neurons; this side effects should happen before
triggering the receiver neurons.
"""
class IState(Interface):
""" The state of a neuron.
"""
class IStateTransformation(Interface):
def transform(state):
""" Transform state to a new state value and return it.
"""
class IStateMerger(Interface):
def merge(state, senderStates):
""" Transform state to a new value by taking into account a list
of sender neurons' states. This modifies state in-place.
"""