[This is preliminary documentation and is subject to change.]

Initializes a new sensory information object for the specified agent and sets up the generated sensory information object to match the configuration of the specified sensory information object.

Namespace: Clarion
Assembly: ClarionLibrary (in ClarionLibrary.dll) Version: 6.1.1.0 (6.1.1.0)

Syntax

C#
public static SensoryInformation NewSensoryInformation(
	Agent agent,
	SensoryInformation si,
	World..::..SensoryInformationIncrementOptions siOption
)

Parameters

agent
Type: Clarion.Framework..::..Agent
The agent for whom the sensory information is intended
si
Type: Clarion.Framework..::..SensoryInformation
siOption
Type: Clarion..::..World..::..SensoryInformationIncrementOptions

Return Value

The sensory information object for the specified agent generated by this method

Remarks

This method overload has been provided in order to simplify the process of initialing sensory information. For example, suppose you want multiple agents to all perceive the same sensory information configuration. Using this method, you can initialize sensory information objects for all of your agents using a single sensory information object (configured for the first agent).
Note
The sensory information object generated by this method can only be "perceived" by the agent specified. The reason for this is because the sensory information object that is returned can contain both external as well as internal, agent specific, sensory information. In fact, during the initialization process, this method will actually pre-populate the sensory information object with the agent's internal information. This includes the following:
  • The inputs for the drives in the MS
  • The goals in the goal structure
  • The contents of working memory
  • Agent-specific dimension-value pairs
Caution
The sensory information object returned by this method will NOT copy the agent internal meta information that is part of the specified sensory information object

See Also