CARLsim  6.1.0
CARLsim: a GPU-accelerated SNN simulator
connection_monitor.h
Go to the documentation of this file.
1 /* * Copyright (c) 2016 Regents of the University of California. All rights reserved.
2 *
3 * Redistribution and use in source and binary forms, with or without
4 * modification, are permitted provided that the following conditions
5 * are met:
6 *
7 * 1. Redistributions of source code must retain the above copyright
8 * notice, this list of conditions and the following disclaimer.
9 *
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 *
14 * 3. The names of its contributors may not be used to endorse or promote
15 * products derived from this software without specific prior written
16 * permission.
17 *
18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
21 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
22 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
23 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
24 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
25 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
26 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
27 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
28 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29 *
30 * *********************************************************************************************** *
31 * CARLsim
32 * created by: (MDR) Micah Richert, (JN) Jayram M. Nageswaran
33 * maintained by:
34 * (MA) Mike Avery <averym@uci.edu>
35 * (MB) Michael Beyeler <mbeyeler@uci.edu>,
36 * (KDC) Kristofor Carlson <kdcarlso@uci.edu>
37 * (TSC) Ting-Shuo Chou <tingshuc@uci.edu>
38 * (HK) Hirak J Kashyap <kashyaph@uci.edu>
39 *
40 * CARLsim v1.0: JM, MDR
41 * CARLsim v2.0/v2.1/v2.2: JM, MDR, MA, MB, KDC
42 * CARLsim3: MB, KDC, TSC
43 * CARLsim4: TSC, HK
44 * CARLsim5: HK, JX, KC
45 * CARLsim6: LN, JX, KC, KW
46 *
47 * CARLsim available from http://socsci.uci.edu/~jkrichma/CARLsim/
48 * Ver 12/31/2016
49 */
50 
51 #ifndef _CONN_MON_H_
52 #define _CONN_MON_H_
53 
54 #include "carlsim_api.h"
55 
56 #include <vector> // std::vector
57 #include <carlsim_definitions.h> // ALL
58 
59 class ConnectionMonitorCore; // forward declaration of implementation
60 
153  public:
160  ConnectionMonitor(ConnectionMonitorCore* connMonCorePtr);
161 
169 
170  // +++++ PUBLIC METHODS: +++++++++++++++++++++++++++++++++++++++++++++++//
171 
190  std::vector< std::vector<float> > calcWeightChanges();
191 
193  std::vector< std::vector<float> > getWeights();
194 
196  std::vector< std::vector<float> > getPrevWeights();
197 
198 
206  short int getConnectId();
207 
214  int getFanIn(int neurPostId);
215 
222  int getFanOut(int neurPreId);
223 
241  double getMaxWeight(bool getCurrent=false);
242 
260  double getMinWeight(bool getCurrent=false);
261 
268  int getNumNeuronsPre();
269 
276  int getNumNeuronsPost();
277 
284  int getNumSynapses();
285 
299  int getNumWeightsChanged(double minAbsChanged=1e-5);
300 
318  int getNumWeightsInRange(double minValue, double maxValue);
319 
340  int getNumWeightsWithValue(double value);
341 
362  double getPercentWeightsInRange(double minValue, double maxValue);
363 
384  double getPercentWeightsWithValue(double value);
385 
386 
402  double getPercentWeightsChanged(double minAbsChanged=1e-5);
403 
412  long int getTimeMsCurrentSnapshot();
413 
421  long int getTimeMsLastSnapshot();
422 
432  long int getTimeMsSinceLastSnapshot();
433 
443  double getTotalAbsWeightChange();
444 
460  void print();
461 
482  void printSparse(int neurPostId=ALL, int maxConn=100, int connPerLine=4);
483 
498  void setUpdateTimeIntervalSec(int intervalSec);
499 
516  std::vector< std::vector<float> > takeSnapshot();
517 
518 
519 
520 private:
522  ConnectionMonitorCore* connMonCorePtr_;
523 };
524 
525 #endif
#define ALL
CARLsim common definitions.
#define CARLSIM_API
Definition: carlsim_api.h:14
Class ConnectionMonitor.