Software questions
Analysis and results
From tracks to a results table.
Questions people ask
What is the analysis screen for?
This screen turns your trials into results. 1) Your trials (.hvs files) are listed on the left. 2) Double-click one to see its plot. 3) Or select several, name your Summary (SUM) file and click 'Analyze Batch or Series'. 4) Use 'Export Results / Setup Custom' to export.
More detail
The Analyse screen turns your recorded trials into results. Open it with 'ANALYZE' near the bottom left of the Run screen of the maze you are using (ignore other buttons there); the heading and title bar name the maze, and each maze lists only its own SUM files. Trials (.hvs files) are listed on the left. Double-click a trial for its plot, then 'OK' for the summary analysis; 'Full Analysis' shows and saves everything. For batches, highlight trials, type a name in 'Name your Summary (SUM) file' and click 'Analyze Batch or Series', then use 'Export Results / Setup Custom' to export selected variables.
Going deeper
Before analysing, HVS recommends becoming familiar with the analyses and their purposes at hvsimage.com/morris-water-maze-analysis. VR water maze trials are analysed with the water maze workflow.
How do I view the analysis for one trial?
Double-click the trial, click OK for the summary, then 'Full Analysis' for everything. 1) Double-click the trial name. 2) Click OK. 3) Click 'Full Analysis' to view and save.
More detail
Double-click an individual trial name to view its plot, then OK to view the summary analysis. From the summary box, 'Full Analysis' shows and saves the full analysis for that trial, including all analyses you would see for a batch.
Going deeper
In the VR water maze only the platform position used for the trial is shown (ask HVS if you need data for other positions).
How do I analyse a batch of trials into a .sum file?
Select the trials, name your SUM file and click 'Analyze Batch or Series'. 1) Highlight the trials. 2) Type a name in 'Name your Summary (SUM) file'. 3) Press Enter or click 'Analyze Batch or Series'. 4) Then click 'Export Results / Setup Custom' to choose results.
More detail
Highlight all trials to include, enter a name in 'Name your Summary (SUM) file', and press Enter or click 'Analyze Batch or Series'. Plots may flash by while trials are analysed. The .sum file holds all available data for the highlighted trials; then use 'Export Results / Setup Custom' to choose variables for export.
Going deeper
Keep .sum files: you can create further results files with different variable selections from them.
My newest trials don't appear in the analysis list. Why?
The HVS folder must hold fewer than 10,000 .hvs files; files numbered 10000 onwards don't show. 1) Back up the HVS folder. 2) Create a subfolder (e.g. 'Trials moved'). 3) Move older files into it (files in subfolders are not listed). 4) Click 'ANALYZE' again.
More detail
Files numbered 10000+ don't appear in the Morris Water Maze > 'ANALYZE' list, though they are normal .hvs files (Windows may show a browser icon). Keep fewer than 10,000 in …\Data\Morris Water Maze\HVS. Moving older files out also makes the list easier to scroll, as it shows oldest first. After an upgrade numbering restarts, so new trials may be near the top.
Going deeper
Clearing a data folder of very many .hvs files can also cure intermittent problems starting trials. Open .hvs files as text by right-clicking in the analysis list (Notepad++).
What do the abbreviated column names (e.g. PASSTH01, PROXmt00, TIMCT%01) mean?
Numbers at the end refer to calibrated positions: 00 = the first calibrated (usually centre), 01 = the second, and so on. 1) Click 'Help' on the 'Export Results / Setup Custom' screen for the full list. 2) Columns without a number are for the target. 3) e.g. PASSTH01 = passes through counter 1; ENCTR_sc / ENCTR_mt = time and path to first close encounter.
More detail
Suffixes: sc = seconds, mt = metres, mts = metres per second, % = percentage. Examples: LATENTsc latency; PATHISmt path; SPEEDmts average speed; QUAD1%sc time in quadrant 1; PASSTH00 passes through counter 0; TIMCT%00 % time in counter 0; PROXIMmt Gallagher global for the target and PROXmt00, 02, 04 for positions 0, 2, 4 (lower = closer); THGTIME% thigmotaxis time; BLOKLND1 % time in quadrant excluding the outer thigmotaxis band; KELLY_sc time to break away from the poolside beyond the radius set by KELLY_mt. To export only platform 1 measures, select items ending 01 and omit those ending 00. Current versions name export options descriptively.
Going deeper
%TIMECTR is an old column; newer versions use TIMCT%00..nn, one per calibrated position. Un-numbered QUAD_ columns from comma-separated import are artefacts. Deleting an Excel column shifts data, so check.
How do I export a clean path plot without start, heading and end markers, or without the centre platform label?
Use a slice covering the whole trial. 1) Click Advanced before plotting. 2) Set Slice start 0 and duration = whole trial. 3) Plot: the full path appears without labels. To hide the centre platform 00, edit copies of the .hvs to set PLATX_00 and PLATY_00 to 0 and analyse results with the originals.
More detail
Slice plots omit start, heading and end markers. To remove the platform 00 label, change PLATX_00 and PLATY_00 to 0 in copies (Notepad++ in Helper Apps can search and replace across many), keep originals separately and always analyse with unadjusted originals.
Going deeper
Slices do not give heading angle or close encounter measures; latency and path are shorter and target quadrant % may be larger.
How do I choose which results to export ('Export Results / Setup Custom')?
Use 'Export Results / Setup Custom' to pick variables, then '3. Make Custom Results File' to create your results file. 1) Click 'Export Results / Setup Custom'. 2) Highlight the SUM file under 'Summary files' and click '2. Define'. 3) Click the variables you want, then 'Save'. 4) Highlight the SUM file and click '3. Make Custom Results File'.
More detail
After the .sum file is made, click 'Export Results / Setup Custom', highlight the SUM file under 'Summary files' and click '2. Define'. Click each variable you want in the middle column; they appear on the right. Click 'Save'. Back on the previous screen, highlight the SUM file and click '3. Make Custom Results File'; the CST file appears in the 'Custom files' list.
Going deeper
The .sum file contains all available data; the CST is your selection, one line per trial and one column per variable. The program also has help text files 'Help for defining your custom results files.txt' and 'Help for Setup Custom - Exporting Results.txt' (the 'Help' button on the same screen).
Where are the CST results files and how do I open them in Excel?
CST files are in Data\Morris Water Maze\CST and open in Excel. 1) Go to C:\HVS Image 2027\Users\[username]\Data\Morris Water Maze\CST. 2) Open the file in Excel or Google Sheets. 3) If asked, choose comma as the separator.
More detail
CST files are comma-separated files for Excel and statistics packages; select comma if asked for the delimiter. For the water maze (including VR water maze trials) they are in C:\HVS Image 2027\Users\[username]\Data\Morris Water Maze\CST. You'll see a line per trial and a column per variable chosen with '2. Define' in 'Export Results / Setup Custom'.
Going deeper
For the circular mazes the output is named .cst.csv; for VR it is named .cst, and you can save a copy as .CSV or import it via Excel.
Can I make a different results file later?
Yes, as long as you keep your .sum and .hvs files. 1) Keep .sum files to make new variable selections. 2) Keep .hvs files to make new .sum files with different trials.
More detail
You can create additional results files with a different variable selection as long as you keep your .sum files (or remake them from .hvs files). You can create new .sum files with different sets of trials as long as you keep your .hvs files.
Going deeper
Treat .hvs and .BOND files as raw data and back them up; ask HVS about automatic back-ups.
To split a trial into parts for analysis, see time slices in Morris water maze analysis.
Spotted a mistake, or know a better source? Tell us and we'll fix it and say so on our corrections page.