Differences

This shows you the differences between two versions of the page.

--- neuroelf_gui_-_mkda_ui [2011/12/08 22:27] – created jochen
+++ neuroelf_gui_-_mkda_ui [2011/12/08 22:56] (current) – saved jochen
@@ Line 9: / Line 9: @@
 ===== GUI layout =====
 The MKDA UI is available via the ''Meta Analysis'' entry of the [[NeuroElf GUI - menu tree#analysis_menu|Analysis menu]]. When called, the following dialog pops up:
+{{:neuroelf_gui:plp_mkda_ui.png|Multi-level Kernel Density Analysis (MKDA) dialog}}
+===== Controls =====
+The following controls are available:
+  * PLP selector (dropdown): if more than one [[xff - PLP format|PLP object]] is loaded, you can switch between those (e.g. in case you have several revisions of the same database)
+  * Study selection (listbox): by (de-) selecting studies, you can re-run the same analyses discarding points from some studies without having to create several versions of the database
+  * Column selection (listbox): the selection of columns will alter the output of the listed points (listbox, see below)
+  * Analyses (dropdown): this control stores all configured analyses, which allows to easily define several contrasts and/or settings without having to create separate database files (PLP objects)
+    * Adding a new analysis (+ button): upon clicking this button, NeuroElf asks for an analysis name, and then duplicates the currently configured settings and makes them available for further editing
+    * Removing the current analysis (- button): if several analyses are configured, using this button allows to delete one of them (e.g. for contrasts/configurations that yielded inconclusive results)
+    * Renaming the current analysis: clicking this button will ask for a new name for the currently selected analysis
+  * Contrast (edit field): you can use this field to enter a contrast made up of the contrast terms that are listed automatically when selecting a column name containing contrast particles; a differential contrast can be entered using the greater than (>) sign between particles (e.g. ''item1 + item2 > item3 + item4'')
+  * Contrast column (dropdown): use this control to select from which column in the database the contrast particles are selected (**if you wish to combine several factors for contrasts, you MUST configure them in a compound column while creating the database file!**); upon selection, the contrast edit field will be set to a list of all unique terms found in this column
+  * Condition particles (listbox): this is a text-based representation of the conditions which are used to sub-select coordinates from the database for each configured analysis; just as with Matlab expressions, conditions can be made up of several conditional statements (particles) conjoined with either AND or OR operators and evaluated in any desired precedence using parentheses around sets of particles; to configure the condition particles use the subsequent controls!
+    * Adding a condition particle (+ button): use this button to add the condition as configured on the right side of the button to the list of particles; if any particles are already in the list, the operator is placed **in front** of the newly added particle
+    * Setting the current particle (arrow button):
+===== Usage notes =====
+The following steps should be performed for any analysis:
+  * loading or importing a PLP object
+    * if you have already imported a PLP at a previous session, use the ''Load PLP'' entry from the File menu
+    * otherwise using the ''Import PLP'' entry from the File menu; **it is highly recommend to save any imported object as a PLP**, as this will then automatically store any configured contrast, conditions, and settings alongside the PLP file
+  * either selecting or creating an analysis
+    * in case you have already created an analysis at an earlier time, you can simply select an analysis; **if you wish to create multiple analysis with similar settings**, it is recommended to first create one of these and then use the "Add new analysis" button to duplicate the settings and retouch the settings as desired
+    * otherwise, start by choosing a contrast column, then configure the contrast terms (particles), followed by setting up any conditional statement you would like to use for further sub-selection of coordinates from the database
+  * configure all further settings (spatial layout, etc.)
+  * run the current analysis (or all configured analyses), which will create one VMP per analysis (and possibly one additional VMP with just the resulting summary maps)
+===== Outcome description =====