Panamath Software Manual

(Difference between revisions)
- In a non size-controlled experiment, size control is 0. The ratio of the average sizes of the dots is calculated to be (numerosity ratio)0, which means that the ratio of the average sizes of the two dot sets is 1 for any numerosity ratio. This results in total area of each color being proportional to the number of dots.\\ + [[File:Nonsizecontrolled.png]] - {{:sizecontrol0.png?600x400|}} + - ===Size-Controlled=== + ====Size-Controlled==== - ---- + In a size-controlled experiment, size control is -1. The ratio of the average sizes of the dots is (numerosity ratio)-1. With this setting, the total area that a one dot set fills will be the same as the other dot set, pixel ratio of the two colors is approximately 1:1.
- In a size-controlled experiment, size control is -1. The ratio of the average sizes of the dots is (numerosity ratio)-1. With this setting, the total area that a one dot set fills will be the same as the other dot set, pixel ratio of the two colors is approximately 1:1.\\ + In the example below, there are 5 yellow dots and 20 blue dots. The ratio of the sizes of dots is (1/4)-1 or (4/1). The yellow dots to blue dots average size ratio is 4:1.
- In the example below, there are 5 yellow dots and 20 blue dots. The ratio of the sizes of dots is (1/4)-1 or (4/1). The yellow dots to blue dots average size ratio is 4:1.\\ + [[File:Sizecontrolled.png]] - {{:sizecontrol-1.png?600x400|}} + - === Anti-Correlated=== + ==== Anti-Correlated==== - ---- + In an anti-correlated experiment, size control is -2. The ratio of the average sizes of the dots is (numerosity ratio)-2. With this setting, the total area that the dot set with less dots fills will be more than the area of the dot set with more dots.\\ In an anti-correlated experiment, size control is -2. The ratio of the average sizes of the dots is (numerosity ratio)-2. With this setting, the total area that the dot set with less dots fills will be more than the area of the dot set with more dots.\\ - In the example below, there are 5 yellow dots and 20 blue dots. The ratio of the sizes of dots is (1/4)-2 or (16/1). The yellow dots to blue dots average size ratio is 16:1.\\ + In the example below, there are 5 yellow dots and 20 blue dots. The ratio of the sizes of dots is (1/4)-2 or (16/1). The yellow dots to blue dots average size ratio is 16:1.
- {{:sizecontrol-2.png?600x400|}} + [[File:Anticorrelated.png]] + + ===Numerosity Ratio Bins=== + Numerosity Ratios are the ratio between the number of dots in one dot set and the number of dots in the other. For example, a numerosity ratio of 2 would mean that one dot set had twice the number of dots as the other dot set. Numerosity Ratio bins are a range between a maximum numerosity ratio and a minimum numerosity ratio. Each trial generated using a particular numerosity ratio bin will have a numerosity ratio selected randomly from between the range indicated in the numerosity ratio bin. + + ===Display Time=== + Display time is the amount of time that the dot sets are actually displayed on the screen. + + ===Number of Dots=== + The range for the number of dots in a dot set can be set here. The actual number of dots in each dot set will be randomly determined from within this range. + + ===Base Average Dot Size and Variation=== + The average dot diameter for a dot set can be selected, and also the maximum variation of the dot diameter. Variation determines the differences in sizes of dots in the dot set. For example, a variation of 0% will have all the dots in the dot set the same size, and equal to the average dot diameter. In general, a variation of x% will have dots that anywhere from ''x''% bigger than the average size, and as small as ''x''% smaller than the average size. + + ===Number of Practice Trials=== + There is currently no way to change this value in the GUI. There is the option in the properties file though. If you set the value for "num.practice.trials.per.bin.type" then you must also set the value for "num.trials.per.bin.type" to something that you want and set "customized = true" (this means that whatever test time you enter in the main screen will be ignored.) + + By default, there are two practice bin types (one SC and one NSC). By default, there are eight test bin types ({SC,NSC} x {4 ratios}) + + How to access a properties file on a mac: + 1) Find Panamath in the Applications folder + 2) Open the folder + 3) You'll see the Panamath application with the Panamath icon. Right click this, and select "Show Package Contents" + 4) In the window that pops up, navigate to Contents -> Resources -> config + 5) You'll see property files in that that you may have saved. At a minimum, you'll find "last_used_settings.properties" + 6) Open the properties file you'd like with TextEdit or any other Text editor. (right click the file, select "Open With" and choose TextEdit) + + How to access a properties file on a PC: + 1) Find the Panamath folder on your computer. The location may vary from PC to PC. + 2) In the Panamath folder, you'll find a config file + 3) Follow steps 5-6 above, except you may open the file with Notepad or any other similar text editor. = Basics of the Program = = Basics of the Program = -talk about basics of the actual program, including how to go between trials, how to respond, etc. very basic stuff. -talk about basics of the actual program, including how to go between trials, how to respond, etc. very basic stuff. + + + + = Data Analysis = - == Questions == + = Questions = If you have any questions on how to use Panamath, please [http://panamath.org/contact send us a message] or e-mail us directly at [mailto:panamath@panamath.org panamath@panamath.org]. If you have any questions on how to use Panamath, please [http://panamath.org/contact send us a message] or e-mail us directly at [mailto:panamath@panamath.org panamath@panamath.org].

Install Panamath

Windows Instructions

• This is a guide showing you how to install and run the Panamath software application on a Windows machine. Although I am running Windows 7 on this computer, these instructions still apply to most other Windows operating systems.
• I have just filled out the download form on the Panamath website and received the email with my download and registration information. Open up the email and click on the Panamath download link for Windows.

• Here, I will save it to my Downloads folder.

• Once you have downloaded Panamath onto your computer, locate the directory to which you have downloaded it.
• Panamath is distributed as a compressed ZIP file, but cannot be run in this format. You will need to extract the files from the ZIP file in order to run Panamath.
• Double click the downloaded ZIP file. Then click "Extract all files" in the top menu bar here. For older versions of Windows, this option should be in your left sidebar.

• Select where you want to place Panamath. The defaults are fine for me. Once it is done, a window will appear with the extracted, or uncompressed, files. You can run Panamath from these extracted files, but before we do that, to prevent confusion, let's delete the downloaded ZIP file. Close the new window and navigate back to where you downloaded Panamath and delete the ZIP file. Make sure not to delete the newly created, uncompressed files. The file type here and the icon will distinguish the two.

• Now open up your Panamath folder, and double click on the Panamath executable file.

• Find your license key from the email we sent you. For me, it is PMU000027. The key is case-sensitive. Please enter your license key into Panamath.

• If you are a researcher, please read the following dialog, and then click OK. Now Panamath should be running properly on your machine. Enter your age and a desired test time, and click "Start Experiment" to begin.

• If you have any questions or problems installing Panamath on your computer, please fill out the contact form at http://panamath.org/contact or email us at panamath@panamath.org.

Text-Only Instructions

1. Download the compressed ZIP Panamath file from the link provided in the email.
2. In Windows Explorer, navigate to the directory to which Panamath was downloaded. The directory will be something like “C:\Users\UserName\Downloads\Panamath_v1.1.zip”, where UserName is the name of the user.
3. Panamath is distributed as a compressed ZIP file, but cannot be run in this format. You will need to extract the files from the ZIP file in order to run Panamath. Double click the downloaded ZIP file. Then click "Extract all files" in the top menu bar here. For older versions of Windows, this option should be in your left sidebar.
4. This will prompt for a destination directory to which the Panamath executable will be extracted. The default is fine. Once it is done, a window will appear with the extracted, or uncompressed, files. You can run Panamath from these extracted files, but before we do that, to prevent confusion, let's delete the downloaded ZIP file. Close the new window and navigate back to where you downloaded Panamath and delete the ZIP file. Make sure not to delete the newly created, uncompressed files. The file type here and the icon will distinguish the two.
5. Now open up your Panamath folder, and double click on the Panamath executable file. This will prompt for the license key from the email we sent you. For me, it is PMU000027. The key is case-sensitive. Please enter your license key into Panamath.
6. If you are a researcher, please read the following dialog, and then click OK. Now Panamath should be running properly on your machine. Enter your age and a desired test time, and click "Start Experiment" to begin.

Mac Instructions

• Download the Panamath package from the email.
• Navigate to the directory with the Panamath_v1.1.pkg.zip file. If you can't find it use the search tool.
• Double-click the Panamath_v1.1.pkg.zip file.
• A new Panamath_v1.1 executable should have been created. Double-click this.
• You should see the following:

• Click “Continue”.

• Click “Continue”.

• If you wish to install in another directory, click “Change Install Location” and select the location.
• Then click “Install”.
• The installer may prompt for your username and password. These are the same that you use to log in to your computer. Please provide these, and the installer will proceed to installation. You will know Panamath has been installed successfully by the green checkmark.

Subject ID

The Subject ID, which can be set in the Advanced Settings: General panel, gives panamath a unique identifier for each person who takes the test. Having a Subject ID is required if results from Panamath are saved, since the results files are saved with the subject id in the name of the files.

Age

Entering the correct age of the participant is important, since the ratio bins are calculated based on the age that is entered, and will change the difficulty of the test. Also, entering an age of 7 or younger will by default display Sesame Street Characters and Window Rectangles on the screen during the test.

How Ratio Bins Are Calculated From Age And Difficulty

If the user has not entered customized settings under Advanced Options on the main panel then the program will generate appropriate settings for numerosity ratio and display time. It does this by taking the users age and selected difficulty, adjusting the age based on the difficulty, then finding appropriate values for numerosity ratio and display time using this adjusted age. The following sections show exactly how adjusted age, numerosity ratio, and display time are calculated.

• Very Easy Difficulty
• If user's age is between 0 and 20, then the formula .5 * age is used. If the user is between 20 and 40, then 3/20 * age + 7 is used. Otherwise, an adjusted age of 13 is used. In all subsequent algorithms, this adjusted age is used instead of the real age. This casuses the numerosity ratio and display time to scale with age and difficulty.

• Easy Difficulty
• If user's age is between 0 and 20, then the formula 3/5 * age is used. If the user is between 20 and 40, then 3/20 * age + 9 is used. Otherwise, an adjusted age of 15 is used.

• Medium Difficulty
• On medium difficulty, the user's real age is used in all calculations. This means that a 20 year old will have an adjusted age of 20, a 40 year old will have an adjusted age of 40, etc.

• Hard Difficulty
• On hard difficulty, the adjusted age is given by the formula 4.116713430316e-01 + 1.111762903248e+00 * actualAge + 9.684975424473e-03 * actualAge^2. Note that at this difficulty, this formula is always used, unlike for very easy and easy difficulty, in which after 40 the same value is used.

• Very Hard Difficulty
• On very had difficulty, the adjusted age is given by the formula 4.755221349509e-01 + 1.477883254935e+00 * actualAge+ 1.382024390740e-02 * actualAge^2. This formula is used for all input ages.

Numerosity Ratio

Once the adjusted age has been calculated by the above formulas, it is run through a function to determine appropriate numerosity ratios based on the adjusted age and the difficulty. When calculating the numerosity ratios, the weber fraction is used. The [Fraction] is the amount of change in a stimulus relative to the background "noise" in the stimulus. The important thing about the weber fraction is that it is roughly constant for a certain stimulus. In vision lab experiments, the weber fraction for panamath experiments is approximately weberFraction = adjustedAge ^ -.55. This value is used to calculate scaled values for numerosity ratio according to the following rules:

• If the adjusted age is less than 40 or is on very hard or hard difficulty, then the following four values are used as the numerosity ratios.
• (.75*w) + 1
• (1.25*w) + 1
• (2*w) + 1
• 2*(w + 1)
• If the adjusted age is greater than 40 and the user is on very easy, easy, or medium difficulty, then the following values are used for numerosity ratio, based on difficulty.
• Very Easy Difficulty
• 1.5
• 1.8
• 2.8
• 4.0
• Easy Difficulty
• 1.4
• 1.5
• 2.5
• 3.5
• Medium Difficulty
• 1.2
• 1.3
• 1.8
• 3.0

Display Time

Display time is the simplest to calculate. It is based only on adjusted age, and is calculated according to the following rules:

• If the user's adjusted age is between 0 and 20, it is calculated according to the formula 3.23713 * e^(-0.0892973 * adjustedAge) + 0.0573327.
• If adjusted age is between 20 and 40, a display time of .6 seconds is used
• If adjusted age is between 40 and 70, display time is calculated according to the formula 0.0467 * adjustedAge - 1.2667
• If adjusted age is greater than 70, then display time is set to 2 seconds

Panamath can be fully customized using the Advanced Settings panel, which can be accessed by clicking "Set Advanced Options" at the bottom of the first screen that appears when Panamath is run.

The Advanced Settings panel is divided into six sections: General, Display, Kids Characters, Dot Colors, Response Keys, and Customize. Navigate between these sections by clicking on the section name on the left side of the panel (under the panamath logo). For each section, there is a "Restore Defaults" button. Clicking on this button resets all settings to defaults on that section only.

General Settings

• Difficulty
• There are five levels of difficulty on Panamath {Very Easy, Easy, Medium, Hard, Very Hard}.
• Sound Feedback
• Choice for sound feedback are {Beep, Voice, None}.
• Sound feedback is the sound that is heard after each response during the test.
• The Beep setting and Voice setting both indicate to the participant whether or not the response was correct.
• Skip Instructions
• Selecting this check box skips the instructions screen that appears immediately after clicking "Start Experiment."
• Save Results
• Check this box to indicate whether or not the results of the test should be saved.
• If saving is selected, the Subject ID and the location of the results files (.xls and PDF) can be selected by editing the appropriate fields.

Display

• Between trials show:
• There are three options {Fixation cross, Number of trials remaining, Nothing}
• Fixation cross displays a cross in the center of the screen between trials.
• Number of trials remaining displays the number of remaining trials in the test between trials.
• Nothing displays a blank screen between trials.
• Show Dot Window Rectangles:
• If this option is selected, outlines of the window in which the dot sets will appear will be displayed on the screen during the test.
• Show instructions text during test
• If this option is selected, instructions will be displayed onscreen during the test. (i.e. "Press space to continue" will be displayed between trials)
• Show Progress bar during test
• If this option is selected, then a progress bar will be shown on the bottom left of the screen during the test, indicating how much of the test has been completed.
• Show Backward Mask
• If this option is selected, a mask of random dots of both colors will appear after the dots are displayed for each trial.
• The display time of the mask can be selected (in milliseconds).
• The mask can be either {Colored pixel noise, overlapping dots}
• Enable Passive Viewing of test
• If this option is selected, the test will not require any response or input before proceeding to the next trial.
• Automatically start next trial
• If this option is selected, the test will automatically proceed to the next trial after the amount of time indicated in the interstimulus interval field.
• Show Kid-Friendly ending screen
• If this option is selected, after all the trials are run, a colorful screen indicating the end of the test will be displayedd.
• Show ending screen with performance stats
• If this option is selected, after all the trials (and the kid-friendly screen, if that is selected), a graph summarizing the test with performance stats will be displayed.
• Set random seed as:
• This option allows for selection of the random seed used in the random object to set up the experiment.

Kids Characters

• In the kids characters section, there is the option to turn on/off the display of Sesame Street characters on the screen during the test.
• (By default, this setting enabled for participants who have entered an age of 7 or younger)
• This panel also allows for the selection of 2 Sesame Street Characters, one to represent each dot set, from 15 available characters.
• To select a character for dot set 1, select the button next to the character on the left side.
• Similarly, for dot set 2, select the character on the right side.
• Characters selected for dot set 1 and dots set 2 must be different.
• (By default, Big Bird is selected for dot set 1 and Grover is selected for dot set 2.)

Dot Colors

In the dot colors section, the colors for the dot set 1, dot set 2, and the background can be changed by clicking on the colored rectangle, and then selecting the desired color.

Response Keys

In the response keys section, the keys used to respond to either dot set, and also to advance to the next trial can be customized. To select a new key, click on the rectangle displaying the current key, and then press the new key that will be used.

Customize

In the Advanced Settings Customize panel, the following parameters: dots window size and separation,size control, numerosity ratio, display time, number of dots, base dot size and average variation can be changed.

To use Customized settings, expand/hide each of the 7 sections by clicking on the name of the setting. Change the values by moving the sliders to the desired value, and then clicking "add" to add the setting to the table. To remove a setting, click the "delete" button. The number of total unique combinations based on the settings in the tables will be calculated and displayed at the bottom of the panel. Determine the number of times each of the combinations will be displayed to obtain the desired number of total trials/time, and then click "Generate Trials & Close Settings" to save the settings. If "Generate Trials" is not clicked, then the custom settings will not be used for the test.

Each of these settings are explained in detail in the following sections.

Dots Window Size and Separation

Window size is set as a percentage of the screen, and can be set using the slider. Window separation is how far apart the two dot set windows are placed. Window separation can range from as far apart from each other as possible, on either side of the screen, at 100%, to overlapping, at -100%.

How Size Controlling Works

Size control changes the average size of the dots in relation to the number of dots of each color.

Without size control, it would be possible to get most of the trials correct by simply noting which color fills up more area on the screen. A size control of 0, Non Size-Controlled, creates dots with the same average size for both sets of dots, while a negative size control creates smaller dots for the set with more dots, and a positive size control creates larger dots for the set with more dots.

A size control of -1,Size-Controlled, changes the average size of each dot set so that the area of the screen filled by each dot set is approximately equal.

If all the trials in a test used the same size control, it would be possible to get most of the trials correct by paying attention to either the average sizes of the dots or the area of the screen filled with each color. By using a combination of different size controls, we can ensure that the area and size of the dots will not reveal the correct answer. The size control number, which can be adjusted from -3 to 1 in the customize panel of the advanced settings panel, is the exponent to which the ratio of the number of dots is raised to obtain the ratio of the average sizes of dots.

Non Size-Controlled

In a non size-controlled experiment, size control is 0. The ratio of the average sizes of the dots is calculated to be (numerosity ratio)0, which means that the ratio of the average sizes of the two dot sets is 1 for any numerosity ratio. This results in total area of each color being proportional to the number of dots.

Size-Controlled

In a size-controlled experiment, size control is -1. The ratio of the average sizes of the dots is (numerosity ratio)-1. With this setting, the total area that a one dot set fills will be the same as the other dot set, pixel ratio of the two colors is approximately 1:1.
In the example below, there are 5 yellow dots and 20 blue dots. The ratio of the sizes of dots is (1/4)-1 or (4/1). The yellow dots to blue dots average size ratio is 4:1.

Anti-Correlated

In an anti-correlated experiment, size control is -2. The ratio of the average sizes of the dots is (numerosity ratio)-2. With this setting, the total area that the dot set with less dots fills will be more than the area of the dot set with more dots.\\ In the example below, there are 5 yellow dots and 20 blue dots. The ratio of the sizes of dots is (1/4)-2 or (16/1). The yellow dots to blue dots average size ratio is 16:1.

Numerosity Ratio Bins

Numerosity Ratios are the ratio between the number of dots in one dot set and the number of dots in the other. For example, a numerosity ratio of 2 would mean that one dot set had twice the number of dots as the other dot set. Numerosity Ratio bins are a range between a maximum numerosity ratio and a minimum numerosity ratio. Each trial generated using a particular numerosity ratio bin will have a numerosity ratio selected randomly from between the range indicated in the numerosity ratio bin.

Display Time

Display time is the amount of time that the dot sets are actually displayed on the screen.

Number of Dots

The range for the number of dots in a dot set can be set here. The actual number of dots in each dot set will be randomly determined from within this range.

Base Average Dot Size and Variation

The average dot diameter for a dot set can be selected, and also the maximum variation of the dot diameter. Variation determines the differences in sizes of dots in the dot set. For example, a variation of 0% will have all the dots in the dot set the same size, and equal to the average dot diameter. In general, a variation of x% will have dots that anywhere from x% bigger than the average size, and as small as x% smaller than the average size.

Number of Practice Trials

There is currently no way to change this value in the GUI. There is the option in the properties file though. If you set the value for "num.practice.trials.per.bin.type" then you must also set the value for "num.trials.per.bin.type" to something that you want and set "customized = true" (this means that whatever test time you enter in the main screen will be ignored.)

By default, there are two practice bin types (one SC and one NSC). By default, there are eight test bin types ({SC,NSC} x {4 ratios})

How to access a properties file on a mac: 1) Find Panamath in the Applications folder 2) Open the folder 3) You'll see the Panamath application with the Panamath icon. Right click this, and select "Show Package Contents" 4) In the window that pops up, navigate to Contents -> Resources -> config 5) You'll see property files in that that you may have saved. At a minimum, you'll find "last_used_settings.properties" 6) Open the properties file you'd like with TextEdit or any other Text editor. (right click the file, select "Open With" and choose TextEdit)

How to access a properties file on a PC: 1) Find the Panamath folder on your computer. The location may vary from PC to PC. 2) In the Panamath folder, you'll find a config file 3) Follow steps 5-6 above, except you may open the file with Notepad or any other similar text editor.

Basics of the Program

-talk about basics of the actual program, including how to go between trials, how to respond, etc. very basic stuff.

Questions

If you have any questions on how to use Panamath, please send us a message or e-mail us directly at panamath@panamath.org.