experiment

Class summary
experiment inherits from blackboard and configuration
interaction inherits from blackboard
Method summary
agents experiment
communicated-successfully interaction
current-interaction thing &key
determine-interacting-agents experiment interaction mode &key
experiment interaction
hearer object &key &allow-other-keys
id experiment
interact experiment interaction &key
interacting-agents thing
interacting-agents interaction
interaction-number interaction
interactions experiment
owner interaction
population experiment
print-object (experiment experiment) stream
run-batch experiment number-of-interactions number-of-series &key &allow-other-keys
run-interaction experiment &key
run-series experiment number-of-interactions &key &allow-other-keys
series-number experiment
speaker object &key &allow-other-keys
world experiment
Function summary
run-batch-for-different-configurations &key experiment-class number-of-interactions number-of-series monitors shared-configuration configurations (output-dir (error "Please supply an :output-dir for monitoring"))
experiment   inherits from blackboard and configuration  [Class]

class for experiments

id    [Initarg]
:agents :population    [Initarg]
:series-number    [Initarg]
:world    [Initarg]
:interactions    [Initarg]
id    [Slot]

id of the experiment

agents    [Slot]

A list of agents to be used in the experiment.

series-number    [Slot]

The series counter.

interactions    [Slot]

a list of interactions

interactions   experiment  [Generic function]

Returns and (with setf) changes the interactions of the specified experiment

world   experiment  [Generic function]

Returns and (with setf) changes the world of the specified experiment

series-number   experiment  [Generic function]

Returns and (with setf) changes the series-number of the specified experiment

agents   experiment  [Generic function]

Returns and (with setf) changes the agents of the specified experiment

population   experiment  [Generic function]

Returns and (with setf) changes the agents of the specified experiment

id   experiment  [Generic function]

Returns and (with setf) changes the id of the specified experiment

interaction   inherits from blackboard  [Class]
:experiment    [Initarg]
:interaction-number    [Initarg]
:interacting-agents    [Initarg]
interaction-number    [Slot]

A interaction counter that is increased with every interaction

interacting-agents    [Slot]

The agents that are involved in the current interaction

communicated-successfully    [Slot]

Whether the interaction was a success.

communicated-successfully   interaction  [Generic function]

Returns and (with setf) changes the communicated-successfully of the specified interaction

interacting-agents   interaction  [Generic function]

Returns and (with setf) changes the interacting-agents of the specified interaction

interaction-number   interaction  [Generic function]

Returns and (with setf) changes the interaction-number of the specified interaction

experiment   interaction  [Generic function]

Returns and (with setf) changes the experiment of the specified interaction

owner   interaction  [Generic function]

Returns and (with setf) changes the experiment of the specified interaction

current-interaction   thing &key  [Generic function]
interacting-agents   thing  [Generic function]
determine-interacting-agents   experiment interaction mode &key  [Generic function]

Determines which agents are part of the next interaction.

speaker   object &key &allow-other-keys  [Generic function]

Gets the speaker, probably from an experiment

hearer   object &key &allow-other-keys  [Generic function]

Gets the hearer, probably from an experiment

interact   experiment interaction &key  [Generic function]

method called by run-interaction - has to be overloaded

run-interaction   experiment &key  [Generic function]
run-series   experiment number-of-interactions &key &allow-other-keys  [Generic function]

runs a series of interactions

run-batch   experiment number-of-interactions number-of-series &key &allow-other-keys  [Generic function]

runs a batch (multiple series of interactions)

print-object   (experiment experiment) stream  [Method]
run-batch-for-different-configurations   &key experiment-class number-of-interactions number-of-series monitors shared-configuration configurations (output-dir (error "Please supply an :output-dir for monitoring"))  [Function]

Runs multiple batches of series. Every batch takes a different (named) configuration. Each configuration in configurations should be a pair like (name . configuration-list). You can use shared-configuration to set configuration values that are shared among all batches. Values in configurations have precedence over values in shared-configration, should there be a conflict. output-dir can be set to the directory of (or subdir in) your experiment. If it is set then all data-outputting monitors will be overridden to output there. For each named configuration a subdir will be made there with the given name.