Dr. Lasse Cronqvist
Email: cronqvist@uni-trier.deTosmana
Version 1.52

User Manual
Release: September 27th 2016
If you use Tosmana please cite:Cronqvist,Lasse.

2016.

Tosmana<http://www.tosmana.net>

1[Version1.52].

Univ.

ofTrier.

Content
1. Introduction........................................................................................................................ 3
2. Using Tosmana................................................................................................................. 4
3. Constructing your data set .............................................................................................. 4
Loading and Importing Data............................................................................................... 4
Creating and saving files .................................................................................................... 5
Editing the data set .............................................................................................................. 5Adding and editing variables .............................................................................................. 5
Transforming Scale Data .................................................................................................... 7
Recode Conditions .............................................................................................................. 8
4. Data Analysis: csQCA and mvQCA .............................................................................. 9
The Tosmana Report ........................................................................................................ 11
5. The Visualizer ................................................................................................................. 12
6. The Boolean Calculator ................................................................................................. 13
7. Data Analysis: fsQCA .................................................................................................... 14The XY Plot window .......................................................................................................... 158. About the software ......................................................................................................... 16
Citing, Technical and contact information: .......................................................................... 162

1. Introduction
This manual contains a short introduction to the Tosmana software. Although
this manual describes the basic features of QCA - the main method
implemented in Tosmana -this is not a general introduction to the method.
Please refer to the Getting Started with TOSMANA guide found on the website
if you wish a short introduction to the main features of the software.
Currently, TOSMANA supports crisp-set QCA (csQCA) as first introduced
Charles Ragin with his book “The Comparative Method”1 and multi-value QCA(mvQCA). From Version 1.5., fuzzy-set QCA (fsQCA) is included with Tosmana
as well.
Tosmana is work in progress and currently a sideline product of my work.
Therefore, check all calculations performed with the software with othersoftware packages prior to publication. You can find an overview of available
software for QCA analysis on the Website of the Compasss group in thesoftware section (http://www.compasss.org).
With the release of version 1.4., the development of Tosmana resumed after anumber of years without work on the programme. Some few features wereadded, but the main changes from version 1.3 to 1.4 did consist in a clearingout of legacy issues in the software and general clean-up of code. Version 1.4
replaced the main window and redesigned the handling of data, allowing thedirect import from a spreadsheet without the need to save the data. Version 1.5
introduces fsQCA to Tosmana.

1

Ragin, C. C. (1987) The Comparative Method. Moving Beyond Qualitative and Quantitative Strategies,University of California Press, Berkeley.

32. Using Tosmana
Tosmana comes as a ZIP-file. Simply extract the zip-file and run the file named
tosmana.exe.
Please only download the file from the website (http://www.tosmana.net) andcheck the checksum to avoid a faulty download.

3. Constructing your data set
After the start of the software, the main window shows up, in which data files
are created, loaded and saved, and from where the calculation window iscalled.

Loading and Importing Data
Loading a file into Tosmana
Load a file created (and saved) by Tosmana by selecting File > Open from themenu bar in the main window. Please note that only files created with Tosmana
and saved in the XML (extended mark-up language) file format can be loadedwith the Open item. If you have saved files with the extension tosmana in earlier
versions of the software, you can still open them with the current software
version.
Importing from Spreadsheet programmes
The easiest way to include data in Tosmana is to copy data directly from a
spreadsheet programme. By selecting File > Import from Clipboard data can bedirectly pasted from a spreadsheet programme without the need of saving thedata to a file.
In Tosmana, one variable always has to be included which can be used as
Case-ID for your data set.
The first row must contain the variable names. To import the data, simply selectthe data to be used and copy it (to the clipboard). Then, in Tosmana, select File
> Import from Clipboard.
In a first step, you should save the data as a Tosmana XML-file (File > Saveas). The import features tries to identify the type of variables imported. If metric4

data is included, you have to set thresholds before you can perform an QCA
analysis. Please refer to the section on variable transformation for furtherinformation.

Creating and saving files
By selecting File > New a new Tosmana data set will be created. You can add
variables to the data set by selecting Dataset > Enter new Variable from themenu bar. As soon as all variables are added, you can add the cases of thedata set simply by entering them in the data matrix of the main window. To
change the Variable name you have to enter the variable edit window described
below.
Selecting File > Save in the main menu bar saves the data set. If you wish touse your data set in other applications (Excel or fs/qca) you may also save thefile as a csv or dat file (choose Export). TOSMANA save the file in XML format.

Editing the data set
You might change the content of the data matrix at any time by changing thedata in the main window. Please note that you have to re-open the mvQCA
calculation window to use the new data in your calculation. If you want to add anew row (case), just enter the data in the last row of the data set. If you wish todelete a case, click on the row header of the case you wish to delete and press
the delete button on your keyboard.

Adding and editing variables
To add a new variable please select Dataset > Enter new variable. Edit thename of the new variable and press ok. The new variable will then appear in thedata set.
If you wish to change the attributes of an existing variable, please click on thecolumn header and select edit condition.


To change the name of the variable click on the button labelled change name andenter the new variable name.
To remove a variable entirely, select the variable name in the Variable Settings
window and press the button labelled remove.
You may add a description to a variable in the description field.
5Replacing multiple data entries
If you wish to replace multiple data cell entries with the same value, you may doso using the replace function (select Edit > Replace). Define the search value
and the new value to replace it and select all variable where this replacement isdone. Press ok and the replacement will take place.
Variable transformation
The menu item Transformation in the Variable Settings Window defines how toconvert the raw data to data used by mvQCA. There are four different options,which can be set for each variable:

use original values (1:1): Using this option indicates that the raw data is used as itis with mvQCA. Please note that all data must be of numerical type and thatmissing data always has to be noted with an '-'. Variables containing the name of
the cases should be changed to use as case ID. If this is not the case Tosmana
will produce errors.
no Transformation possible: If this option is set, the variable can not betransformed and it can not be used with the software. The sense of this is toexclude variables which can not be translated by the standard rules yet but which
may be used in future (like calendar dates etc.)
use as case ID: If this variable is set, the variable can only be used as case ID.
use Thresholds: If this variable is set, you can use the threshold setter described
below to set the thresholds dynamically while working with TOSMANA. Please
note that all data must be of numerical type and that missing data always has tobe noted with a '-'.

6Transforming Scale Data
To transform scale data to stepped conditions suitable for mvQCA analysis,thresholds must be set to recode the data. TOSMANA provides two ways to doso: Thresholds can be set directly by hand or thresholds can be set interactively
by using the 'Thresholdssetter'.
To set the thresholds directly, choose Edit > Variable Settings from the menu
bar and select the condition to set the thresholds (double click the row header).
If the option “use thresholds” is selected as transformation mode, the button edit
can be pressed. The thresholds are entered by using '.' (dot) to separatedecimals and ';' to separate multiple thresholds.
Using the "Thresholdsetter" Window
If one or more Variables do contain metric scaled data, the data must betransformed to an ordinal scale before it can be used with cs- or mvQCA. To dothis, the variable must be set to be transformed with threshold(s) in the Variable
Settings window (set the Transformation item to use Thresholds). Then theThreshold Settings Window can be opened with Tools > Thresholdsetter in themain window.

7

In the central panel the distribution of data is shown. Each orange box
represents one case. The green lines represent the current thresholds. Thevalues of the thresholds are noted above the threshold line if the option is set(lower left corner, show threshold values). The number of decimals shown canalso be set (4). The thick red line is the median (the line can be toggled on / offwith the option in the lower left corner (3)). The name of the variable edited isshown in the upper left corner of the window (1).
The number of thresholds used with the variable can be selected with thedropdown list in the upper right corner (2).
To move a threshold simply place the mouse on the wanted threshold (themouse pointer will change) and press the left mouse button. The move the lineby moving the mouse (still pressing the left button) and release the mousebutton with the value wished.

Recode Conditions
To recode a condition into a new condition, select Tools > Recode Condition
from the menu bar. Select the condition to be recoded and check the proposedname of the new condition. By selecting the “old” values found in the left box,
these might either be used unchanged in the new condition (“1:1” button) orassigned new values (enter the new value in the text field under the Convert tobutton and press this button.

84. Data Analysis: csQCA and mvQCA
One of the main goals of Tosmana is to perform minimization on Boolean andon Multi-Value Data sets. This is done from the analysis window (named(mv)QCA). Call the analysis window from the menu bar: Tools > Start (mv)QCA
or by pressing F9.

Selecting variables for analysis
Before the calculation can be done, the variables for the analysis have to bechosen (1). Use the arrow buttons to select the outcome and the conditions.
Please note that the use of a case descriptor is necessary in Tosmana. Variablevalues have to be of the type {0,1} for Boolean analysis and {0,..,n} for multivalue analysis. If you choose a variable with non-numerical data as outcome orcondition, an error window will show up.

9Visualizing your data
Up to five conditions can be displayed in a graph by pressing the visualize
button (2). See the chapter on the Visualizer below for details.
Calculation configuration
The configuration of the calculation can be set in the right half of the (mv)QCAwindow (3). The configuration labels are to be understood as follows:

Explain: Those outcomes which are explained by the solution.
Include for reduction: Outcomes allowed to be included in the reduction of theimplicants as logical remainders (“don’t cares”).
Exclude: Outcomes, which are excluded from minimization.

Regularly, Tosmana shows the expressions in the solution with set notation. Ifthe option Use upper-/lowercase notation is checked, the notation found in thediscussions of QCA by Charles Ragin is used.
If you wish to see the used simplifying assumptions, enable the computesimplifying assumptions checkbox. With a large number of conditions thisfeature can be time demanding.
Starting the calculation
Start the calculation with the Full Analysis button (4). If the output mode is set
to “text only”, the results will be shown in the results window (see below). Else,the result report will appear in a new window of the Internet Explorer. If you only
want to see the QCA results, these can be quickly derived by pressing the justresults button (5).
Only Show Implicants
To only get a list of the prime implicants press the show implicants (6) button. In
the prime implicant window coming up you can then see the prime implicants foryour selection of conditions and settings. You may filter the list by cases. With aclick on a prime implicant in the list the cases implied by this implicant areshown.

10The Tosmana Report
When the calculation is finished, the result report opens in the Tosmana result
window or, if selected, in the standard web browser.
You will find the settings of the calculation and (if selected) the data matrix firstin the report. At the end, the solution and (if the option is set) the simplifying
assumptions are reported. Tosmana can either use upper-/lowercase notation
to display the results or use strict set notation. As Tosmana also allows morethan two possible values for each condition, the upper-/lowercase solution canonly be used to display strictly dichotomous data sets.
Copy any parts of the report to the clipboard by clicking the right mouse buttonand selecting copy in the popup-menu.
In addition, you can directly add solutions to the Boolean Calculator byhighlighting the solution and selecting Add to Boolean Calculator from thecontext menu pressing the right mouse button.2

2
Currently this only works with dichotomous data sets. The use of set notation in the report isrequired (unselect the Use Uppercase / Lowercase notation option in the mvQCA window.

115. The Visualizer
Tosmana allows the user to display a Boolean data set with up to fiveindependent conditions to be displayed graphically. To do this, select theconditions in the mv(QCA) window and press the visualize button.
Please note that at the recent stage it is only possible to save the created graphas a bitmap file, which is rather large, but this can be edited and compressed inalmost every graphic application.
In the Visualizer, you can toggle between Colour and Black/White display andselect which information is shown. You might also highlight or prime implicantssolutions of your choice.

12

6. The Boolean Calculator
The Boolean Calculator allows simple calculation on Boolean Expressions likeintersections and complements. To perform such a calculation, the Boolean
Expressions have to be entered into the calculator. This is done in prefix
notation just like using a standard pocket calculator: First the single expressions
are entered which then are connected by + and *. When the logical expression
is entered, it can be added to the lower calculation box by pressing the “add”
button. An intersection of two logical expressions is calculated by selecting thetwo expressions from the expression list (using the shift key to select multipleentries) and then pressing the “computer intersection” button. The complementof a logical expression can be calculated by selecting the expression from thelist and pressing the “compute complement” button.
Logical expressions can be directly added from the TOSMANA report byhighlighting the solution and selecting Add to Boolean Calculator from thecontext menu pressing the right mouse button.

13

7. Data Analysis: fsQCA
From version 1.5, TOSMANA also enables users to perform standard fsQCA
calculations. Please press F10 or select Analysis > Start fsQCA from the menu
bar and the fsQCA window appears. Similarly to the cs- and mvQCA analysis,
the variables for the analysis have to be chosen (1) and the outcome value tobe specified has be selected (2).

In a first step then, the software allows to check for necessary conditions (3). Inaddition, the fsQCA truthtable with consistency values can be calculated (4). To
perform a full fsQCA analysis, please define the consistency cut-off (6) and thefrequency threshold (5) press the full analysis (9) button. A number of further
option can be set as with the csQCA analysis described above.

14

The XY Plot window
In addition to the analysis of consistency addressed above, TOSMANA also
allows to study fuzzy set relations. To do so, please open the XY Plot from themain window (Analysis – XY Plot, or F8). One or multiple variables can be
included on each axis (1) – select multiple variable by keeping ctrl pressed
while selecting. Press the create plot button (2) to draw the XY Plot. In addition,
the software calculates the consistency and the coverage values for the fuzzy
set relation (X  Y).

Single points in the plot show the individual cases. Cases sharing the samevalues are combined to a single, larger point. Hover the mouse over a point tosee the case ID and the values of the case(s). To show all data, deselect thecheckbox hide labels (3). Save the shown plot as an image by pressing saveplot as image (4).

15

8. About the software
Tosmana is freeware and it comes as it is: There is no guarantee forcorrectness of any part of the results provided by the program.
Tosmana is work in progress and currently a sideline product of my work.
Therefore, all calculations performed with the software should be checkedwith other software packages prior to publication. An overview ofavailable software for QCA analysis can be found on the Website of theCompasss group in the software section (http://www.compasss.org).

Citing, Technical and contact information:
If you use Tosmana please cite like this:Cronqvist,Lasse.

2016.

Tosmana[Version1.52].

Univ.

ofTrier.

<http://www.tosmana.net>
Please do also notice the following descriptions for a quick start withTOSMANA:
Cronqvist, Lasse. 2016: Getting started with TOSMANA. Univ. of Trier.
<http://www.tosmana.net>

Version of Tosmana covered by this manual:

1.52

Date of Software Release:

October 1st 2016

Tosmana is developed by:

Lasse Cronqvist

Email:

cronqvist@uni-trier.de

Postal address:

Universität Trier
FB III / Politikwissenschaft
54286 Trier
Germany16