Hi, and welcome to the JASP User Guide!
JASP is available for:
- Microsoft Windows
- Mac OS X
- Linux
JASP installs under Windows like any normal application, and can be downloaded from the JASP download page, here: https://jasp-stats.org/download
JASP is available for Mac OS X, version 10.8 (Mountain Lion) and above (Which version do I have?).
JASP for OS X can be downloaded from the JASP download page, here: https://jasp-stats.org/download
JASP for OS X currently depends on XQuartz. This should be installed before commencing installation of JASP.
JASP is installed by downloading and double clicking the .dmg file, and dragging the JASP icon to the Applications folder. This places JASP in your applications folder.
OS X actively discourages people from downloading software from the internet (rather wanting to channel people through their app store), so there will likely be some additional steps to make JASP run.
Newer versions of OS X need to have their "Gatekeeper" options relaxed, before they will allow software to be used that was downloaded from the internet. More Info: About Gatekeeper.
You will need to change your Gatekeeper settings to "Allow applications downloaded from anywhere".
Having relaxed the Gatekeeper settings, the next step is to 'right click' or 'control-click' JASP in your Applications directory, and select 'Open' from the menu. This will present a window saying that JASP is from an unidentified developer; selecting "Open" will start JASP.
From then on, you will be able to start JASP in the usual way.
JASP is available for the Linux versions:
- Ubuntu Vivid (15.04)
- Ubuntu Trusty (14.04 LTS)
- Arch Linux
The current JASP beta (0.7.5) is available for Ubuntu Wily
JASP for Vivid, Trusty and Wily are available from Jonathon's Personal Package Archive (PPA). Once the PPA is added to your system, you will be able to install JASP, and JASP will be automatically kept up-to-date by Ubuntu.
The PPA and JASP can be installed by issuing the following commands at the terminal:
sudo add-apt-repository ppa:jonathon-love/jasp
sudo apt-get update
sudo apt-get install jasp
JASP is made generously available for Arch Linux by Stephen Martin, and can be installed with the following commands:
git clone https://aur.archlinux.org/jasp-desktop-git.git
cd jasp-desktop-git
makepkg -si
JASP comes with a handful of example data sets, which can be accessed from the 'File tab'. Selecting these will load up the data, allowing you to inspect and analyse it.
JASP can also open data sets in the .csv (comma separated volume) data format. In practice, .csv files are often delimitered with a range of different characters and not just commas. When opening a .csv file, JASP examines the file, and automatically determines what the delimiters are. This usually means that JASP can open any .csv file without intervention from the user. The only absolute requirement, is that the .csv file contains a header row; where the names of each of the columns appear in the first row.
If you find a .csv file that JASP opens incorrectly, you can submit this to the JASP team, and they can look at improving the .csv handling heuristics. It would be worth checking if the .csv file is reasonable, and whether other software is able to open it correctly.
When opening a .csv file, JASP makes a "best guess" to assign variable types. More details below.
In JASP there are 4 variable types:
- Nominal Text
- Nominal
- Ordinal
- Continuous
Nominal Text variables are categorical variables with no order, and with no meaningful numeric value. An example might be a variable called Gender, with two levels; Male and Female.
Nominal variables are categorical variables with no order, however they do have meaningful numeric values. An example might be a variable called Group with levels 1 and 2.
Ordinal variables are categorical variables with a numeric value, and an inherent order. An example might be Time point with levels 1, 2, 3, 4, and 5.
Continuous variables are variables with values which exist on a continuum, such as Height or Weight.
Some users prefer not to have to specify the variable types (which can be arduous, particularly for data sets with many columns), and so the variable types in JASP are generally not enforced. They usually serve only as guides; you can, for example, assign a nominal variable as a dependent variable in a t-test. In this situation, the variable is treated as a continuous variable. (It should be noted that this is the same behaviour as SPSS)
When loading a .csv file, JASP automatically assigns variable types according to the following rules:
- If the variable contains only integer values and missing values, and contains less than 25 unique values, then it is assigned a variable type of Nominal.
- If the variable contains only integer values, floating point numbers, missing values, and +/- infinities, then it is assigned a type of Continuous.
- Otherwise the variable is assigned a type of Nominal Text.
It should be noted that a value of NA is considered a text value in JASP, the same as in almost all statistical environments. However this occasionally trips up R users.
Should these automatic assignments be incorrect for your particular dataset, it is possible to override these values. If you click the icon representing the variable type at the top of the column, a menu is produced allowing you to choose a different variable type.
Values are changed to the new data type, and any incompatibilities are converted to missing values. But be careful! JASP at present does not implement an undo, so if you change a Nominal Text column full of text values to Nominal or Continuous, it will convert the entire column to missing values. At present, there is no way to undo this and it will be necessary to reload the data set.
Having loaded a dataset, it is now possible to run analyses. Selecting an analysis from the Ribbon along the top, shows options for that analysis in the left panel, and results in the right panel. As the options are specified, the analysis results automatically update, providing immediate feedback.
When the analysis is specified the way you like, you can return to the data view by clicking the "OK" button. This dismisses the analysis options, and unselects the current analysis.
A user wishing to return to an earlier analysis, can simply select it by clicking on it. This brings up the options that were used to generate that analysis, and allows the user to make additional changes.