CARLsim  5.0.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 * CARLsim5: HK, JX, KC
45 *
46 * CARLsim available from http://socsci.uci.edu/~jkrichma/CARLsim/
47 * Ver 12/31/2016
48 */
49 
50 // paradigm shift: run this on spikes.
51 
52 #ifndef _GROUP_MON_H_
53 #define _GROUP_MON_H_
54 
55 #include <carlsim_datastructures.h>
56 #include <vector> // std::vector
57 
58 class SNN; // forward declaration of SNN class
59 class GroupMonitorCore; // forward declaration of implementation
60 
105  public:
112  GroupMonitor(GroupMonitorCore* groupMonitorCorePtr);
113 
120  virtual ~GroupMonitor();
121 
122 
123  // +++++ PUBLIC METHODS: +++++++++++++++++++++++++++++++++++++++++++++++//
124 
131  bool isRecording();
132 
146  void startRecording();
147 
155  void stopRecording();
156 
167  int getRecordingTotalTime();
168 
177 
185  int getRecordingStartTime();
186 
193  int getRecordingStopTime();
194 
203  bool getPersistentData();
204 
214  void setPersistentData(bool persistentData);
215 
225  std::vector<float> getDataVector();
226 
236  std::vector<int> getTimeVector();
237 
247  std::vector<float> getPeakValueVector();
248 
258  std::vector<int> getPeakTimeVector();
259 
270  std::vector<float> getSortedPeakValueVector();
271 
282  std::vector<int> getSortedPeakTimeVector();
283 
284  private:
286  GroupMonitorCore* groupMonitorCorePtr_;
287 };
288 
289 #endif
GroupMonitor::getRecordingStartTime
int getRecordingStartTime()
Returns the simulation time (ms) of the first call to startRecording()
Definition: group_monitor.cpp:100
carlsim_datastructures.h
GroupMonitor::GroupMonitor
GroupMonitor(GroupMonitorCore *groupMonitorCorePtr)
GroupMonitor constructor.
Definition: group_monitor.cpp:57
GroupMonitor::getTimeVector
std::vector< int > getTimeVector()
return a vector of the timestamps for group data
Definition: group_monitor.cpp:129
GroupMonitor::getRecordingStopTime
int getRecordingStopTime()
Returns the simulation time (ms) of the last call to stopRecording()
Definition: group_monitor.cpp:107
GroupMonitorCore
GroupMonitor private core implementation.
Definition: group_monitor_core.h:64
GroupMonitor::~GroupMonitor
virtual ~GroupMonitor()
GroupMonitor destructor.
Definition: group_monitor.cpp:62
GroupMonitor::startRecording
void startRecording()
Starts a new recording period.
Definition: group_monitor.cpp:72
GroupMonitor
Class GroupMonitor.
Definition: group_monitor.h:104
GroupMonitor::getDataVector
std::vector< float > getDataVector()
return the group data vector
Definition: group_monitor.cpp:122
GroupMonitor::getRecordingTotalTime
int getRecordingTotalTime()
Returns the total recording time (ms)
Definition: group_monitor.cpp:86
GroupMonitor::isRecording
bool isRecording()
Recording status (true=recording, false=not recording)
Definition: group_monitor.cpp:68
GroupMonitor::stopRecording
void stopRecording()
Ends a recording period.
Definition: group_monitor.cpp:79
GroupMonitor::setPersistentData
void setPersistentData(bool persistentData)
Sets PersistentMode either on (true) or off (false)
Definition: group_monitor.cpp:118
GroupMonitor::getRecordingLastStartTime
int getRecordingLastStartTime()
Returns the simulation time (ms) of the last call to startRecording()
Definition: group_monitor.cpp:93
SNN
Contains all of CARLsim's core functionality.
Definition: snn.h:115
GroupMonitor::getPeakValueVector
std::vector< float > getPeakValueVector()
return a vector of peak values in group data
Definition: group_monitor.cpp:150
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:143
GroupMonitor::getPersistentData
bool getPersistentData()
Returns a flag that indicates whether PersistentMode is on (true) or off (false)
Definition: group_monitor.cpp:114
GroupMonitor::getSortedPeakValueVector
std::vector< float > getSortedPeakValueVector()
return a vector of peak values in group data (sorted in decending order)
Definition: group_monitor.cpp:157
GroupMonitor::getPeakTimeVector
std::vector< int > getPeakTimeVector()
return a vector of the timestamps for peak values in group data
Definition: group_monitor.cpp:136