Skip to content

Laboratory of Neuropsychology

Getting Started with NIMH-MonkeyLogic

Obtaining and Installing MonkeyLogic2

The official NIMH-MonkeyLogic can be obtained from the download information page.

Software Installation

Automatic Installation (.mlappinstall)

We recommend you use the installer program (NIMH_MonkeyLogic_2.mlappinstall) rather than the zip files ( Both can be found on the download information page on this site. The MonkeyLogic2 installer will automatically handle most of the configuration steps for you. If you want to do a manual installation (see below), use

Using the MonkeyLogic2 installer

The installer will automatically handle most of the configuration steps for you. If using the installer, MonkeyLogic will be copied to the following directory:


Screenshot of the Monkey Logic program installer

If you have multiple Matlab versions on your computer, run the version you want to use with MonkeyLogic, and select the "Install App" button, choose the installer file, and the rest will be done automatically for you. 

Screenshot of the Monkey Logic program menu

Manual Installation with

You can manually install NIMH-Monkey Logic. After downloading, decompress and install the Monkey Logic distribution folder anywhere on your desktop provided that you add the location to your Matlab's path variable. Next, create directories for each experiment; in each directory, you will place an experiment's conditions file, timing script, stimulus images, and any other needed files (e.g., block-selection routines, etc). Behavioral (BHV) data files for a particular experiment will be saved into this directory as well. These experiment directories do not need to be added to the MATLAB path, only the main distribution folder and its subfolders.

You will need to add the NIMH-DAQ Toolbox, which is part of the Monkey Logic distribution, to Matlab's path. Follow the instructions included in the readme file of the daqtoolbox.

Starting MonkeyLogic

If you used the installer app to setup MonkeyLogic, you will find an app icon in the Matlab "APPS" menu. You can click on it to start MonkeyLogic.

If you have installed MonkeyLogic manually follow these steps:

Start up MATLAB. Change to your working directory to one that where MonkeyLogic.m is found. Then launch the MonkeyLogic menu by typing "monkeylogic" at the MATLAB command prompt. You can create a MATLAB script called STARTUP.M to automate these steps. A simple example STARTUP.M file looks like this:

% Default startup for monkeylogic
cd C:\Users\your_user_name\Documents\MATLAB\Add-Ons\Apps

When MonkeyLogic starts up it displays a UI called the MonkeyLogic "Menu" showing all the settings. At the bare minimum, you must load a conditions file, enter a file name, and then press the run button. This will cause the stimulus screen to appear (make sure you have the proper monitor number selected), and the trial to start running.

For additional configuration details, click here.

Example Files

MonkeyLogic comes with an example condition script and stimuli that will allow you to run a "match to sample" experiment, present stimulus, record responses using the mouse, and then save and recall your data. The examples are well-documented and very informative.

Data files supported by Monkey Logic

MonkeyLogic supports its own internal data file structure, called BHV. For more information, please visit the Monkey Logic commands page.