Would you like to hear about webinars we're
doing, new features we're adding and projects we're undertaking? Sign up
here to our pleasantly infrequent newsletter!
This page provides information on all editable elements within the Moveshelf application, assuming you have the necessary editing rights.
Here, you can find instructions on creating and managing Projects and
Subjects, Uploading data,
creating and editing Reports, and more advanced Project settings.
For instructions on viewing and analyzing subjects, sessions, reports, and trials, please refer to the View Moveshelf page.
DashboardThe dashboard holds an overview of all projects of which you are a member.
. A project is a space where all your subjects and their data are stored, and where you collaborate with your team (project
membersA member is a user who has been granted access to a project. A member can have different roles; Admin, Editor or Viewer.
). Every single project has its own private and separate space. This means that data is only accessible for people that are a member of this project. Separate projects have the advantage that you can work with different teams and create stand-alone databases dedicated to a study or department (optional).
Click on ‘Create new project’ to add a new project to your Moveshelf dashboard.
Insert a project name and click on ‘Create’. You are automatically an
adminAn admin is a member that has the rights to add others to a project, delete the project, edit data, and view data.
in the projects that you create.
Only users with the rights to create projects can see this button. In case you do not see the button, but you would like to create a project, contact Moveshelf support.
projectA project is a space where subjects and their data are stored, and where you can collaborate with the members of that project.
can have multiple members, as a way to give access to its contents to a selected group of people. Only project
adminsAn admin is a member that has the rights to add others to a project, delete the project, edit data, and view data.
can add members to their project(s). Members can be given different roles (
viewerA viewer is a member that only has the right to view data (e.g., clinicians).
,
editorAn editor is a member that has the rights to edit and view data (e.g., lab operators).
or
adminAn admin is a member that has the rights to add others to a project, delete the project, edit data, and view data.
) which have different rights on Moveshelf, see table below. Adding a member to a project can prompt the creation of a new account on Moveshelf if this person did not yet have an account. The workflow and automatically generated notifications are dependent on whether the user already had an account on Moveshelf and whether your organization has Single Sign On (SSO) or manual login enabled. Please read the paragraphs below for specific information on this and recommended workflow.
Admin
Editor
Viewer
Add members
X
Delete members
X
Delete projects
X
Edit data
X
X
View data
X
X
X
General steps to add a member to a project
Click on the plus sign in the project overview page to add a member to your project.
Insert a business email address or Moveshelf username, select a role, and click on ‘Add’.
The invited member is listed on the project overview as (pending) when they have not yet activated their account.
Some additional actions might be required to arrange access to Moveshelf for a new account of the invited user. Please read below.
Adding a member does not send a notification to the invited email address about being added to the project. If preferred, please send an email to the new member with a link to the project.
Email invites are only possible for specific configured email domains for each organization.
Inviting a new user that prompts the creation of a new account on Moveshelf can only be done by the Moveshelf super user of your organization. Typically, this is a lab operator whose account is designated as the owner of the organization on Moveshelf.
Adding a new Moveshelf user when you have SSO enabled
This feature is optional and only visible to Enterprise customers with this feature enabled.
When you have SSO enabled, and you would like to add a new user to a project, please go through the following steps:
Add the member according to the steps described above.
As your organization has SSO enabled, you also need to make sure the user has Microsoft Entra ID (Azure AD) access to Moveshelf.
Now, the user will have access to Moveshelf and the project you invited them for. If preferred, you can notify the user by email and provide the project url, or the user can start working with Moveshelf by entering the platform through the hospital's electronic patient file in case of an EHR integration.
Adding a new Moveshelf user when you have manual login (no SSO)
Add the member according to the steps on top of this section.
The invited user will receive an automated email with instructions and an url to activate his account. Please send the invited user an email to notify them of the invitation and to request to look for the email, also in the spam folder. If the email cannot be found (e.g. blocked by the organization's firewall), please contact Moveshelf support for help.
By setting the project as a global project, you can grant all members of your Moveshelf organization (
viewerA viewer is a member that only has the right to view data (e.g., clinicians).
-only) access to your project without having to add each of them as a member within the project.
adminAn admin is a member that has the rights to add others to a project, delete the project, edit data, and view data.
.
Go to the project overview page and click on ‘Edit’.
Click on the recycle bin to remove this project from your dashboard.
Type the name of the project to confirm the deletion of your project.
Note that if you delete this project, all data of this project will be deleted. Please contact Moveshelf support if you have accidentally deleted a project.
By default, projects can only be accessed by project members (see Add members to a project). However, a project can also be set as a "global project", which means that all members of your Moveshelf organization will have
viewerA viewer is a member that only has the right to view data (e.g., clinicians).
access to that global project (excluding guests and external users).
EditorAn editor is a member that has the rights to edit and view data (e.g., lab operators).
and
adminAn admin is a member that has the rights to add others to a project, delete the project, edit data, and view data.
access will still need to be given manually.
Please contact Moveshelf support if you would like to change the access setting of your project.
Which subject information and session information can be added in a Moveshelf project is configured by a template. To support engineers with importing subject metadata, it is possible for a project
adminAn admin is a member that has the rights to add others to a project, delete the project, edit data, and view data.
to download the template using the following icon:
This section explains the basic data structure of Moveshelf. This structure can be created manually or automatically. Automation of data categorization is discussed in the section on Directory upload, based on Moveshelf's third party integrations.
Moveshelf has a subject-oriented data structure. The data of a subject is divided into
sessionsA session is an overview of all recorded measurements done in one ‘visit’ of a subject. It can include multiple conditions and trials.
, which then can be divided into
conditionsA condition is a state in which a subject has been recorded, e.g., barefoot, or with shoes. It can include multiple trials.
to categorize trials. Your data is ultimately stored in
trialsA trial contains all data that was captured of a subject during one recording. It can include multiple data types that have been recorded synchronously, e.g. C3D, video, forces and EMG.
, with one trial per recording. A trial can contain several data types that were recorded synchronously.
Moveshelf’s workflow is subject-oriented. All data uploaded to Moveshelf belongs to a subject, structured by visits (called: sessions). Populate a project manually by creating subjects:
Click on 'Add new subject’ to create a new subject.
Insert a subject ID (e.g. patient number, study participient ID or other ID) and click on ‘Add’.
If your organization has a deep IT integration it is possible that this process is automated and does not require you to manually create subjects.
Click on ‘Add new session’ to add a new measurement session.
Select a session date, update the default session name if preferred and click on ‘Add’. The default session name is the selected date, but you can update this by adding text or removing the date from the session name completely (e.g., "3month post-op”).
If multiple sessions are added to one subject, the sessions will be ordered by the session date.
You can add subject information to Moveshelf. Subject information includes general subject information (such as date of birth or diagnosis), interventions received, and research projects.
Add general subject information
You can add/edit subject information on Moveshelf by using manual input or import subject information via EHR. To add/edit subject information manually, go to the subject home page and click on the 'Edit'-button next to the subject's name at the top of the page. Fill in the form and click on ‘Save’.
You can also modify the Subject ID (the name that appears in the subject list on Moveshelf). Note that some fields can have a value for every date. This can be helpful, for example, when specifying a body weight to use for normalizing moments and powers in trials from a specific date.
When entering the EHR ID for a subject, ensure it is unique within the project. When you enter an EHR ID that already exists, an error message will be displayed, and the subject information will not be updated.
Add intervention/research information
This feature is optional and only visible to Enterprise customers with this feature enabled.
If this feature is enabled, click the 'Edit' button next to the subject’s name and navigate to the Interventions or Research tab.
A subject can have multiple interventions (click 'Add intervention'), and each intervention can have multiple procedures (click 'Add procedure').
In the Research tab, you can add one or more research projects (click 'Add Research').
Customize subject information
Upon request, fields for (additional) parameters can be added, modified, and/or customized.
Customize the Excel template to include only the parameters you require and delete unnecessary fields.
Send the customized Excel template to Moveshelf support for review and implementation.
When the provided input is reviewed and accepted by Moveshelf, it will be implemented exactly as specified. This includes the order of dropdown options, possible spelling errors, and capitalization.
This feature is optional and only visible to Enterprise customers with this feature enabled.
If this feature is enabled for your organization, you can add and view additional session information, like patient history, outcomes of a physical exam, recommendations or more (see image below).
Add specific session information by navigating to the session home page (click on the session name on the subject home page or in the navigation menu on the left) and click on ‘Edit’ next to the session name. In this edit mode, you can also change the name and date of the session. Make sure to save your changes when you’re done.
Customize session information
Upon request, session information tabs can be added, with custom headings and parameters.
Customize the Excel template to include only the tabs / parameters you require and delete unnecessary fields.
Send the customized Excel template to Moveshelf support for review and implementation.
When the provided input is reviewed and accepted by Moveshelf, it will be implemented exactly as specified. This includes the order of dropdown options, possible spelling errors, and capitalization.
Moveshelf displays warning messages to prevent data conflicts when multiple users attempt to edit or save the subject or session information simultaneously. These warnings help you take appropriate action before proceeding.
Warning when another user is editing
If you enter Edit mode while another user is already editing the same subject or session information, a warning message will appear. This message will include the other user’s username and the time they started editing. This helps you coordinate changes and avoid potential data loss.
Warning when saving changes
If you attempt to save while another user has already made and saved changes, you will receive a conflict warning. You will have two options:
Save anyway - Select "I'm aware that this operation will override the other user's changes." and click "Save anyway". This will overwrite the other user's changes and makes your changes the most recent version.
Cancel - Keeps the other user’s changes intact and returns you to Edit mode.
Note: if, while you are editing subject or session information on Moveshelf, another user uploads data to that subject or session information, you will also receive the warning above.
Moveshelf is an application where a wide variety of data types (and corresponding data formats) are supported, for secure storage as well as for visualization. This way, movement analysis measurements and interpretations come together in one place independent of which technology was used or even which lab was visited by your subject.
In this section we take the opportunity to list the currently supported data types and formats. If you work with a data type or format that is not in this list, feel free to contact Moveshelf Moveshelf support and inquire about the possibilities.
Data types
On Moveshelf different data types are supported. Data types can include several key parts of your data, so an explanation of which data we read from each type is also mentioned where helpful.
3D movement analysis data
This can include 3D, kinematics, kinetics, EMG and gait parameters.
Supported formats are .c3d, .mox, .xlsx, .adc and .mvnx.
Videos
This can include videos taken by smart phones, normal video cameras or synchronized cameras as part of an integrated setup. See below the list of system and manufacturers we work with.
Supported formats are .avi, .mp4, .mov and .mkv
Documents & pictures
This can include results of a physical examination, any type of report or other free text and pictures stored as a document.
Supported format is PDF
Some of the supported data formats mentioned above can be implemented with considerable variations by different vendors. Although we take care to support a broad variation of formats, some files may not work out-of-the-box or may be visualized incorrectly when uploaded. Please contact Moveshelf support if you would like us to look into such a file.
From a C3D file, Moveshelf calculates the EMG Root Mean Square (EMG RMS) from the raw EMG channel, visualized in Moveshelf's individual EMG graphs and the EMG consistency graphs. This calculation is performed during the processing phase after the initial upload of the trial is completed (see 'Upload status' in the section above).
Moveshelf calculates the EMG RMS as a moving RMS with a time window of 25ms. Specifically, we apply a method that calculates the RMS value as:
General RMS equation. For calculating EMG RMS, the 'n' stands for the window_size, which on Moveshelf is the
amount of samples in the 25ms time window, and 'x' is the value of the raw EMG value for each sample.
MOX files are XML-based files that can vary in format depending on the system used to generate them and other possible postprocessing modifications. Moveshelf’s current support targets mox formats which can be visualized by Motek’s Gait Offline Analysis Tool (GOAT) or VU Medical Center Amsterdam’s MoXie Viewer.
MOX files can contain movement data such as EMG, kinematics, kinetics, force plates measurements and synchronization information. This data can be visualized and played synchronously on Moveshelf.
Moveshelf supports the visualization of force vector overlays on top of videos for multiple file formats, including MoxieViewer (.mox), Noraxon (.c3d), and TEMPLO (.box) files. These overlays provide a graphical representation of forces measured during motion analysis.
For all supported formats, Moveshelf extracts force plate data, including force vector magnitude and direction, from the respective file. The system reads the calibration and positional information of the force plates and maps the force vectors onto the corresponding video frames. Using embedded metadata and Direct Linear Transformation (DLT) matrices where applicable, the force vectors are scaled and projected onto the videos to create overlays.
If the force overlay function is enabled for the user's project, the respective file (.box, .mox, .c3d) can be included in the directory upload folder or stored under a condition "Additional files" in a trial.
On Moveshelf it is possible to host your own reference data and add this in your reports. For how to add an existing reference on Moveshelf to a report, please see the section Reference data.
Moveshelf supports reference data in a specific format, through an Excel template. Download the template below and add your own reference data in the document. You can repeat this process for multiple versions of reference data, e.g. separate files for age and/or gender. Contact Moveshelf support when your Excel reference data is ready, so we can place this in your project.
When creating the Excel, please pay attention to the following points:
Variables in the Excel template are meant as an example, you can add / remove worksheets or spatiotemporal gait parameters according to your workflow.
Tabnames combine the data group (e.g. "Rotation" means it belongs to the kinematics group) and variable name (e.g. "HipFlex"). Adjust the variable name in tabnames if necessary, to match it with the variable names in your data.
Check if all units are set correctly (both in the tab "Unit" and "gait params").
All headers (e.g., 'mean' and 'std') need to be exactly as written in the Excel file. Please pay attention to capital letters and spaces.
This feature is optional and only visible to Enterprise customers with this feature enabled.
Moveshelf can automatically read in files that are captured and exported using the synchronized video system of Contemplas. This workflow is currently only supported through integration with third party archiving system ArQive (section Moveshelf + Arqive).
What to store into ArQive for upload to Moveshelf
A .zbox file. This is an export option of the Templo software. It is relatively similar to a zip file and contains videos and files with information on data structure inside. For Moveshelf to read and automatically categorize the trials correctly, this .zbox file should include:
one .box file. The information (text) in this file specifies which other data in the .zbox.
.recording files, one for each trial. This file specifies which videos belongs to one trial.
.avi files. These videos (commonly) come in sets of multiple synchronized cameras.
This section provides information on how to manually upload data to Moveshelf, checking the upload status, editing uploaded files, and modifying trial names.
Manual data upload
When uploading data manually, you first need to create a session. Within this session, you can add conditions and trials. See the image below for a visualization of all steps.
Add condition
Click on ‘Add condition’ to add a new condition to this session.
Insert a condition name (e.g., barefoot, intervention or clinical test) and click on ‘Add’.
Add trials
The first trial is automatically shown when you have added a condition. In one trial you can upload different types of data that belong to one, synchronized capture (e.g., c3d and video). Different captures should be uploaded as separate trials.
Click on ‘+ Add trial’ to add more trials within one condition.
Upload data to a trial
Upload data to a trial by dragging and dropping it from your file explorer or click and upload. The files will show up underneath the trial in ‘Available data’. Please do not close the Moveshelf page or navigate away on the page while the green bar is still visible.
After processing is done, Moveshelf will show what kind of data is uploaded in the trial, using different icons (e.g., graphs, video). Now your trial is available for viewing and editing.
Upload status
Moveshelf shows the status of the uploading files when you expand the header Data of a trial in the Edit session interfase. Please see all possible statusses in the list below, where the numbers correspond to the numbers in the image at the bottom of the article.
1. Uploading: while uploading you will see a green bar next to each file. Please do not close the Moveshelf page or navigate away on the page while the green bar is still visible.
2. Processing: once uploading is complete, an orange bar will appear to indicate the processing of the data. It is safe to navigate again to other pages as this process is performed in the backend and will not be disturbed by navigating away from the page.
3. Uploaded: the file is uploaded and processed completely, the bar is not shown anymore. A graph and/or video icon for each trial are shown to indicate respectively movement analysis data and video data are included.
4. Uploading warning: since this file was uploaded, the data processor of moveshelf has been updated. If you notice any unexpected visualizations of your data in a trial or report, please try to re-upload the trial. When in doubt or if you don't have the original data anymore, please contact Moveshelf support and we can help you to solve this warning.
5. Uploading failed: there are one or more upload errors with this item, possibily due to an unexpected structure in your data file. Please contact Moveshelf support for help.
Edit uploaded files
After a successful upload on Moveshelf, you will be able to manually edit files within your trials:
You can replace an existing .C3D file for an updated .C3D file. To replace, drag the updated file with the exact same name in the trial upload box (see image below, 1). The file will be reprocessed automatically. To see the updated trial, please refresh the page.
You have the option to delete a file from a trial by clicking on the recycle bin.
You are able to download additional files from a trial. This can be done by clicking on the download button next to the recycle bin (see image, 2)
Edit trial name
If you are on the trial page, you can change the trial name by clicking on ‘Edit’ on the right side next to the trial name.
This feature is optional and only visible to Enterprise customers with this feature enabled.
On Moveshelf you can automate the process of grouping multiple files into trials, by uploading a directory. General information about how to upload a directory can be found in this section. Please refer to the following sections for specific data requirements for: Vicon, Noraxon, MOX, Theia or TEMPLO directory upload. Feel free to contact Moveshelf support if the third party integration that you are looking for is not in this list.
How to upload a directory
Open your subject on Moveshelf either by clicking a URL in your EHR or manually navigate to your project on Moveshelf and select or create a new subject.
Create a new session.
If your organization has directory uploads enabled from other vendors as well, select the type of directory you'd like to upload through the drop down menu on top.
Upload the directory by navigating in your local storage (e.g., Windows explorer) to the correct folder and drag and drop the folder in the upload area.
Moveshelf will read the directory and show you the structure that your data will be uploaded in. The order of conditions is based on the creation date and time of the earliest trial in the condition.
Click 'Upload'. All files will now be uploaded and processed, during which you will see a progress bar on top of page.
Please do not leave the page while uploading (initial green upload bar is active). Once uploading is complete, the progress bar will turn orange to indicate the processing of the data. It is safe to navigate again to other pages as this process is performed in the backend and will not be disturbed by navigating away from the page.
This feature is optional and only visible to Enterprise customers with this feature enabled.
On Moveshelf you can automate the process of grouping multiple files into trials and multiple trials into conditions, by uploading a Vicon directory. For general information about how to upload a directory see the section directory upload.
Folder structure
The Vicon directory upload works with a Vicon session folder. A session folder usually is a direct child of the subject folder, and includes all data files for one session.
Example Vicon session folder.
For the upload to work, the session folder should include:
xxx.Session.enf file. This file is used to detect a Vicon session
xxx.Trial.enf or xxx.Trialxx.enf files. This file is used to detect trials within the Vicon session
.C3D files (optional)
.avi files (optional)
.PDF files (optional)
.mp4 files (optional)
image files (.jpeg, .png, .webp) (optional)
Please see the image on the right for the contents of an example Vicon session folder. The session folder can have subfolders. All files from all subfolders will be included for the directory upload.
Automatically categorize trials into conditions
Fill in the Description field in Vicon Nexus with the name of your condition. Moveshelf will read this and categorize your trials into these conditions (see image below).
Movement analysis data
This section describes how to set up your C3D file for visualization on Moveshelf.
Data groups on Moveshelf
All data in the "ANGLES" group in the C3D file will be grouped under "Kinematics" on Moveshelf.
All data in the "MOMENTS" group in the C3D file will be grouped under "Moments" on Moveshelf.
All data in the "POWERS" group in the C3D file will be grouped under "Powers" on Moveshelf.
Force plate data added as a "Force platform" in the C3D file will be grouped under "Force plates" (Trial view) or "Forces" (Report view) on Moveshelf.
All data with "voltage" or "emg" in the C3D channel name will be grouped under "EMG" on Moveshelf. This can be raw and/or envelope EMG.
Add gait events to a trial
To be able to see gait events and gait cycle data on Moveshelf, you first have to add gait events (Foot Strike, Foot Off) to the C3D file of the trial. See Vicon Nexus Documentation for instructions on how to do this.
Add spatiotemporal parameters to a trial
To be able to see spatiotemporal parameters in a trial on Moveshelf, you first have to add these to the C3D file of the trial. This can be done by adding the 'Calculate Gait Cycle Parameters' operation to your data processing pipeline in Nexus.
This operation calculates the parameters in the first complete gait cycle for each side in each trial, also if multiple gait cycles are defined in a trial (see
Vicon Nexus Documentation).
Seeing as this is single-cycle data and not an average, only one value will be shown for each parameter on Moveshelf in trial view.
Only show valid force data on Moveshelf
In Vicon Nexus there are standard columns for force plates (e.g., FP1 = force plate 1 and FP2 = force plate 2). For every trial, enter the information for a good hit on a force plate by 'Left' or 'Right', or input 'invalid' in the column (see image 1 below). This will generate clean and recognizable patterns in case of a gait cycle analysis (see image 2 below). If all force plates have invalid data, no force plate graphs are shown.
Alternatively, to reach the above-described effect, you can edit the force plate context on Moveshelf without having to adjust the C3D again in Nexus. For more information, navigate to Add context force plates.
Image 1: Add force plate context in Vicon Nexus.
Image 2: Valid force data on Moveshelf.
Normalize data to bodyweight or mass
It is possible to visualize ground reaction force normalized to body weight (%BW) or body mass (N/kg). A data structure requirement for this optional
report template setting is that the C3D file has to contain body mass information. The moments and powers are provided by default in the C3D as respectively Nm/kg and W/kg, and visualized on Moveshelf as such without the need of body mass information separately in the C3D.
Alternatively, if the C3D did not contain the required information, you can manually add a bodyweight for the subject using
add subject information. The date of the body weight should match the exact date of the session, or a warning icon will be shown for the concerning graphs.
Videos
Videos in .avi or .mp4 format can be added to the corresponding trial based on filename. More specifically, the video filename should start with the trial name, which is taken from the name of the .Trial.enf file.
Vicon Nexus 2.13 and higher exports videos with a new transcoder (H264). We recommend using this version of Nexus for shorter upload (processing) times on Moveshelf.
Additional files
An additional filter can be added to your Vicon directory upload settings to include alternative file types like PDF, images (.jpeg, .png, .webp), and .mp4 video (standalone video or foot pressure recordings) in your Vicon directory upload. These files will be automatically put into separate trials. These alternative file types can be uploaded automatically as a child folder within the Vicon session or present it as a separate folder after your Vicon session is done uploading.
Add trial information
Automatically add a description to a trial
Populate the Notes field in Vicon Nexus to fill the Moveshelf description field (Image 1 below, in orange).
Automatically show information on the content of a trial
Show the content of a trial (laterality/plane) next to the trial name in the navigation menu on the left side of the screen, by using custom colums named 'Side' and 'Plane' in Vicon Nexus (Image 1 below, in red). For example, populate these columns with 'L' (left) or 'R' (Right) to indicate the side, and 'fro' (frontal) or 'dor' (dorsal) for the plane. If the column Plane is empty, Moveshelf will assume the plane is sagittal. See Image 2 for the steps how to create the correct columns in Nexus.
Image 1: Add trial information in Vicon Nexus.
Image 2: Steps to create additional columns 'Plane' and 'Side'.
This feature is optional and only visible to Enterprise customers with this feature enabled.
On Moveshelf you can automate the process of grouping multiple files into trials, by uploading a Noraxon directory. For general information about how to upload a directory see the section directory upload.
To successfully upload a Noraxon directory to Moveshelf, you need to perform a two-step export from Noraxon software. Note to export the results in a self-created destination folder so Moveshelf can read all exported results at once. This parent folder should contain:
A folder that includes the native Noraxon session export data (e.g. Noraxon MR3 data including videos and metadata).
A folder that includes .c3d files of the Noraxon c3d export of the same session.
This feature is optional and only visible to Enterprise customers with this feature enabled.
On Moveshelf you can automate the process of grouping multiple files into trials, by uploading a MOX directory. For general information about how to upload a directory see the section directory upload.
The MOX directory upload currently supports MOX files for the Gait Offline Analysis Tool (GOAT) and MoXie Viewer (see Supported data types). You can upload a session folder that either contains multiple subfolders, each representing a specific condition (e.g. barefoot, shoes), or a folder without any subfolders. When subfolders are present, Moveshelf automatically categorizes the trials into conditions based on their names, treating each subfolder as a separate condition.
For the upload to work, the (sub)folder should contain:
.mox files
.avi files (optional)
Creating a MOX directory using Motek software
This section summarizes the process of creating a MOX directory using Motek software for upload to Moveshelf. Follow these steps to ensure that the exported .mox data is enriched with the necessary information for Moveshelf to read, organize, and visualize the data effectively. For details on specific steps, please refer to documentation supplied by Motek.
Capture motion in D-Flow
Start motion capture in D-Flow and export as a .mox file
Process the data in GOAT
Load the recorded .mox file: Go to File → Click Open, select your file, and click Open again
A 'File loading option" box appears
Under the Cycles section, select "Add all valid cycles after loading file" to initially include all valid gait cycles
Manually edit which gait cycles are selected by using the Left/Right foot icons
This feature is optional and only visible to Enterprise customers with this feature enabled.
On Moveshelf you can automate the process of grouping multiple files into trials, by uploading a Theia directory. For general information about how to upload a directory see the section directory upload.
To successfully upload a Theia directory to Moveshelf, kinematic data needs to be exported into a supported data format. Currently, the supported data format for the Theia system is .c3d, with specific export settings. The steps below describe the process to obtain this export for Theia data in combination with Qualysis hardware and software (QTM):
Start processing when using Qualysis Gait PAF in QTM
Click "processing" in QTM
This opens Theia
After tracking is completed in Theia, it will send the data to Visual3D for processsing
Process Data in Visual3D
Open Pipeline Processing in Visual3D by clicking the respective icon or pressing F11
Clear Visual3D Pipeline (required due to an error in Visual3D)
Select “CMO recalc pipeline”
Select “Main pipeline”, then click “Clear Pipeline”
Load and Execute Moveshelf Export Pipeline
Click “Open Pipeline” and load the Moveshelf_Export.v3s file. This is custom script provided by a Moveshelf customer who uses this workflow. This script is an adjustment of Visual3D's pipeline 'Export Polygon C3DFile' and specifies e.g. which data to include in the exported file and required suffix for the exported file name.
Click Execute Pipeline to generate the required xxx_TheiaKinematics.C3D files for all trials
You can upload a full session folder with one or more subfolders that each represent a condition (e.g. barefoot), or a folder without any subfolders. For the Theia directory upload to work, the (sub)folder should contain:
xxx_TheiaKinematics.C3D files
.avi files (optional)
xxx.settings.xml (optional. Required for the use of Video Overlay).
This feature is optional and only visible to Enterprise customers with this feature enabled.
On Moveshelf you can automate the process of grouping multiple files into trials, by uploading a TEMPLO directory. For general information about how to upload a directory see the section directory upload.
To successfully upload a TEMPLO directory to Moveshelf, export all trials from one session using the Box file export option in the TEMPLO software. For the TEMPLO directory upload to work, the folder structure should be as follows:
Main folder:
One .box file
Subfolder:
One .adc file per trial
.avi files (optional)
One .recording file per trial (optional). Used to include gait events.
TEMPLO data structure requirements
By following these steps in TEMPLO, the data export will be enriched with the information
that Moveshelf can use to read, organize and visualize Treant’s data.
For gait analysis set the type of analysis in TEMPLO to “Gait analysis”.
To automatically categorize trials into conditions on Moveshelf, include the condition in the recording label.
For each trial, provide the timing of gait events (initial contact and foot-off). This additional information enables Moveshelf to normalize graphs to gait cycles. If gait event timings are not included, the graphs will default to a regular time scale for visualization.
This feature is optional and only visible to Enterprise customers with this feature enabled.
It is common that movement laboratories have built up a large database with movement data over the years. On Moveshelf it is possible to store and organize this historical data, so that it can be used in current clinical decision making processes. To get all the historical data on Moveshelf a customized import can be set up as part of a Moveshelf implementation project. How the import is done is dependent on the data structure and type, and whether there is an integration with a third party archiving system, e.g. based on the Moveshelf + ArQive integration.
This section focuses on historical data import based mainly on Vicon data (Polygon reports) and an integration with ArQive where data is originally stored.
Data structure
A patient is represented on ArQive by one folder, named by the EHR ID
Vicon Polygon reports
Every polygon report is one folder, with a standard naming convention of “Report < date > < free text >“. The < date > and < free text > in the folder name are recognized and used to create and name a new session on Moveshelf.
A patient can have multiple Vicon Polygon reports (folders).
All data within a Vicon Polygon report folder will be organized within one session on Moveshelf.
Within the folder(s), a C3D file and/or video's with a uniform prefix in the file name will be uploaded as one trial.
PDF files and MP4 videos are accepted and uploaded as a separate trial each.
Data not within a Vicon Polygon report folder with the standard naming convention will be grouped together into one session with the standard name “Misc historical data“ (see image below). This can either be data in a folder that does not follow the Vicon Polygon report standard naming convention or data that is stored as a direct child of the patient folder.
Accepted data formats
C3D
Video files (.avi, .MP4 and .mov)
PDF
The current implementation of the historical data import workflow does not use the Vicon native .ENF file, as analysis of the data structure for the example implementation in this section frequently did not contain this file. This is contrary to the workflow we describe in our Vicon Directory upload, where the .ENF is used for advanced automatic organization and categorization based on a more singular, predictable and structured session upload.
Import and download historical data
When historical data of a subject is present in ArQive, a new subject is automatically created on Moveshelf with the EHR ID as patient ID or the data will be connected to an excisiting patient with the same patient ID. If you would like to view the historical data on Moveshelf you can import this data, following the next steps:
Click on 'Show available external sessions' to see which imports are available.
Select your historical data import and click on 'Import'.
If you would like to download the data as well click on 'Download' and a .zip file will be created.
The maximum import size of a historical data folder is 5GB. If the size of this folder is bigger than 5GB, we advise you to manually upload the data on Moveshelf.
This feature is optional and only visible to Enterprise customers with this feature enabled.
There is an automatic workflow created for customers who are working with the archiving system ArQive and the Moveshelf application. Just below, you see an example of how this integration is implemented. The only manual step in this workflow is to add the captured data to ArQive. Subjects, sessions, conditions and trials are automatically populated from the (meta)data in ArQive and the uploaded files.
Folder directories (e.g. Vicon directory, Templo or GRAIL) can be recognized by Moveshelf and automatically adds a predefined label (e.g. '3D gait lab', '2D video lab' or 'GRAIL') to the session name to reflect the source.
A report can be used to analyze multiple trials simultaneously, either to compare different conditions and/or sessions, or to analyze consistency within a condition. In a report numeric data is combined and overlaid in graphs and video’s from different trials can be played back (in a synchronized manner if your data contains the required information) and viewed right next to each other (see section Split screen). Reference data can also be added into a report, to match your trial(s) with healthy age-matched peers or others (see section Reference data).
Instruction for manually creating a report can be found in the section “How to create a report manually”. If enabled, reports can also be generated automatically, see “How to create reports automatically” for details.
How to create a report manually
To create a report manually follow the steps below:
First you need to go into editing mode of a session. You can reach this page by clicking the session name or the pencil next to a session's name in the left navigation menu or on the subject home page.
Select the trials/conditions you want to include in your report(s) by checking the checkbox next to the trial or condition (see image below) and click on ‘Create reports’.
You can select trials/conditions within the same session or different sessions. Click another session below your current one to expand and select those trials.
Select the report type (Condition summary or Comparison). See below for more information on the different report types.
You can change the report template and add Reference data to the reports. Note that this will be applied to all reports you're creating in this workflow.
Rename the reports if necessary.
Click 'Add' to create the report. The report will be placed within the session from which you initiated the creation of the report.
Condition summary
A condition summary is best suited for consistency and/or variability analysis. By selecting multiple conditions, you are able to create multiple condition summaries at the same time. You'll have the possibility to either create a report for each selected condition (select 'multiple', see the bottom right image below), or create one report with all selected trials from different conditions (select 'single', see the bottom middle image below).
Comparison
A comparison is best suited for analyzing differences between conditions and/or sessions. When creating a comparison report, all trials are included in one report, grouped per condition and session (see image below).
How to create reports automatically
This feature is optional and only visible to Enterprise customers with this feature enabled.
When working with a standard set of commonly required reports, you can streamline the process by using automatic report creation. This allows you to generate a predefined set of reports efficiently. These can include condition summaries, condition comparisons, and session comparison reports.
How to use the automatic report creation feature:
Click "Create interactive reports" with or without selecting trials/condition.
If you select no data, all data from all sessions will be included and a list with a predefined set of reports will be displayed.
If you selected trials/conditions: select the "Automatic" option (see image below).
You can add Reference data to the reports. Note that this will be applied to all reports you're creating in this workflow.
Rename the reports if necessary.
Click 'Add' to create the report(s). The report(s) will be placed within the session from which you initiated the creation of the report(s).
There is a maximum amount of characters allowed for the name of a report. If the name is too long, you are notified by an error message stating this information.
Adding reference data and other adjustments can also be done by going into editing mode within your report (open your report and click the 'Edit' button, see section Edit report).
Find your report within the session in the navigation menu, the subject home page, or the session home page, and click on ‘Edit’ to go into editing mode of your report (see image below). You will be able to enrich or make changes in the visualization of your report. Make sure to click ‘Save’ after changing anything in your report.
Any of these edits will only affect your current report. If you'd like to change your default report layout, please contact Moveshelf support.
Edit report name
On top in the editing mode you can change the name of your report. Please note that the report name has a limited amount of characters you can use. If the name is too long, you are notified by an error message stating this information.
Edit reference data
Use the dropdown under the header ‘References’ to add or change reference data in your report (see Reference data for more information).
Change report type
Change the way your data is represented by switching between a ‘Comparison’ and a ‘Condition Summary’. More information about the difference between these two types is given in the section above, Create report.
Change report template
Your project can have a configuration that defines your default report visualization, including which graphs are shown and hidden. When you have different workflows in which you require the visualization of different subsets of data, this is where you can switch between your predefined additional report templates. More information about report templates can be found in section Additional report template.
Customize your current template
At the bottom of the edit options there is a possibility to (de)select spatiotemporal parameters and graphs to create a concise overview of a report to show to a clinician.
Add notes
Under the header ‘Notes’ there is a text field where you can leave notes in your report.
Reports can be deleted on the session home page. To access the session home page, click on the session name either on the subject home page or in the navigation menu on the left.
On the session home page, you will see an overview of all uploaded sessions and created reports. To delete a report(s):
Select the report(s) you want to delete.
Click on the recycle bin icon to delete the selected report(s).
Reference data is based on (a selection of) your own data. It is possible to have multiple reference datasets in one project, like age grouped or matched by movement disorder. Reference data can be added to the report when creating it (for more information see Create report). Also after creating a report, you can add or change the reference data by using Edit report.
EMG reference data
There are two ways to visualize EMG reference data on Moveshelf:
Add your own EMG reference dataset to your Excel file to overlay the data in the EMG graphs on Moveshelf, just like we do for kinematics/kinetic graphs (see image below). This way you will be able to adjust or create multiple versions of your reference dataset.
Use Moveshelf's default EMG reference dataset, displaying normal timing of EMG activation at the bottom of the EMG graphs (see image below). Please contact Moveshelf support if you would like to have this reference dataset enabled in your project configuration.
Make sure you have created one or multiple report(s) on Moveshelf, as these are used as input for the Gait Word reports.
Navigate to the Session home page and make sure you're on the Dataset tab.
Open the 'Processors' sidepanel and select 'Create Gait Word Report' (see image).
Click 'Run'. The button will change to 'Requesting' with a spinning wheel. Please do not close the Moveshelf page or navigate away on the page until the Word reports appear (and 'Requesting' changes back to 'Run'). Once the reports are visible, you may leave the page, even if the reports are still processing.
Please be aware that creating the Gait Word reports may take a few minutes.
Note that EMG charts can be excluded from the Quantitative report by deselecting all 'EMG' options under "Data collected" in the "Session info" tab.
Gait Word reports input validation
If specific physical exam values are not formatted correctly, both Gait Word reports cannot be generated. A red error triangle will appear next to the reports in the "Gait Word reports" section (see image below). By clicking on the triangle, an error message detailing which value(s) are incorrectly formatted will be displayed. Once the formatting is corrected, you can retry generating the reports.
Download the Gait Word reports
You can download the Gait Word reports by clicking on the name, either on the subject homepage, session homepage, or navigation sidepanel.
Update the table of contents in Word
The first page of the Quantitative Report contains an empty field for a table of contents. After you have done your preferred edits in the Word document, you can update the table of contents by following these steps:
Right click on the table of contents field
Select 'Update Field'
Select 'Update entire table'
Click 'OK'
Order of Reports in the Quantitative Report
The order of reports in the Quantitative report will follow the order of reports set on Moveshelf.
While you can freely reorder reports on Moveshelf, ignoring report types if desired, the Word report will always group reports by type (Condition Summaries, Session Comparisons, and Condition Comparisons).
For more information about the default report order and how to reorder reports, see reorganize trials and reports.
Many settings in your project are customizable to match your preferences. The Moveshelf customer support team can apply these configurations to your project(s). Next to these project settings, you can further customize your graphs using a report template.
Below is an overview of the available customizable project settings.
Please contact Moveshelf support to help you with setting your preferences in your project configuration.
Setting
Applicable to
Explanation
Graph lines & 3D player colors
All graphs & 3D player
Color for left, right, neutral, and reference; applicable to all graphs, timebar events and 3D player.
Background color
All graphs
The background of all graphs can be set to either the default dark or a white background.
Force normalization
Force graphs
Force plate data can be visualized in absolute values (N), normalized to body weight (%BW) or normalized to body mass (N/kg). These options are only possible if the body mass is correctly provided, see section Vicon directory upload.
X-axis normalization
EMG / Force graphs in trials
EMG and force plate data can either be plotted against a time scale (image 1 and image 2) or normalized to gait cycle (image 3).
Raw / RMS EMG
EMG graphs
Option to show only raw and/or RMS. By default both are shown and can also be disabled temporarily by clicking in the graph's legend.
EMG consistency
Time-based EMG in trials
EMG graphs are shown by default as individual graphs. With an additional setting you can get an EMG graph type which overlays all EMG channels of one leg (e.g., Left) in one 'EMG consistency' graph (see this image). This can be useful for analyzing crosstalk and relative timing of activation patterns. When enabled, the EMG consistency graph is shown below the individual EMG graphs and can also be viewed in split screen.
Each project on Moveshelf can have a customized report template that determines the default display settings for reports. The report template can also be applied to trials. The Moveshelf customer support team can configure this report template in your project(s).
By default, these settings apply to all reports, but multiple report templates can be set up within a single project if needed.
This allows you to upload divergent versions of your usual data format specifications or apply alternative predefined subsets of graphs to visualize in your reports. More information can be found here: additional report template.
Below is an overview of the available customizable settings, what they apply to, and a brief explanation of each setting.
Please contact Moveshelf support to help you with setting your preferences in your report template.
Setting
Applicable to
Explanation
Naming
All graphs
Graph names and Y axis labels (e.g. Flexion / Extension).
Defined Y-axis limits
All graphs
Fixed Y axis limits can be specified for each graph. When viewing the data on Moveshelf you can then easily switch between fixed limits or automatically-adjusted limits that perfectly fits the data.
Show stance-to-swing transition line
All cycle-based graphs
If this setting in enabled, and the gait event 'Foot Off' is detected for all gait cycles in a C3D file, a vertical line is drawn in every cycle-based graph at the transition of stance to swing phase for each detected gait cycle.
Additional configurable group of graphs
All graphs
This feature allows you to group any graph together and create a new and customized data header with this content. For example, this feature can create a 'Sagittal overview' with sagittal kinematics, moments and powers for the hip, knee and ankle joints. This new data header shows up on top of the other data, above the data header of e.g. "Kinematics" and can also be selected to open in split screen.
Subset of graphs
All graphs
Only show a certain subset of graphs as default template in trials and/or reports. For example, this can be of used for hiding a grounding channel for EMG or channels that only contain zeros as a result of restricted degrees of freedom for a joint in its biomechanical model.
Subset of spatiotemporal parameters
Reports
Only show a certain subset of spatiotemporal parameters as default template in reports.
Left / right separation
EMG / Force graphs
To make the data more organized, EMG and force plate data can be plotted in separate graphs for the left and right leg (see image 1 and image 3 of the section above).
Organize EMG graphs per muscle
EMG graphs
This setting organizes EMG graphs by grouping left and right side graphs for each muscle.
On Moveshelf, a project generally has a customized trial and/or report template configured, which determines what is shown by default in the trials and/or reports (see the section report template above). This section describes additional report templates, which allows you to easily choose an alternative pre-set template to be applied to your reports. Examples of the possibilities and when this feature might be useful to you are stated below.
Please contact Moveshelf support if you would like to setup an additional template for your project.
With additional reports templates you are able to:
Apply predefined subsets of graphs to visualize in your reports. This could be useful when you measure data of different populations or pathologies in which you might only analyze certain graphs and/or use only a subset of EMG channels from your default protocol. With an additional report template you can define these subsets as a deviation from your default protocol and visualize only what is relevant by simply applying this template to your report.
Upload divergent versions of your usual data format specifications. This could be necessary when there is a change in your clinical protocol that results in different names of certain channels. Example: you might start to use different names for EMG channels. These different names could cause Moveshelf to not recognize them anymore and no graphs will be shown for these channels. By specifying these names in an additional report template you will be able to work with data from your previous and new/alternative protocol.
To change from your default report template to an additional one, choose one of the alternative report templates while creating a report, or by editing an already created report and choose a template in 'Report template', see also Edit report.
When viewing a trial or report, you can choose to visualize the data in split screen. Layout shortcuts can be created to have quick access to a certain split screen layout.
Note, layout shortcuts can only be opened once the trial/report is fully loaded.
Default layout shortcuts
If you wish to view the same split screen layout for each subject, contact Moveshelf support to set up default layout shortcuts in the project configuration. These layout shortcuts will then automatically appear in each trial and report for all subjects, under the header 'Layout shortcuts' (see image above). Note that default layout shortcuts cannot be deleted.
Saved layout shortcuts
With editing rights on Moveshelf (as an
editorAn editor is a member that has the rights to edit and view data (e.g., lab operators).
or
adminAn admin is a member that has the rights to add others to a project, delete the project, edit data, and view data.
), you can save a split screen layout, creating a layout shortcut in that specific trial or report. Any user visiting the same trial/report can see and open the saved layout shortcut(s).
To save a layout shortcut:
In a trial or report, select your preferred video and/or graphs and open split screen.
Click 'Save layout' on the top right, enter a name for this layout and click 'Save'.
To delete a saved layout shortcut:
Open the trial or report where you want to delete a previously saved layout.
Click the trash bin next to the layout to delete it.
On Moveshelf you can reorganize your trials and reports. First there is the opportunity to change the order of the conditions, secondly you can manually move specific trials to other or new conditions and lastly you can rearrange the order of reports. To reach these options, go to the session home page by clicking on the session name, either on the subject home page or in the navigation menu on the left (visible when looking at a session or trial data).
Default Report Order
By default, reports are grouped by report type and ordered alphabetically within each group. The default order of report types is as follows:
Condition Summaries
Session Comparisons
Condition Comparisons
Reorder conditions and reports
You can reorganize your conditions and reports by using the button 'Reorder':
Click on 'Reorder'.
In the pop-up window, drag the condition name or report to the desired position within its section. Conditions can only be reordered with other conditions, Interactive Reports with other Interactive Reports, and Gait Word Reports with other Gait Word Reports.
Click 'Save order' to confirm your changes.
Moving trials to other conditions
You can reorganize your trials by using the button 'Move to’:
Select all trials you want to include in a new or existing condition.
Click on ‘Move to’ and select a condition or create a new condition you want to move the files to.
This feature is currently only available for Vicon c3d files and mox files.
In Vicon Nexus you can enter the information for a good hit of the foot on the force plate by 'Left' or 'Right', or input 'invalid' in every trial. This will generate clean and recognizable patterns of force plate data on Moveshelf in case of a gait cycle analysis (see Vicon directory upload for more information).
But, you can also edit the Left/Right/Invalid context of the force plates by editing the trial on Moveshelf, follow the steps below on how to do that:
Open the trial on Moveshelf and click the ‘Edit’ button.
If force plate data is available in the trial, you will see a section on top of the screen that allows you to select and save the force plate context to the trial.
Once you have edited the force plate context in a trial, make sure to refresh the page to see the effect in your report, where this trial is included.
This feature is optional and only visible to Enterprise customers with this feature enabled.
Moveshelf supports the visualization of force vector overlays on top of videos for multiple file formats, including MoxieViewer (.mox), Noraxon (.c3d), and TEMPLO (.box) files. These overlays provide a graphical representation of forces measured during motion analysis.
For all supported formats, Moveshelf extracts force plate data, including force vector magnitude and direction, from the respective file. The system reads the calibration and positional information of the force plates and maps the force vectors onto the corresponding video frames. Using embedded metadata and Direct Linear Transformation (DLT) matrices where applicable, the force vectors are scaled and projected onto the videos to create overlays.
If the force overlay function is enabled for the user's project, the respective file (.box, .mox, .c3d) can be included in the directory upload folder or stored under a condition "Additional files" in a trial.
See the section Playback controls for more info on general viewing of data, including the automatic display over force overlays if this feature has been enabled and supported for your data format.
This feature is optional and only visible to Enterprise customers with this feature enabled.
If this feature is available for your organization, you can anonymize videos by processing them through the image recognition algorithm on Moveshelf that automatically blurs all faces clearly visible in the videos.
Select one or multiple trials that includes videos and click on << in the sidebar on the right to open a drop-down menu.
Select 'Face blurring' and click on ‘Run’.
You will see feedback of the stage that the trial is in. It will take a few minutes for the first trial to move from ‘Waiting' to ‘Blurring’.
Please don't access the respective trial when it has the status ‘Blurring’.
After processing, face blurring is applied to all faces clearly visible in the video.
Please note that, by default, the number of videos that can be processed using the face blurring feature is limited to 400 per month per organization. If you require a higher limit, please contact support@moveshelf.com
This feature is optional and only visible to Enterprise customers with this feature enabled.
With Moveshelf it is possible to connect movement analysis with existing clinical workflows, by integrating with your local clinical IT system(s), such as an Electronic Health Record (EHR). An integration with an EHR means there is a link between the patient in the EHR and on Moveshelf, based on standardized communication protocols for medical data called HL7 and FHIR. This section focuses on the operator workflow in case of an integration with your EHR.
Integration with an EHR system generally provides the best workflow when combined with Single Sign On, where the login credentials of your organization are used to log into both the EHR system as well as Moveshelf. This way, clinical personnel who are allowed access by your organization to view patient data on Moveshelf, will automatically be logged into Moveshelf when coming from the EHR.
Integrations with EHR systems can be designed and developed dependent on the hospital’s requirements. Exact interactions within the EHR software are in control of the wishes and capabilities of your organization and EHR provider’s capabilities. Below are examples of the currently implemented workflows. Please note that these workflows are not the only possible workflows, but merely examples.
HiX (ChipSoft)
A current implementation of a HiX integration contains the following steps for a lab operator from movement data acquisition to sharing the results in HiX, in order to provide the data and comparative overview to the treating clinical team. The steps below describe the workflow after the acquisition of movement data has been performed.
Sort and/or adjust the presentation of data if preferred, including creating reports.
In HiX, open the patient's file and navigate to 'Weblinks'. Here you can click a link to Moveshelf and immediately land on this patient's home page where you see an overview of all the patient's movement analysis sessions.
You can copy additional basic patient information from HiX into the subject info panel. To do this, enter the EHR ID of the patient in the text panel on the right side 'Search in HL7 FHIR' and click search. All the information available for this patient is displayed under 'Results'. Click the copy button next to this header to input this information in Moveshelf's subject information.
EPIC
An example of an integrated workflow with EPIC is an order based workflow with multiple automated steps. The steps below provide information for a basic understanding of the integration, with a focus on the workflow of a lab operator.
The clinician orders a movement analysis for a patient in EPIC.
As a lab operator, places an extra order for gait analysis in EPIC. This order is automatically completed, and initiates a search on Moveshelf for this patient or the creation of a new patient (subject) and a new session on Moveshelf. The order type and date will automatically be added as labels to a new session on Moveshelf.
Open the patient on Moveshelf by navigating to the url of Moveshelf for your organization: < organization >.moveshelf.com, and in Moveshelf, search for the subject using the EHR ID from EPIC.
Sort and/or adjust the presentation of data if preferred, including creating reports.
Click 'Publish' when the session is ready to be shared with the clinician/team responsible for treatment. This action will visualize a link to the specific patient in Moveshelf in the patient file in EPIC and allow viewers access.
Opening Moveshelf through the URL in the patient file in EPIC opens the application in protected mode where you have only access as a viewer and switching to another patient on Moveshelf is not possible. As an operator, the recommended workflow is to manually navigate to your Moveshelf domain easily by saving it as a bookmark in your browser.
Search Knowledge Base
Only users with the rights to create projects can see this button. In case you do not see the button, but you would like to create a project, contact Moveshelf support.
