pyxid 1.0 Beta 6

Python library for interfacing with Cedrus XID devices<br /><br />XID (eXperiment Interface Device) devices are used in software such as SuperLab, Presentation, and ePrime for receiving input as part of stimulus/response testing experiments.<br /><br />This handles all of the low level device handling for XID devices in python projects. The developer using this library must poll the attached device(s) for responses. Heres's an example of how to do so:<br /><br /> import pyxid<br /><br /> # get a list of all attached XID devices<br /> devices = pyxid.get_xid_devices()<br /><br /> dev = devices[0] # get the first device to use<br /> if dev.is_response_device():<br /> dev.reset_base_timer()<br /> dev.reset_rt_timer()<br /><br /> while True:<br /> dev.poll_for_response()<br /> if dev.respone_queue_size() > 0:<br /> response = dev.get_next_response()<br /> # do something with the response<br /><br /><br />The response is a python dict with the following keys:<br /><br /> pressed: True if the key was pressed, False if it was released<br /> key: Response pad key pressed by the subject<br /> port: Device port the response was from (typically 0)<br /> time: value of the Response Time timer when the key was hit/released<br /><br /><br />Timers<br /><br />Each Cedrus XID device has an internal timer a Base Timer and a<br />Response Time Timer. The Base Timer should be reset at the start of an experiment. The Response Time timer should be reset whenever a stimulus is presented.<br /><br />At the time of this library release, there is a known issue with clock drift in XID devices. Our hardware/firmware developer is currently looking into the issue. Once it has been resolved, a new version of this library will be released. For the time being, the time field in the dict returned by XidDevice.get_next_response() is 0 until the fix is applied in a subsequent release.<br /><br /><br />StimTracker<br /><br />Support for Cedrus StimTracker devices is now included. On StimTracker devices, there are the following methods:<br /><br /> set_pulse_duration()<br /> activate_line()<br /> clear_line()<br /><br />See the docstring for activate_line() for documentation on how to use it.<br /><br />These methods are not available if the device is a response pad.<br /><br /><br />Windows Specific Issues<br /><br />Sometimes, windows fails at detecting XID devices. Running<br />detect_xid_devices() a second time should result in finding the<br />devices.

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Activate Line,  Attached,  Cedrus,  Developer,  Device,  Devices,  Library,  Methods,  Pressed,  Python,  Released,  Reset,  Response,  Stimtracker,  Timer
Users rating:	0/10