Imager (version 1.1.1) Imager is software that can run 3 tests: Picture Selection Task, Truth Value Task, and a Picture Description Task. NOTE: This software runs on Mac OSX 10.4 and 10.5 and probably later. CONTENTS 1. Installation 2. Introduction 3. Workflow 4. How te set up 5. Controls 6. Logfiles 7. Examples 8. Uninstall 9. Remarks 1. INSTALLATION If not already mounted, mount the Imager-1.1.1 disk image by double clicking it. Drag the Imager icon to your Applications folder. Now Imager is installed. If you want, you can place the bases folder on your Desktop for a quick test. Just start Imager and leave the paths to the bases as they are. 2. INTRODUCTION Picture Selection Task: This task consist of the introduction of two characters. Next, a sentence is heard and 4 images are shown. The task is to select the image that goes with the sentence. Truth Value Task: This task consist of the introduction of two characters. Next, a picture is shown along with a spoken sentence. The task is to select whether the sentence goes with the image or not. Picture Description Task: This task consist of the introduction of two characters. Next, a picture is shown and the image should be explained. 3. WORKFLOW When you start Imager it will ask for a place where the bases are. A base is a folder containing i_maps (see 3. How to set up) for a certain task and should be referred to by an absolute path. There is no check before the testing phase for the valid structure of the bases or the paths you enter. E.g. if you want to do a Picture Selection Task with 5 tests you should create a base with 5 i_maps. When starting a Picture Selection Task or a Truth Value Task Imager will ask for a path to log the results to. These are comma separated files. You can choose to create a new file ('New File') or to append the results to an already existing csv file ('Append'). After this this the test phase starts. You go to the next test by using the appropriate buttons (see 4. Controls). After the testing phase, you have to confirm the end of the testing phase. 4. HOW TO SET UP For Imager to run you need a base with files used during testing. There are 3 bases: - Picture Selection Task base - Truth Value Task base - Picture Description Task base Picture Selection Task base: For every test you want to do in the Picture Selection Task you place a map in the Picture Selection Task base starting with i_ E.g i_bluesquare_redcircle, a good thing to do is to make the name of the i_map informative In this map there have to be 9 files with the following names: intro1.jpg: the first intro image intro1.wav: the first intro sound intro2.jpg: the second intro image intro2.wav: the second intro sound blue.jpg, orange.jpg, purple.jpg, and yellow.jpg: 4 images for the picture selection step test.wav: the test sound You can place as many i_maps in the base as desired. Truth Value Task base: For every test you want to do in the Truth Value Task you place a map in the Truth Value Task base starting with i_ In an i_map 6 files are required: intro1.jpg: the first intro image intro1.wav: the first intro sound intro2.jpg: the second intro image intro2.wav: the second intro sound pict.jpg: the test image test.wav: the test sound You can place as many i_maps in the base as desired. Picture Description Task base: For every test you want to do in the Picture Description Task you place a map in the Picture Description Task base starting with i_ In an i_map 5 files are required: intro1.jpg: the first intro image intro1.wav: the first intro sound intro2.jpg: the second intro image intro2.wav: the second intro sound pict.jpg: the test image You can place as many i_maps in the base as desired. Dimensions: Good dimensions for the images are: For the intro1.jpg and intro2.jpg: width 450 pixels -- height 600 pixels For blue.jpg, orange.jpg, purple.jpg, and yellow.jpg: width 440 pixels -- height 315 pixels For the pict.jpg: width 950 pixels -- height 650 pixels or you can use images with approximately the same aspect ratios. 5. CONTROLS During each task the controls are different: Picture Selection Task: 1: select the purple image 3: select the orange image 7: select the yellow image 9: select the blue image The frames of the images have colors. This means that you can paste colored dots on a numeric keyboard on the appropriate keys. Truth Value Task: 0: True, a 1 is logged to the csv file ,: False, a 0 is logged to the csv file Picture Description Task: 5: go to the next image For Picture Selection Task and Truth Value Task you can undo the last choice by choosing Edit > Undo. The test continues with the item you undid. Undo is only available after the introduction phase an item. You can Undo only the previous choice and not earlier choices. For the Picture Description Task there is also a button on the hidden window to go back to the previous image. You can only press a button (or Undo) after the start beep has been given. 6. LOGFILES For the Picture Selection Task: A comma separated file is created. The format is: Corrected: if the choice has been corrected with Undo this column contains an X. Item: test item name i.e. the name of the i_map with the files in Yellow, Blue, Purple, Orange: there is a 1 in the color that was chosen. The cells for the other colors are empty. DecisionTime: the seconds between the sound marking the start of the test phase and the key stroke. For Truth Value Task: Corrected: if the choice has been corrected with Undo this column contains an X. Item: test item name i.e. the name of the i_map with the files in choice: 0 for False, 1 for True DecisionTime: the seconds between the sound marking the start of the test phase and the key stroke. 7. EXAMPLES Example files are given in bases. For every task there is 1 example test (i.e. one i_map). The images contain information about what controls are available. For real testing this text should not be on them. The structure of the examples is: bases/Selection: Contains 1 i_map for a Picture Selection Task, bases/Truth: Contains 1 i_map for a Truth Value Task, and bases/Description: Contains 1 i_map for a Picture Description Task. 8. UNINSTALL Delete the Imager icon in your Applications folder. You can also delete the bases you created. 9. REMARKS The key strokes are actually captured by a hidden window behind the window that shows the images. If you happen to click somewhere such that this hidden window is deselected the keys will not respond. You will have to select the hidden window first. Selecting the hidden window can be done by pushing 'F9' or 'F10' so that you see all windows. The source code is lost (stolen actually) so bugs or improvements are not likely to get resolved. This program has been designed for and used in: A.J.J. Verbist, The acquisition of personal pronouns in cochlear-implanted children, PhD Thesis University of Leiden, The Netherlands, 2010. ISBN 978-94-6093-028-7 CLiPS - University of Antwerp Vincent Van Asch, 2007-2010