RAM System 3.1 Task Laptop code

Supported experiments

As of 2017-05-19, the following experiments are supported:

• FR1
• catFR1
• FR3
• catFR3
• PS4/FR5
• PS4/catFR5
• FR5/REC1
• catFR5/REC1
• PAL1
• PAL5

Upgrading from version 3.0

As the admin user

• Ensure permissions are correct: sudo chown -R exp /Users/exp/miniconda2/lib
• Check if Xcode needs to be updated (you'll need Xcode version 8.x) by opening the App Store.
• If homebrew is not installed, install it
• Install portaudio: brew install portaudio
• Install zeromq for THR: brew install zeromq
• Install pocketsphinx for THR: brew tap watsonbox/cmu-sphinx && brew install --HEAD watsonbox/cmu-sphinx/cmu-sphinxbase && brew install --HEAD watsonbox/cmu-sphinx/cmu-pocketsphinx

As the exp user

Clone the v3.1 branch of RAMControl:

$ git clone https://github.com/ramdarpaprojectorg/RAMControl.git -b v3.1 ~/RAM_3.1

Then cd ~/RAM_3.1 and run:

./install.sh

Upgrading from previous 3.1.x versions

Please see the CHANGELOG.md file for instructions.

Practice lists

The catFR practice list differs from that of FR to avoid reuse of some of the words. This change was initially made in System 2 revision 165 and has been used in System 3 since version 3.0.0.

Troubleshooting

Tasks can be started in debug mode to diagnose problems. This requires opening a terminal, navigating to the directory with the task code, and running with:

$ python run.py -d

(see also --help to see other options). This will start PyEPL in windowed mode and allow you to check output in the terminal.

AttributeErrors

If running in debug mode you see an error such as:

AttributeError: 'module' objet has no attribute 'load'

try forcing a reinstall of dependencies:

pip install --force-reinstall -U -r requirements.txt

ZMQ errors

This happens when the ethernet cable is unplugged from either the task laptop, the host PC, or both.

1. Check that the cable is plugged into both computers. Try starting the experiment again.
2. Unplug and replug the cables and try again.
3. See if a zombie process is hogging the TCP port and kill by PID if so: lsof -i tcp:8889

Errors installing PyAudio

For some reason when installing portaudio with brew, environment variables are necessary to compile PyAudio:

CPATH=/usr/local/include LIBRARY_PATH=/usr/local/lib pip install pyaudio

Notes for developers

Debugger

For testing host applications, there is a debugger script included. You can generate scripted messages from the host PC's output.log (see tests/FR1_output.log). Example:

$ python -m ramcontrol.debugger.py generate -s test -x FR1 -n 1 -o fr1_script.csv -f tests/FR1_output.log

To run the generated script:

$ python -m ramcontrol.debugger.py run -f fr1_script.csv

Caveat emptor: Make sure you have loaded the experimental configuration on the host PC first!

Testing

Unit testing is in the process of being added. To run existing tests, you'll need to run

$ pip install -r requirements.txt
$ pip install -e .

Then tests are run with

$ pytest