MoMo R5.1: Processing sessions

1. Contents
2. Setup
3. Preferences
4. Sessions: 4.1General
4.2MoMo GUI
4.3Examination information
4.6Zoom diagrams
4.7Y-limits in diagrams
4.8Export diagrams
4.9Color-bar sheets
4.10Single trials
4.11Recent sessions
4.12Report problems
5. Command line
6. Models
7. Visualize C3D
8. Administration
9. Changes

4.1 General

The main task of MoMo is processing a single session recorded by Vicon WorkStation: all trials of a session and all subsessions are imported, classified, a specific 3D model is applied and mean and standard deviations of output variables are calculated. The results are displayed as sheets and can be exported to ASCII files. Diagrams with the trajectories of all single trials can be created and a trial file can be visualized as diagrams and as 3D movie.
MoMo can be started through the graphical user interface MoMoG and as batch process from Matlab's command line or from other functions. MoMoG offers a limited set of parameters for the daily use, but the function momo accepts a variety of input arguments (see: momo help and momo inputs).
The functions momoRapid, momoSet and momoNorm start MoMo for a set of sessions, e.g. to apply an expanded model to all recorded sessions or to create norm data (see: Session-sets and norm data).

4.2 MoMo GUI

The graphical user interface of MoMo is started with momog. Parameters for processing the session can be defined here. Afterwards MoMo is started with the Run button. This creates the calling sequence for calling momo as a batch process.
Hold the mouse pointer over a field of the MoMoG dialog to see tooltips with explanations!
Reset the window position: momog $clear.
Open a specific session folder: momog <FolderName>.
MoMoG dialog Session: Model: Problems: Graphics: Files:
MoMoG trial menuTrials:

4.3 Examination information

The dialog to edit the examination information appears 1) if you process a session the first time, 2) if you hit the Subject button in MoMoG, 3) if you start MoMo with: momo ExamInfo. The values defined in the dialog are saved in the ExamInfo file: "<Session>\ExamInfo.exm".
Hold the mouse pointer over the fields of this dialog to see some tooltips!
ExamInfo dialogPerson: Examination: Evaluation:

4.4 Sheets

As standard output, MoMo creates sheets with plots of the calculated variables. The sheets for mean and deviations, single trials, average over a group of sessions and for the display of exported trials/sessions (see ShowGLA, not included in all distributions) have equivalent styles, menus and buttons.
In the MoMoG dialog the checkboxes Sheets and Single Trials control the creation of sheets with mean and deviations or with single trial diagrams, respectively.
Corresponding arguments for momo: Sheet and SingleTrial.
Example for sheets: Mean and deviations for a session:
Diagram sheetText: Buttons:
Sheet menu MoMo menu: (press Menu button to show the menubar) Help menu: (press Menu button to enable the menubar)
Context menu of sheets: The user can add notes and edit some fields of the legend (e.g. the class names and the name of the person) using the context menu of the sheets: A right-click in the background of the figure or on a text string opens a context menu. The changes concern all pages of the current set of sheets in opposite to Matlab's editing tool in the figure's toolbar. The created notes can be moved with the left mouse key and a context menu allows to edit the notes and their font style. (new: 23-Jul-2009)

4.5 Diagrams

Diagram: Context menu
Context menu of a diagram: Simple statistics Context menu of a line: Note: This context menu is available in all diagrams created by MoMo, e.g. in zoomed diagrams, in diagrams created for the export and diagrams of Showc3D.
If no data exist for a class, the string 'no' is written in the corresponding color right beside the diagram. A right-click on this message moves it to the inside, the next right-click to the left side and finally the message disappers. Perhaps such fine-tuning is needed for exporting diagrams to a presentation.

4.6 Zoom diagrams

Zoomed diagram
Diagrams created by MoMo, e.g. on sheets, can be zoomed through the context menu or a double-click in the axis. If a corresponding explanation pictures exists in <MoMoData>\ModelDesc\<DescName> (defined in the model script), it is added on the left side. For repeated zooming, this explanation picture disappears.
The context menu of diagrams is available in zoomed diagrams also, e.g. measuring might be easier in a large diagram.

4.7 Y-limits in diagrams

Y-Limits in diagrams
Sometimes Matlab's or MoMo's methods to choose limits for the Y-axis produces strange results. Especially for publications manual improvements can be useful. The dialog for adjusting the limits can be called through the context menu of all diagrams created by MoMo.
See Y-limits menu on the sheets to adjust the limits of all variables, e.g. to compare to sessions.
In MoMo 5.0.24 the methods for Y-limits are improved (new: 03-Feb-2010).
See also: YLimMode, YLimFile.

4.8 Export diagrams

The export of diagrams to graphic files can be started from the menu of MoMo's sheets: MoMo>Export plots>Manually.
Corresponding arguments for momo: PicDest, PicFormat, PicSize, PicTitle, PicTransp.
Export diagram dialog 1. Open diagrams as figures: 2. Modify opened diagrams: 3. Save: 4. Close the dialog:

4.9 Color-bar sheets

Color-bar sheet
On this type of sheets, the values are normalized to the mean and standard deviation of the norm data:
color = (value - valuenorm) / stdnorm
A value of +1 means, that the current measurement point is 1 standard deviation higher than the mean value of the norm data.
Popup-menu (top right): Two colormaps can be chosen: "white" is white around 0 (save toner when printing) and "jet" (standard Matlab colormap). In addition the range can be adjusted in this popup-menu: e.g. "3" means a range from -3 to +3, "data" is the maximal normalized deviation occurring in the current measurement.
Absolute and relative values of the static trial and Range of motion are shown also.
See input for momo: colorbar.
Buttons: See sheets.
A double-click on the title of a variable opens a zoomed standard diagram.
Note: GRF values during the swing-phase are pure noise.
See also: Kurt Manal, Steven J. Stanhope: "A novel method for displaying gait and clinical movement analysis data", Gait&Posture 20 (2004) 222-226

4.10 Single trials

MoMo can visualize single trial data in two ways: Single trial sheets and a separate figure for each variable, which is called "single trial stack". It is a question of taste, which method is better to assess the quality of trials.
Corresponding arguments for momo: SingleStack, SingleTrial.
Single stack navigatorSingle stack navigator:
Single trial figureSingle stack figures:
Single sheetSingle trial sheet are similar to mean&std sheets, just the legend and the number of lines differ:

4.11 Recent sessions

Recent session dialog
The names of processed sessions are stored by the function momocd. MoMoG calls this functions implicitly for its list of recent sessions. You can call momocd from the command line, ShowC3D or anywhere else also to change the current folder to a recently processed session.
The arrow keys can be used for navigation in the popup-menu. The open-button adds a new folder to the list. The [Return] key and the OK button close the dialog.
You can call momocd through a powerful command line interface also (new: 22-Aug-2009): More: help momocd.

4.12 Report problems

In case of a crash of MoMo or unexpected results, a detailed report helps to locate the problem. The report contains the output to the command window and should contain the processed data also. MoMo calls the powerful tool BugReport for the creation of such reports. This can be started manually with the command BugReport, or by pressing the Report error button in MoMoG. After a crash, MoMoG asks for the creation of a report automatically.
Note:  The author cannot and will not reply questions about problems without a qualified BugReport!
Bug report dialog Bug report if started from the MoMoG dialog:
Bug report dialog
A bug report can be started manually also by the command BugReport, e.g. if a problem does not concern MoMo or even MoMoG cannot be started.
Please compress and encrypted files as zip or rar file and send it to Never send the used password in clear text! Use momoCode to encipher the password, then only other MoMo users can decipher it with the same tool.
Author: © Jan Simon, Imprint / Impressum   File: Help/momo_5.1/session.html    24-Nov-2018   MoMo: 5.1.34