1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
|
"""
A Trigger input
This module contains a class implementing a trigger input.
"""
__author__ = 'Florian Krause <florian@expyriment.org>, \
Oliver Lindemann <oliver@expyriment.org>'
__version__ = '0.7.0'
__revision__ = '55a4e7e'
__date__ = 'Wed Mar 26 14:33:37 2014 +0100'
import defaults
import expyriment
from expyriment.misc import compare_codes
from expyriment.misc._timer import get_time
from _keyboard import Keyboard
from _input_output import Input
class TriggerInput(Input):
"""A class implementing a trigger input."""
def __init__(self, interface, default_code=None):
"""Create a trigger input.
Parameters
interface -- the interface to use (expyrment.io.SerialPort or
expyriment.io.ParallelPort object)
default_code -- the default code of the trigger (int) (optional)
"""
Input.__init__(self)
self._interface = interface
if default_code is not None:
self._default_code = default_code
else:
self._default_code = defaults.triggerinput_default_code
@property
def interface(self):
"""Getter for interface"""
return self._interface
@property
def default_code(self):
"""Getter for default_code"""
return self._default_code
@default_code.setter
def default_code(self, value):
"""Getter for default_code"""
self._default_code = value
def wait(self, code=None, bitwise_comparison=False):
"""Wait for a trigger.
Returns the code received and the reaction time [code, rt].
If bitwise_comparison = True, the function performs a bitwise
comparison (logical and) between code and received input and waits
until a certain bit pattern is set.
Parameters
code -- a specific code to wait for (int) (optional)
bitwise_comparison -- make a bitwise comparison (default=False)
"""
start = get_time()
found = None
rt = None
if code is None:
code = self._default_code
self.interface.clear()
while True:
expyriment._active_exp._execute_wait_callback()
read = self.interface.poll()
if read is not None:
if code is None: #return for every event
rt = int((get_time() - start) * 1000)
found = read
break
elif compare_codes(read, code, bitwise_comparison):
rt = int((get_time() - start) * 1000)
found = read
break
if Keyboard.process_control_keys():
break
if self._logging:
expyriment._active_exp._event_file_log(
"TriggerInput,received,{0},wait".format(found))
return found, rt
def get_triggers(self, code=None, bitwise_comparison=False):
"""Get list of received triggers.
For not missing any triggers the history has to be updated regularly
(e.g. by calling this method)!
Returns None if no history is used.
If bitwise_comparision = True, the function performs a bitwise
comparison (logical and) between code and received input and waits
until a certain bit pattern is set.
Parameters
code -- a specific code to get (int) (optional)
bitwise_comparison -- make a bitwise comparison (default=False)
"""
if self.interface.has_input_history:
self.interface.clear()
counter_list = []
if code is None:
code = self._default_code
for event in self.interface.input_history.get_whole_buffer():
if code is None: #get them all
counter_list.append(event)
elif compare_codes(event, code, bitwise_comparison):
counter_list.append(event)
return counter_list
else:
return None
@property
def trigger_count(self, code=None, bitwise_comparison=False):
"""Get the number of received triggers.
For not missing any triggers the history has to be updated regularly
(e.g. by calling this method)!
Returns None if no history is used.
If bitwise_comparision = True, the function performs a bitwise
comparison (logical and) between code and received input and waits
until a certain bit pattern is set.
Parameters
code -- a specific code to count (int) (optional)
bitwise_comparison -- make a bitwise comparison (default=False)
"""
if self.interface.has_input_history:
self.interface.clear()
counter = 0
if code is None:
code = self._default_code
for event in self.interface.input_history.get_whole_buffer():
if code is None: #count all
counter += 1
elif compare_codes(event, code, bitwise_comparison):
counter += 1
return counter
else:
return None
|
