You are viewing the documentation for OpenSim 3.x. Are you looking for the latest OpenSim 4.0 Documentation?

Marker Editor

The Marker Editor gives you access to the currently selected Marker in the navigator view. Markers are used by the Scale Tool to scale a generic model to fit a particular subject, and by the Inverse Kinematics Tool to solve for coordinate values corresponding to experimentally recorded marker positions. Markers can also be used to place landmarks on the model. The Marker Editor allows you to change the names of markers, their offsets, and the bodies to which they are attached.

In most cases, you will want to store a model's markers in a separate file. This allows you to use one musculoskeletal model with different marker sets. The Marker Editor is useful when you are first defining a marker set for a project, and for adjusting markers after the Scale Tool has placed them on a model.  

The topics covered in this section include:

The Marker Editor

The Marker Editor utilizes the common Property Editor (as of version 3.0) to do marker editing. 

The contents of the window when a marker "r_acromion" is selected (selection can be performed using any of the methods described in Property Editor ).

You can select and edit a single marker or multiple markers, as described in the previous section on the Property Editor. When a marker is selected, it is displayed in yellow on the 3D model, with a yellow line connecting it to the origin of the body to which it is attached.

Editing Markers

To change the name of a marker, left click in the Name text field (right column) and enter a new name.  To change the body to which the marker is attached, left click on the Body drop-down list and choose a new body.

Make sure the new name is not being used by another marker.

The Marker Editor does not have a mechanism for changing the weights of the markers because this functionality is provided by the various tools that use markers. For example, the Scale Tool and Inverse Kinematics Tool contain Weights panels for specifying the weight of each marker during the scaling or inverse kinematics process.

Moving Markers

There are two methods for moving markers. The first method is to move them interactively in the 3D View window.

  • Select the markers you want to move first (visit the Property Editor section for more information on selecting markers). 
  • Move the cursor over the selected marker, and press the left mouse button. While holding the button down, you can drag the marker within the plane of the screen. You will see the selected marker will move. 
  • To move the marker in a different plane, release the left mouse button, rotate the model view as desired, and then press the left mouse button on the selected marker to resume dragging. You will see the location updates in the Properties window while the marker is being dragged in the 3D view window.

The second method of moving markers is to type their exact XYZ offsets relative to the body that the Marker is attached to, into the number fields in the location property. For this method, the markers do not need to be selected in the 3D view, but you can only modify the location of the marker displayed in the Properties window. Click on the appropriate field, and type in the desired value as three space separated numbers. These offsets are expressed in the reference frame of the body to which the marker is attached, which is shown above the location property.

One convenient function carried over from the old Marker Editor is that when you change the name of the body that a marker is attached to, it stays in the same location in 3D space. This provides for a convenient method to map a location in 3D specified in one body frame to another body frame.

Adding and Deleting Markers

To add markers to the current model you need to use the Navigator window. Click on the plus (plus) sign next to the name of the current model to display its components, then right-click on the Markers category and choose Add New from the drop-down menu. A new marker attached to the ground body will be added to the model and made selected in the "Properties" window. Then you can change the name of the new marker (Default NewMarker_xx), the location and/or the body that the marker is attached to.

To delete a marker,  select Delete from the popup menu of the marker in the Navigator window. This will delete only the current marker, not any other markers that are selected in the 3D model window.

Saving Markers to File and Loading from File

You can save the current set of markers in the model into a separate .xml file for later use in tools or to use the marker set with a different model.

  • Right Click on the Markers node in the Navigator and select "Save to file...". This will save the markers into a separate xml file.
  • Select Load from file... to add a marker set from an existing .xml file to the current model.

OpenSim is supported by the Mobilize Center , an NIH Biomedical Technology Resource Center (grant P41 EB027060); the Restore Center , an NIH-funded Medical Rehabilitation Research Resource Network Center (grant P2C HD101913); and the Wu Tsai Human Performance Alliance through the Joe and Clara Tsai Foundation. See the People page for a list of the many people who have contributed to the OpenSim project over the years. ©2010-2024 OpenSim. All rights reserved.