AnimatLab  2
Test
AnimatSim::Link Class Reference

Base class for all link type objects. This is typically used for synapses. More...

#include <Link.h>

+ Inheritance diagram for AnimatSim::Link:
+ Collaboration diagram for AnimatSim::Link:

Public Member Functions

 Link ()
 Default constructor. More...
 
virtual ~Link ()
 Destructor. More...
 
virtual bool Enabled ()
 Gets whether the link is enabled. More...
 
virtual void Enabled (bool bValue)
 Sets whether the link is Enabled. More...
 
virtual void QueryProperties (CStdPtrArray< TypeProperty > &aryProperties)
 Queries this object for a list of properties that can be changed using SetData. More...
 
virtual bool SetData (const std::string &strDataType, const std::string &strValue, bool bThrowError=true)
 Set a variable based on a string data type name. More...
 
virtual void SetSystemPointers (Simulator *lpSim, Structure *lpStructure, NeuralModule *lpModule, Node *lpNode, bool bVerify)
 Sets the system pointers. More...
 
virtual void VerifySystemPointers ()
 Verify that system pointers have been set correctly. More...
 
- Public Member Functions inherited from AnimatSim::AnimatBase
 AnimatBase ()
 Constructs an AnimatBase object. More...
 
virtual ~AnimatBase ()
 Destroys the AnimatBase object.. More...
 
virtual bool AddItem (const std::string &strItemType, const std::string &strXml, bool bThrowError=true, bool bDoNotInit=false)
 Adds a new object to this parent. More...
 
virtual void AfterResetSimulation ()
 Called after a simulation reset for some objects. More...
 
virtual long CalculateSnapshotByteSize ()
 Calculates the snapshot byte size. More...
 
virtual void Copy (CStdSerialize *lpSource)
 
virtual float * GetDataPointer (const std::string &strDataType)
 Returns a float pointer to a data item of interest in this object. More...
 
virtual NeuralModuleGetNeuralModule ()
 Gets the neural module. More...
 
virtual NodeGetNode ()
 Gets the node. More...
 
virtual SimulatorGetSimulator ()
 Gets the simulator pointer. More...
 
virtual StructureGetStructure ()
 Gets the structure for this node. More...
 
virtual bool HasProperty (const std::string &strName)
 Queries this object if it has a property with the given name. More...
 
virtual std::string ID ()
 Gets the unique GUID ID of this object. More...
 
virtual void ID (std::string strValue)
 Sets the unique GUID ID of the object. More...
 
virtual void Initialize ()
 Initializes this object. More...
 
virtual void Kill (bool bState=true)
 Kills. More...
 
virtual void Load (StdUtils::CStdXml &oXml)
 Loads the item using an XML data packet. More...
 
virtual void LoadKeyFrameSnapshot (byte *aryBytes, long &lIndex)
 Loads a key frame snapshot. More...
 
virtual std::string Name ()
 Gets the name of this object. More...
 
virtual void Name (std::string strValue)
 Sets the name of the object. Blank is acceptable. More...
 
virtual AnimatPropertyType PropertyType (const std::string &strName)
 
virtual void ReInitialize ()
 Re-initialize this object. More...
 
virtual bool RemoveItem (const std::string &strItemType, const std::string &strID, bool bThrowError=true)
 Removes a child item from this parent. More...
 
virtual void Reset ()
 Resets this object. More...
 
virtual void ResetSimulation ()
 Resets the simulation back to time 0. More...
 
virtual void RigidBodyAdded (std::string strID)
 
virtual void RigidBodyRemoved (std::string strID)
 
virtual void SaveKeyFrameSnapshot (byte *aryBytes, long &lIndex)
 Saves a key frame snapshot. More...
 
virtual bool Selected ()
 Tells if this items is selected or not. More...
 
virtual void Selected (bool bValue, bool bSelectMultiple)
 Selects this object. More...
 
virtual bool SetData (const std::string &strDataType, const float fltValue, bool bThrowError=true)
 Set a variable based on a string data type name. More...
 
virtual bool SetData (const std::string &strDataType, const long lValue, bool bThrowError=true)
 Set a variable based on a string data type name. More...
 
virtual void SimPausing ()
 Called just before the simulation pauses. More...
 
virtual void SimStarting ()
 Called just before the simulation starts. More...
 
virtual void SimStopping ()
 Called just before the simulation stops. More...
 
virtual void StepSimulation ()
 Step the simulation for this object. More...
 
virtual void TimeStepModified ()
 Notification method that the time step modified has been modified. Objects should recalculate any slice times as needed. More...
 
virtual std::string Type ()
 returns the string type name of this object. More...
 
virtual void Type (std::string strValue)
 Sets the class type for this object. More...
 
virtual void VisualSelectionModeChanged (int iNewMode)
 Visual selection mode changed. More...
 

Static Public Member Functions

static LinkCastToDerived (AnimatBase *lpBase)
 

Protected Member Functions

virtual void UpdateData ()
 Called during the StepSimulation method to allow the link to update any internal data for reporting purposes. More...
 

Protected Attributes

float m_fltEnabled
 This is for reporting purposes.
 
Organism * m_lpOrganism
 The pointer to this link's organism.
 
- Protected Attributes inherited from AnimatSim::AnimatBase
bool m_bEnabled
 Tells if this item is enabled or not. If it is not enabled then it is not run.
 
bool m_bSelected
 Tells whether the object is selected or not.
 
AnimatSim::Behavior::NeuralModulem_lpModule
 The pointer to this items parentNeuralModule. If this is not relevant for this object then this is NULL.
 
Nodem_lpNode
 The pointer to this items parent Node. If this is not relevant for this object then this is NULL.
 
Simulatorm_lpSim
 The pointer to a Simulation.
 
AnimatSim::Environment::Structurem_lpStructure
 The pointer to this items parent Structure. If this is not relevant for this object then this is NULL.
 
std::string m_strID
 The unique Id for this object.
 
std::string m_strName
 The name for this object.
 
std::string m_strType
 The type for this object. Examples are Box, Plane, Neuron, etc..
 

Detailed Description

Base class for all link type objects. This is typically used for synapses.

Author
dcofer
Date
3/16/2011

Definition at line 17 of file Link.h.

Constructor & Destructor Documentation

AnimatSim::Link::Link ( )

Default constructor.

Author
dcofer
Date
3/16/2011

Definition at line 51 of file Link.cpp.

References AnimatSim::AnimatBase::m_bEnabled, m_fltEnabled, and m_lpOrganism.

AnimatSim::Link::~Link ( )
virtual

Destructor.

Author
dcofer
Date
3/16/2011

Definition at line 65 of file Link.cpp.

References StdUtils::Std_TraceMsg().

+ Here is the call graph for this function:

Member Function Documentation

bool AnimatSim::Link::Enabled ( )
virtual

Gets whether the link is enabled.

Author
dcofer
Date
3/16/2011
Returns
true if enabled, false if not.

Reimplemented from AnimatSim::AnimatBase.

Definition at line 83 of file Link.cpp.

References AnimatSim::AnimatBase::m_bEnabled.

Referenced by FiringRateSim::Neurons::Neuron::CalculateSynapticCurrent(), and SetData().

+ Here is the caller graph for this function:

void AnimatSim::Link::Enabled ( bool  bValue)
virtual

Sets whether the link is Enabled.

Author
dcofer
Date
3/16/2011
Parameters
bValuetrue to enable.

Reimplemented from AnimatSim::AnimatBase.

Definition at line 93 of file Link.cpp.

References AnimatSim::AnimatBase::m_bEnabled, and m_fltEnabled.

void AnimatSim::Link::QueryProperties ( CStdPtrArray< TypeProperty > &  aryProperties)
virtual

Queries this object for a list of properties that can be changed using SetData.

The method provides a list of the properties that can be set using the SetData method. It gives the property name and the type of data that should be passed to it. Valid date types are Boolean, Float, Integer, and Xml.

Author
dcofer
Date
2/22/2011
Parameters
aryNamesArray list of the property names.
strTypesArray list of the type that is associated with the cooresponding name in the list.
Returns
Nothing.

Reimplemented from AnimatSim::AnimatBase.

Definition at line 154 of file Link.cpp.

References AnimatSim::AnimatBase::QueryProperties().

+ Here is the call graph for this function:

bool AnimatSim::Link::SetData ( const std::string &  strDataType,
const std::string &  strValue,
bool  bThrowError = true 
)
virtual

Set a variable based on a string data type name.

This is a generic method that can be used to set any variable in an AnimatBase object by specifying the name of the variable and a string representation of that data. The GUI uses this method to set data into variables in the simulation when the user changes them in the UI. The value string can be as simple as a float or int, or as complex as an xml packet. It is the developers responsibilty to know what type of data is needed and to process it accordingly.

Author
dcofer
Date
2/22/2011
Parameters
strDataTypestring name of the data type to set.
strValueThe string value of the data. It is up to the developer to determine what this should be. For example, in most cases it is simply a float and you just have to convert it to a float and make the appropriate mutator method call. However, it can be any type of string, including an entire xml packet. It is the developers responsibility to know how to set and process the data as required.
bThrowErrortrue to throw error if there is a problem. If false then it will not return an error, just return false.
Returns
true if it succeeds, false if it fails.

Reimplemented from AnimatSim::AnimatBase.

Reimplemented in AnimatCarlSim::CsSpikingCurrentSynapse, FiringRateSim::Synapses::Synapse, AnimatCarlSim::CsSynapseGroup, AnimatCarlSim::CsSynapseIndividual, FiringRateSim::Synapses::ModulateNeuronPropSynapse, FiringRateSim::Synapses::GatedSynapse, IntegrateFireSim::Synapses::Connexion, and AnimatCarlSim::CsSynapseFull.

Definition at line 134 of file Link.cpp.

References Enabled(), AnimatSim::AnimatBase::SetData(), StdUtils::Std_CheckString(), and StdUtils::Std_ToBool().

+ Here is the call graph for this function:

virtual void AnimatSim::Link::SetSystemPointers ( Simulator lpSim,
Structure *  lpStructure,
NeuralModule *  lpModule,
Node lpNode,
bool  bVerify 
)
virtual

Sets the system pointers.

There are a number of system pointers that are needed for use in the objects. The primariy one being a pointer to the simulation object itself so that you can get global parameters like the scale units and so on. However, each object may need other types of pointers as well, for example neurons need to have a pointer to their parent structure/organism, and to the NeuralModule they reside within. So different types of objects will need different sets of system pointers. We call this method to set the pointers just after creation and before Load is called. We then call VerifySystemPointers here, during Load and during Initialize in order to ensure that the correct pointers have been set for each type of objects. These pointers can then be safely used throughout the rest of the system.

Author
dcofer
Date
3/2/2011
Parameters
[in,out]lpSimThe pointer to a simulation.
[in,out]lpStructureThe pointer to the parent structure.
[in,out]lpModuleThe pointer to the parent module module.
[in,out]lpNodeThe pointer to the parent node.
bVerifytrue to call VerifySystemPointers.

Reimplemented from AnimatSim::AnimatBase.

Referenced by AnimatSim::Behavior::NeuralModule::LoadExternalSynapse().

+ Here is the caller graph for this function:

void AnimatSim::Link::UpdateData ( )
protectedvirtual

Called during the StepSimulation method to allow the link to update any internal data for reporting purposes.

Author
dcofer
Date
3/16/2011

Definition at line 105 of file Link.cpp.

void AnimatSim::Link::VerifySystemPointers ( )
virtual

Verify that system pointers have been set correctly.

The system pointers should be set just after an object is created. However, if for some reason it was not then this could cause read/write memory access errors later on because we would be using NULL pointers. This method is called during SetSystemPointers, Load, and Initialize to verify that the pointers for that type of object have been set correctly. We are calling three different places to ensure that it is checked before use. For example, if you are doing a Load call then you want to check it before attempting the load, but there may be an object that does not Load, but only does Initialize. So we need to check it there as well.

Author
dcofer
Date
3/4/2011

Reimplemented from AnimatSim::AnimatBase.

Reimplemented in FiringRateSim::Synapses::Synapse, AnimatCarlSim::CsSpikingCurrentSynapse, AnimatCarlSim::CsSynapseGroup, and IntegrateFireSim::Synapses::Connexion.

Definition at line 117 of file Link.cpp.

References AnimatSim::AnimatBase::m_lpModule, AnimatSim::AnimatBase::m_lpNode, m_lpOrganism, AnimatSim::AnimatBase::m_lpStructure, AnimatSim::AnimatBase::m_strID, and AnimatSim::AnimatBase::VerifySystemPointers().

+ Here is the call graph for this function:


The documentation for this class was generated from the following files: