CARLsim  4.1.0
CARLsim: a GPU-accelerated SNN simulator
group_monitor.cpp
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 #include <group_monitor.h>
49 
50 #include <group_monitor_core.h> // GroupMonitor private implementation
51 #include <user_errors.h> // fancy user error messages
52 
53 #include <sstream> // std::stringstream
54 
55 // we aren't using namespace std so pay attention!
57  // make sure the pointer is NULL
58  groupMonitorCorePtr_ = groupMonitorCorePtr;
59 }
60 
62  delete groupMonitorCorePtr_;
63 }
64 
65 // +++++ PUBLIC METHODS: +++++++++++++++++++++++++++++++++++++++++++++++//
66 
68  return groupMonitorCorePtr_->isRecording();
69 }
70 
72  std::string funcName = "startRecording()";
74 
75  groupMonitorCorePtr_->startRecording();
76 }
77 
79  std::string funcName = "stopRecording()";
81 
82  groupMonitorCorePtr_->stopRecording();
83 }
84 
86  std::string funcName = "getRecordingTotalTime()";
88 
89  return groupMonitorCorePtr_->getRecordingTotalTime();
90 }
91 
93  std::string funcName = "getRecordingLastStartTime()";
95 
96  return groupMonitorCorePtr_->getRecordingLastStartTime();
97 }
98 
100  std::string funcName = "getRecordingStartTime()";
101  UserErrors::assertTrue(!isRecording(), UserErrors::CANNOT_BE_ON, funcName, "Recording");
102 
103  return groupMonitorCorePtr_->getRecordingStartTime();
104 }
105 
107  std::string funcName = "getRecordingStopTime()";
108  UserErrors::assertTrue(!isRecording(), UserErrors::CANNOT_BE_ON, funcName, "Recording");
109 
110  return groupMonitorCorePtr_->getRecordingStopTime();
111 }
112 
114  return groupMonitorCorePtr_->getPersistentData();
115 }
116 
117 void GroupMonitor::setPersistentData(bool persistentData) {
118  groupMonitorCorePtr_->setPersistentData(persistentData);
119 }
120 
121 std::vector<float> GroupMonitor::getDataVector(){
122  std::string funcName = "getDataVector()";
123  UserErrors::assertTrue(!isRecording(), UserErrors::CANNOT_BE_ON, funcName, "Recording");
124 
125  return groupMonitorCorePtr_->getDataVector();
126 }
127 
128 std::vector<int> GroupMonitor::getTimeVector(){
129  std::string funcName = "getTimeVector()";
130  UserErrors::assertTrue(!isRecording(), UserErrors::CANNOT_BE_ON, funcName, "Recording");
131 
132  return groupMonitorCorePtr_->getTimeVector();
133 }
134 
136  std::string funcName = "getPeakTimeVector()";
137  UserErrors::assertTrue(!isRecording(), UserErrors::CANNOT_BE_ON, funcName, "Recording");
138 
139  return groupMonitorCorePtr_->getPeakTimeVector();
140 }
141 
143  std::string funcName = "getSortedPeakTimeVector()";
144  UserErrors::assertTrue(!isRecording(), UserErrors::CANNOT_BE_ON, funcName, "Recording");
145 
146  return groupMonitorCorePtr_->getSortedPeakTimeVector();
147 }
148 
149 std::vector<float> GroupMonitor::getPeakValueVector() {
150  std::string funcName = "getPeakValueVector()";
151  UserErrors::assertTrue(!isRecording(), UserErrors::CANNOT_BE_ON, funcName, "Recording");
152 
153  return groupMonitorCorePtr_->getPeakValueVector();
154 }
155 
157  std::string funcName = "getSortedPeakValueVector()";
158  UserErrors::assertTrue(!isRecording(), UserErrors::CANNOT_BE_ON, funcName, "Recording");
159 
160  return groupMonitorCorePtr_->getSortedPeakValueVector();
161 }
UserErrors::CANNOT_BE_ON
@ CANNOT_BE_ON
parameter cannot be on
Definition: user_errors.h:38
user_errors.h
GroupMonitor::getRecordingStartTime
int getRecordingStartTime()
Returns the simulation time (ms) of the first call to startRecording()
Definition: group_monitor.cpp:99
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
group_monitor_core.h
GroupMonitor::getRecordingStopTime
int getRecordingStopTime()
Returns the simulation time (ms) of the last call to stopRecording()
Definition: group_monitor.cpp:106
GroupMonitorCore::startRecording
void startRecording()
starts recording group data
Definition: group_monitor_core.cpp:179
GroupMonitorCore::getPeakTimeVector
std::vector< int > getPeakTimeVector()
get the timestamps for peak values
Definition: group_monitor_core.cpp:125
GroupMonitorCore::getPersistentData
bool getPersistentData()
returns status of PersistentData mode
Definition: group_monitor_core.h:84
UserErrors::MUST_BE_ON
@ MUST_BE_ON
parameter must be on
Definition: user_errors.h:52
GroupMonitorCore::getSortedPeakValueVector
std::vector< float > getSortedPeakValueVector()
get the sorted peak values of group data
Definition: group_monitor_core.cpp:164
GroupMonitorCore::getDataVector
std::vector< float > getDataVector()
get the group data
Definition: group_monitor_core.cpp:117
GroupMonitorCore::getRecordingStartTime
int getRecordingStartTime()
retunrs the timestamp of the first startRecording in ms
Definition: group_monitor_core.h:90
GroupMonitorCore
GroupMonitor private core implementation.
Definition: group_monitor_core.h:63
group_monitor.h
GroupMonitorCore::stopRecording
void stopRecording()
stops recording group data
Definition: group_monitor_core.cpp:206
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::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
GroupMonitorCore::isRecording
bool isRecording()
returns recording status
Definition: group_monitor_core.h:99
GroupMonitorCore::getRecordingLastStartTime
int getRecordingLastStartTime()
returns the timestamp of the last startRecording in ms
Definition: group_monitor_core.h:93
GroupMonitorCore::getSortedPeakTimeVector
std::vector< int > getSortedPeakTimeVector()
get the sorted timestamps for peak values
Definition: group_monitor_core.cpp:137
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
GroupMonitorCore::getRecordingTotalTime
int getRecordingTotalTime()
returns the total recorded time in ms
Definition: group_monitor_core.h:87
GroupMonitor::getRecordingLastStartTime
int getRecordingLastStartTime()
Returns the simulation time (ms) of the last call to startRecording()
Definition: group_monitor.cpp:92
GroupMonitor::getPeakValueVector
std::vector< float > getPeakValueVector()
return a vector of peak values in group data
Definition: group_monitor.cpp:149
GroupMonitorCore::setPersistentData
void setPersistentData(bool persistentData)
sets status of PersistentData mode
Definition: group_monitor_core.h:105
GroupMonitorCore::getTimeVector
std::vector< int > getTimeVector()
get the timestamps for group data
Definition: group_monitor_core.cpp:121
GroupMonitorCore::getPeakValueVector
std::vector< float > getPeakValueVector()
get the peak values of group data
Definition: group_monitor_core.cpp:152
UserErrors::assertTrue
static void assertTrue(bool statement, errorType errorIfAssertionFails, std::string errorFunc, std::string errorMsgPrefix="", std::string errorMsgSuffix="")
simple wrapper for assert statement
Definition: user_errors.cpp:15
GroupMonitorCore::getRecordingStopTime
int getRecordingStopTime()
returns the timestamp of stopRecording
Definition: group_monitor_core.h:96
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