CARLsim  4.1.0
CARLsim: a GPU-accelerated SNN simulator
group_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 *
45 * CARLsim available from http://socsci.uci.edu/~jkrichma/CARLsim/
46 * Ver 12/31/2016
47 */
48 
49 // paradigm shift: run this on spikes.
50 
51 #ifndef _GROUP_MON_H_
52 #define _GROUP_MON_H_
53 
54 #include <carlsim_datastructures.h>
55 #include <vector> // std::vector
56 
57 class SNN; // forward declaration of SNN class
58 class GroupMonitorCore; // forward declaration of implementation
59 
104  public:
111  GroupMonitor(GroupMonitorCore* groupMonitorCorePtr);
112 
119  virtual ~GroupMonitor();
120 
121 
122  // +++++ PUBLIC METHODS: +++++++++++++++++++++++++++++++++++++++++++++++//
123 
130  bool isRecording();
131 
145  void startRecording();
146 
154  void stopRecording();
155 
166  int getRecordingTotalTime();
167 
176 
184  int getRecordingStartTime();
185 
192  int getRecordingStopTime();
193 
202  bool getPersistentData();
203 
213  void setPersistentData(bool persistentData);
214 
224  std::vector<float> getDataVector();
225 
235  std::vector<int> getTimeVector();
236 
246  std::vector<float> getPeakValueVector();
247 
257  std::vector<int> getPeakTimeVector();
258 
269  std::vector<float> getSortedPeakValueVector();
270 
281  std::vector<int> getSortedPeakTimeVector();
282 
283  private:
285  GroupMonitorCore* groupMonitorCorePtr_;
286 };
287 
288 #endif
GroupMonitor::getRecordingStartTime
int getRecordingStartTime()
Returns the simulation time (ms) of the first call to startRecording()
Definition: group_monitor.cpp:99
carlsim_datastructures.h
GroupMonitor::GroupMonitor
GroupMonitor(GroupMonitorCore *groupMonitorCorePtr)
GroupMonitor constructor.
Definition: group_monitor.cpp:56
GroupMonitor::getTimeVector
std::vector< int > getTimeVector()
return a vector of the timestamps for group data
Definition: group_monitor.cpp:128
GroupMonitor::getRecordingStopTime
int getRecordingStopTime()
Returns the simulation time (ms) of the last call to stopRecording()
Definition: group_monitor.cpp:106
GroupMonitorCore
GroupMonitor private core implementation.
Definition: group_monitor_core.h:63
GroupMonitor::~GroupMonitor
virtual ~GroupMonitor()
GroupMonitor destructor.
Definition: group_monitor.cpp:61
GroupMonitor::startRecording
void startRecording()
Starts a new recording period.
Definition: group_monitor.cpp:71
GroupMonitor
Class GroupMonitor.
Definition: group_monitor.h:103
GroupMonitor::getDataVector
std::vector< float > getDataVector()
return the group data vector
Definition: group_monitor.cpp:121
GroupMonitor::getRecordingTotalTime
int getRecordingTotalTime()
Returns the total recording time (ms)
Definition: group_monitor.cpp:85
GroupMonitor::isRecording
bool isRecording()
Recording status (true=recording, false=not recording)
Definition: group_monitor.cpp:67
GroupMonitor::stopRecording
void stopRecording()
Ends a recording period.
Definition: group_monitor.cpp:78
GroupMonitor::setPersistentData
void setPersistentData(bool persistentData)
Sets PersistentMode either on (true) or off (false)
Definition: group_monitor.cpp:117
GroupMonitor::getRecordingLastStartTime
int getRecordingLastStartTime()
Returns the simulation time (ms) of the last call to startRecording()
Definition: group_monitor.cpp:92
SNN
Contains all of CARLsim's core functionality.
Definition: snn.h:114
GroupMonitor::getPeakValueVector
std::vector< float > getPeakValueVector()
return a vector of peak values in group data
Definition: group_monitor.cpp:149
GroupMonitor::getSortedPeakTimeVector
std::vector< int > getSortedPeakTimeVector()
return a vector of the timestamps for peak values in group data (sorted in decending order)
Definition: group_monitor.cpp:142
GroupMonitor::getPersistentData
bool getPersistentData()
Returns a flag that indicates whether PersistentMode is on (true) or off (false)
Definition: group_monitor.cpp:113
GroupMonitor::getSortedPeakValueVector
std::vector< float > getSortedPeakValueVector()
return a vector of peak values in group data (sorted in decending order)
Definition: group_monitor.cpp:156
GroupMonitor::getPeakTimeVector
std::vector< int > getPeakTimeVector()
return a vector of the timestamps for peak values in group data
Definition: group_monitor.cpp:135