5 Quick tour of the app
The app has two parts, the left-hand side and the right-hand side.
You can get help at any time by clicking on the little blue info buttons, like below. This will then open a panel displaying the relevant section of this guide.
image-20210927115203506
5.1 The left-hand side
5.1.1 Getting data into the app
- Create a new file
- and then upload a map in the form of an Excel file (.xls or .xlsx).
- Or, in the file chooser, select any files to which you have access, which include an anonymised dataset from a QuIP study.
5.1.2 Commands and buttons to apply filters to your map
The left-hand side of the app really only contains the text in the Advanced Editor (which you can view if you want, but close the window if it scares you).
advanced-editor
The text window uses a simple syntax for filtering and manipulating the maps and tables.
Nearly all the other buttons on the left-hand side are just ways to manipulate this text. Each line in this window is a filter which manipulates the existing map in some way. The lines in the windows are applied successively to the original map to produce the final map which is then displayed.
5.1.3 Do some coding (view one statement) or do some analysis (view many statements)?
#statement-toggle
These buttons add the correct filters to either view just one statement or many statements.
When you are coding, you will want to view just one statement, and when you want to explore and analyse the entire causal map or sections of it, you will want to view many statements.
(Even when you are viewing one statement, it is still possible to apply filters for example if the map associated with this one statement is quite large.)
5.1.4 Top row
Most people like to hide these filters when they are coding, so they hide the filters using the toggle.
image-20210914103505559
But for analysing your map, you will want to open the filters panel.
5.1.6 The filter buttons
They are in three sections: analysis, conditional formats and simple formats. See the section on filters.
To see additional information about the statement you are currently viewing such as the source_id and question_id slide the info toggle.
5.2 The right hand side
image-20210914103654314
5.2.1 Interactive View
An interactive version of the map in which the elements can be moved around and also the upstream and downstream factors are highlighted when the user moves their mouse over them.
The Interactive View is designed to let you interact with and explore your map, whereas the main point of Print View is to get something high quality and static for including in reports.
5.2.3 Factor editor
Simply click on the factor you want to change and edit it. You can change one factor everywhere in the file or you can do it for each statement, by pressing the Split checkbox. Just remember to press update once you have made your changes and you are happy with them.
5.2.4 Tables
Several tables showing lists of factors, links and various metrics and which can be filtered and reorganised in marvellous ways. See the section on tables.