Auryn simulator  v0.8.1-206-gb56e451
Plastic Spiking Neural Network Simulator
Public Member Functions | List of all members
auryn::TIFGroup Class Reference

Conductance based LIF neuron model with absolute refractoriness as used in Vogels and Abbott 2005. More...

#include <TIFGroup.h>

Inheritance diagram for auryn::TIFGroup:
Inheritance graph
[legend]
Collaboration diagram for auryn::TIFGroup:
Collaboration graph
[legend]

Public Member Functions

 TIFGroup (NeuronID size)
 The default constructor of this NeuronGroup. More...
 
virtual ~TIFGroup ()
 
void set_bg_current (NeuronID i, AurynFloat current)
 Controls the constant current input (per default set so zero) to neuron i. More...
 
void set_bg_currents (AurynFloat current)
 Controls the constant current input to all neurons. More...
 
void set_refractory_period (AurynDouble t)
 Setter for refractory time [s]. More...
 
AurynFloat get_bg_current (NeuronID i)
 Gets the current background current value for neuron i. More...
 
void set_tau_mem (AurynFloat taum)
 Sets the membrane time constant (default 20ms) More...
 
void set_r_mem (AurynFloat rm)
 Sets the membrane resistance (default 100 M-ohm) More...
 
void set_c_mem (AurynFloat cm)
 Sets the membrane capacitance (default 200pF) More...
 
void set_tau_ampa (AurynFloat tau)
 Sets the exponential time constant for the AMPA channel (default 5ms) More...
 
AurynFloat get_tau_ampa ()
 Gets the exponential time constant for the AMPA channel. More...
 
void set_tau_gaba (AurynFloat tau)
 Sets the exponential time constant for the GABA channel (default 10ms) More...
 
AurynFloat get_tau_gaba ()
 Gets the exponential time constant for the GABA channel. More...
 
void clear ()
 Resets all neurons to defined and identical initial state. More...
 
void evolve ()
 Integrates the NeuronGroup state. More...
 
- Public Member Functions inherited from auryn::NeuronGroup
 NeuronGroup (NeuronID n, NodeDistributionMode mode=AUTO)
 Default constructor. More...
 
 NeuronGroup (NeuronID n, double loadmultiplier, NeuronID total)
 Old default constructor. More...
 
virtual ~NeuronGroup ()
 
void set_state (std::string name, AurynState val)
 Conveniently sets all values in a state vector identified by name in this group. More...
 
void set_state (std::string name, NeuronID i, AurynState val)
 Conveniently sets a single value of element i in a state vector identified by name in this group. More...
 
virtual AurynStateVectorget_default_exc_target ()
 Returns default exc target input. More...
 
virtual AurynStateVectorget_default_inh_target ()
 Returns default inh target input. More...
 
void random_mem (AurynState mean=-60e-3, AurynState sigma=5e-3)
 
virtual void init_state ()
 
void safe_tadd (NeuronID id, AurynWeight amount, TransmitterType t=GLUT)
 
void tadd (NeuronID id, AurynWeight amount, TransmitterType t=GLUT)
 
void tadd (AurynStateVector *state, NeuronID id, AurynWeight amount)
 
- Public Member Functions inherited from auryn::SpikingGroup
void add_state_vector (std::string key, AurynStateVector *state_vector)
 Adds a state vector passed as an argument to the dictinary. More...
 
void remove_state_vector (std::string key)
 Removes a state vector passed as an argument to the dictinary. More...
 
AurynStateVectorfind_state_vector (std::string key)
 Returns existing state vector by name or NULL if it does not exist. More...
 
AurynStateVectorget_state_vector (std::string key)
 Creates a new or returns an existing state vector by name. More...
 
AurynStateVectorget_existing_state_vector (std::string key)
 Returns an existing state with the supplied name. More...
 
AurynStateVectorcreate_state_vector (std::string key)
 Creates a new state vector and throws an exception if a vector with the same name exists. More...
 
AurynStateget_state_variable (std::string key)
 Creates a new group-wide state variable or returns an existing group-wide variable by name then returns a pointer to it. More...
 
void randomize_state_vector_gauss (std::string state_vector_name, AurynState mean, AurynState sigma, int seed=12239)
 Randomizes the content of a state vector with Gaussian random numbers. Seeding is MPI save. More...
 
 SpikingGroup (NeuronID size, NodeDistributionMode mode=AUTO)
 Default constructor. More...
 
virtual ~SpikingGroup ()
 Default destructor. More...
 
virtual void evolve_traces ()
 Evolves traces. More...
 
void set_name (std::string s)
 Set connection name. More...
 
std::string get_name ()
 Retrieves the groups name. More...
 
std::string get_file_name ()
 Extracts the class name of the connection from the file name. More...
 
std::string get_log_name ()
 Returns a string which is the combination of file and connection name for logging. More...
 
void inc_num_spike_attributes (int x)
 Instructs SpikingGroup to increase the number of spike attributes by x. More...
 
int get_num_spike_attributes ()
 
void conditional_evolve ()
 Conditional evolve functino which is called by System. More...
 
unsigned int get_locked_rank ()
 Returns locked rank for SpikingGroups which are not distributed across all ranks. More...
 
unsigned int get_locked_range ()
 Returns locked range of ranks for SpikingGroups which are not distributed across all ranks. More...
 
SpikeContainerget_spikes ()
 Returns pointer to a spike container that contains spikes which arrive in this timestep from all neurons in this group. More...
 
SpikeContainerget_spikes_immediate ()
 Returns pointer to SpikeContainer of spikes generated during the last evolve() step. More...
 
AttributeContainerget_attributes ()
 Returns pointer to Attributecontainer for usage in propagating Connection objects. Same as get_spikes_immediate(), however might be overwritten to contain Spikes that have been delayed. More...
 
AttributeContainerget_attributes_immediate ()
 Returns pointer to Attributecontainer of spikes generated during the last evolve() step. More...
 
NeuronID get_size ()
 Returns the size of the group. More...
 
NeuronID get_pre_size ()
 Returns the size of the group. More...
 
NeuronID calculate_rank_size (int rank=-1)
 Determines rank size and stores it in local variable. More...
 
NeuronID get_rank_size ()
 Returns the size on this rank. More...
 
NeuronID get_post_size ()
 Returns the size on this rank. More...
 
void set_clock_ptr (AurynTime *clock)
 
bool evolve_locally ()
 Returns true if the calling instance has units which are integrated on the current rank. More...
 
NeuronID get_uid ()
 Get the unique ID of the class. More...
 
Traceget_pre_trace (AurynFloat x)
 Returns a pre trace with time constant x. More...
 
void add_pre_trace (Trace *tr)
 Adds trace to pretrace stack of a connection. More...
 
Traceget_post_trace (AurynFloat x)
 Returns a post trace with time constant x. More...
 
void add_post_trace (Trace *tr)
 Adds trace to posttrace stack of a connection. More...
 
void push_spike (NeuronID spike)
 Pushes a local NeuronID as spike into the axonal SpikeDelay buffer. More...
 
void push_attribute (AurynFloat attrib)
 Pushes a spike attribute into the axonal SpikeDelay buffer. More...
 
void clear_spikes ()
 Clears all spikes stored in the delays which is useful to reset a network during runtime. More...
 
Traceget_post_state_trace (std::string state_name="mem", AurynFloat tau=10e-3, AurynFloat b=0.0)
 Returns a post trace of a neuronal state variable e.g. the membrane potential with time constant tau. More...
 
Traceget_post_state_trace (AurynStateVector *state, AurynFloat tau=10e-3, AurynFloat b=0.0)
 Returns a post trace of a neuronal state variable specified by pointer. More...
 
void set_delay (int d)
 Sets axonal delay for this SpikingGroup. More...
 
virtual bool write_to_file (const char *filename)
 Writes current states of SpikingGroup to human-readible textfile if implemented in derived class. More...
 
virtual bool load_from_file (const char *filename)
 Reads current states of SpikingGroup to human-readible textfile if implemented in derived class. More...
 
NeuronID ranksize ()
 Returns size (num of neurons) on the current rank. More...
 
NeuronID global2rank (NeuronID i)
 Converts global NeuronID within the SpikingGroup to the local NeuronID on this rank. More...
 
NeuronID rank2global (NeuronID i)
 Converts local NeuronID from the local rank to a global NeuronID. More...
 
bool localrank (NeuronID i)
 Checks if the global NeuronID i is integrated on this MPI rank. More...
 
NeuronID get_vector_size ()
 Rank size but rounded up to multiples of 4 (or potentially some other and larger number in future versions) for SSE compatibility. More...
 

Additional Inherited Members

- Public Attributes inherited from auryn::NeuronGroup
AurynStateVectormem
 
AurynStateVectorg_ampa
 
AurynStateVectorg_gaba
 
AurynStateVectorg_nmda
 
AurynStateVectorthr
 
- Public Attributes inherited from auryn::SpikingGroup
SpikeDelaydelay
 
bool active
 Toggles group active. More...
 
std::map< std::string, AurynStateVector * > state_vectors
 
std::map< std::string, AurynStatestate_variables
 
- Protected Member Functions inherited from auryn::NeuronGroup
void init ()
 
void free ()
 
- Protected Member Functions inherited from auryn::SpikingGroup
void free ()
 Frees potentially allocated memory. More...
 
- Protected Attributes inherited from auryn::NeuronGroup
AurynStateVectordefault_exc_target_state
 
AurynStateVectordefault_inh_target_state
 
- Protected Attributes inherited from auryn::SpikingGroup
std::vector< Trace * > pretraces
 Pretraces. More...
 
std::vector< Trace * > posttraces
 Posttraces. More...
 
std::vector< Trace * > post_state_traces
 Post state traces. More...
 
std::vector< AurynFloatpost_state_traces_spike_biases
 
std::vector< AurynStateVector * > post_state_traces_states
 
std::string group_name
 Identifying name for object. More...
 
NeuronID size
 Stores the size of the group. More...
 
NeuronID rank_size
 Stores the size of the group on this rank. More...
 
SpikeContainerspikes
 SpikeContainers to store spikes produced during one step of evolve. More...
 
AttributeContainerattribs
 
- Static Protected Attributes inherited from auryn::SpikingGroup
static AurynTimeclock_ptr = NULL
 

Detailed Description

Conductance based LIF neuron model with absolute refractoriness as used in Vogels and Abbott 2005.

Constructor & Destructor Documentation

◆ TIFGroup()

TIFGroup::TIFGroup ( NeuronID  size)

The default constructor of this NeuronGroup.

30  : NeuronGroup(size)
31 {
33  if ( evolve_locally() ) init();
34 }
NeuronGroup(NeuronID n, NodeDistributionMode mode=AUTO)
Default constructor.
Definition: NeuronGroup.cpp:36
bool evolve_locally()
Returns true if the calling instance has units which are integrated on the current rank...
Definition: SpikingGroup.cpp:323
System * sys
Global pointer to instance of System which needs to be initialized in every simulation main program...
Definition: auryn_global.cpp:37
void register_spiking_group(SpikingGroup *spiking_group)
Registers an instance of SpikingGroup to the spiking_groups vector.
Definition: System.cpp:261
NeuronID size
Stores the size of the group.
Definition: SpikingGroup.h:119
Here is the call graph for this function:

◆ ~TIFGroup()

TIFGroup::~TIFGroup ( )
virtual
84 {
85  if ( !evolve_locally() ) return;
86 
88 }
void auryn_vector_ushort_free(auryn_vector_ushort *v)
Definition: auryn_definitions.cpp:144
bool evolve_locally()
Returns true if the calling instance has units which are integrated on the current rank...
Definition: SpikingGroup.cpp:323
Here is the call graph for this function:

Member Function Documentation

◆ clear()

void TIFGroup::clear ( )
virtual

Resets all neurons to defined and identical initial state.

Implements auryn::NeuronGroup.

71 {
72  clear_spikes();
73  for (NeuronID i = 0; i < get_rank_size(); i++) {
74  auryn_vector_float_set (mem, i, e_rest);
75  auryn_vector_ushort_set (ref, i, 0);
78  auryn_vector_float_set (bg_current, i, 0.);
79  }
80 }
NeuronID get_rank_size()
Returns the size on this rank.
Definition: SpikingGroup.h:450
AurynStateVector * g_ampa
Definition: NeuronGroup.h:66
void clear_spikes()
Clears all spikes stored in the delays which is useful to reset a network during runtime.
Definition: SpikingGroup.cpp:339
AurynStateVector * g_gaba
Definition: NeuronGroup.h:68
AurynStateVector * mem
Definition: NeuronGroup.h:64
void auryn_vector_ushort_set(auryn_vector_ushort *v, const NeuronID i, unsigned short x)
Definition: auryn_definitions.cpp:164
unsigned int NeuronID
NeuronID is an unsigned integeger type used to index neurons in Auryn.
Definition: auryn_definitions.h:151
void auryn_vector_float_set(auryn_vector_float *v, const NeuronID i, AurynFloat x)
Definition: auryn_definitions.cpp:131
Here is the call graph for this function:

◆ evolve()

void TIFGroup::evolve ( )
virtual

Integrates the NeuronGroup state.

The evolve method internally used by System.

Implements auryn::SpikingGroup.

92 {
93 
94 
95  for (NeuronID i = 0 ; i < get_rank_size() ; ++i ) {
96  if (t_ref[i]==0) {
97  const AurynFloat dg_mem = ( (e_rest-t_mem[i])
98  - t_g_ampa[i] * (t_mem[i])
99  - t_g_gaba[i] * (t_mem[i]-e_rev_gaba)
100  + t_bg_cur[i] );
101  t_mem[i] += dg_mem*scale_mem;
102 
103  if (t_mem[i]>thr) {
104  push_spike(i);
105  t_mem[i] = e_rest ;
106  t_ref[i] += refractory_time ;
107  }
108  } else {
109  t_ref[i]-- ;
110  t_mem[i] = e_rest ;
111  }
112 
113  }
114 
115  // auryn_vector_float_scale(scale_ampa,g_ampa);
116  g_ampa->scale(scale_ampa);
117  // auryn_vector_float_scale(scale_gaba,g_gaba);
118  g_gaba->scale(scale_gaba);
119 }
NeuronID get_rank_size()
Returns the size on this rank.
Definition: SpikingGroup.h:450
AurynStateVector * g_ampa
Definition: NeuronGroup.h:66
void scale(const float a)
Definition: AurynVector.cpp:74
float AurynFloat
Low precision floating point datatype.
Definition: auryn_definitions.h:157
void push_spike(NeuronID spike)
Pushes a local NeuronID as spike into the axonal SpikeDelay buffer.
Definition: SpikingGroup.cpp:270
AurynStateVector * g_gaba
Definition: NeuronGroup.h:68
unsigned int NeuronID
NeuronID is an unsigned integeger type used to index neurons in Auryn.
Definition: auryn_definitions.h:151
Here is the call graph for this function:

◆ get_bg_current()

AurynFloat TIFGroup::get_bg_current ( NeuronID  i)

Gets the current background current value for neuron i.

151  {
152  if ( localrank(i) )
153  return auryn_vector_float_get ( bg_current , global2rank(i) ) ;
154  else
155  return 0;
156 }
bool localrank(NeuronID i)
Checks if the global NeuronID i is integrated on this MPI rank.
Definition: SpikingGroup.cpp:531
NeuronID global2rank(NeuronID i)
Converts global NeuronID within the SpikingGroup to the local NeuronID on this rank.
Definition: SpikingGroup.h:446
AurynFloat auryn_vector_float_get(auryn_vector_float *v, const NeuronID i)
Definition: auryn_definitions.cpp:123
Here is the call graph for this function:

◆ get_tau_ampa()

AurynFloat TIFGroup::get_tau_ampa ( )

Gets the exponential time constant for the AMPA channel.

189 {
190  return tau_ampa;
191 }

◆ get_tau_gaba()

AurynFloat TIFGroup::get_tau_gaba ( )

Gets the exponential time constant for the GABA channel.

200 {
201  return tau_gaba;
202 }

◆ set_bg_current()

void TIFGroup::set_bg_current ( NeuronID  i,
AurynFloat  current 
)

Controls the constant current input (per default set so zero) to neuron i.

121  {
122  if ( localrank(i) )
123  auryn_vector_float_set ( bg_current , global2rank(i) , current ) ;
124 }
bool localrank(NeuronID i)
Checks if the global NeuronID i is integrated on this MPI rank.
Definition: SpikingGroup.cpp:531
NeuronID global2rank(NeuronID i)
Converts global NeuronID within the SpikingGroup to the local NeuronID on this rank.
Definition: SpikingGroup.h:446
void auryn_vector_float_set(auryn_vector_float *v, const NeuronID i, AurynFloat x)
Definition: auryn_definitions.cpp:131
Here is the call graph for this function:

◆ set_bg_currents()

void TIFGroup::set_bg_currents ( AurynFloat  current)

Controls the constant current input to all neurons.

126  {
127  for ( NeuronID i = 0 ; i < get_rank_size() ; ++i )
128  auryn_vector_float_set ( bg_current , i , current ) ;
129 }
NeuronID get_rank_size()
Returns the size on this rank.
Definition: SpikingGroup.h:450
unsigned int NeuronID
NeuronID is an unsigned integeger type used to index neurons in Auryn.
Definition: auryn_definitions.h:151
void auryn_vector_float_set(auryn_vector_float *v, const NeuronID i, AurynFloat x)
Definition: auryn_definitions.cpp:131
Here is the call graph for this function:

◆ set_c_mem()

void TIFGroup::set_c_mem ( AurynFloat  cm)

Sets the membrane capacitance (default 200pF)

145 {
146  c_mem = cm;
147  tau_mem = r_mem*c_mem;
148  calculate_scale_constants();
149 }

◆ set_r_mem()

void TIFGroup::set_r_mem ( AurynFloat  rm)

Sets the membrane resistance (default 100 M-ohm)

138 {
139  r_mem = rm;
140  tau_mem = r_mem*c_mem;
141  calculate_scale_constants();
142 }

◆ set_refractory_period()

void TIFGroup::set_refractory_period ( AurynDouble  t)

Setter for refractory time [s].

205 {
206  refractory_time = (unsigned short) (t/auryn_timestep);
207 }
double auryn_timestep
Simulation timestep in seconds.
Definition: auryn_definitions.cpp:31
Here is the call graph for this function:

◆ set_tau_ampa()

void TIFGroup::set_tau_ampa ( AurynFloat  tau)

Sets the exponential time constant for the AMPA channel (default 5ms)

183 {
184  tau_ampa = taum;
185  calculate_scale_constants();
186 }

◆ set_tau_gaba()

void TIFGroup::set_tau_gaba ( AurynFloat  tau)

Sets the exponential time constant for the GABA channel (default 10ms)

194 {
195  tau_gaba = taum;
196  calculate_scale_constants();
197 }

◆ set_tau_mem()

void TIFGroup::set_tau_mem ( AurynFloat  taum)

Sets the membrane time constant (default 20ms)

132 {
133  tau_mem = taum;
134  calculate_scale_constants();
135 }

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