Create a Setup Scene
In this step, 3D models of the bones and their markers will be imported into Maya. Then the XYZ coordinates of the markers, relative to the polygonal models of the bones, will be measured and saved as CTmarkerCoordinates. This step is done in Maya using the XROMM Maya Tools
- In Maya, go to file<import
- Make sure the file type is set to .obj, .ma or BestGuess click here if you have VRML models.
- select the file and click ok
- repeat for each model
There are two methods for calculating marker model coordinates
- vAvg – calculates centroid for each individual marker based on the average position of selected vertices.
- vAvg2 – breaks all unconnected elements into separate objects and automatically calculates the centroid of each element.
For both methods, import .obj files for the bones and the markers, and set up for easy marker selection (make the bones transparent and unable to be selected).
- Click the imp button on the XROMM Maya tools shelf.
- Click impObjs, Shift+select(pc) or command+select (mac) bone and marker models and open.
- Click Hshd on the shelf. In the "Create" window (bottom left) click Lambert to create a new shader (probably named Lambert2). On the right side of the screen, set the color, and drag the transparency slider towards the right. Minimize the hypershade window.
Select all bone models (but not the markers). Hit ctrl+h on the keyboard to hide all of the bones. Only the markers are showing.
- Select the marker object
- right click and select vertex from the marking menu
- drag select the vertices for a single marker
- click vAvg on the shelf bar or type vertAvg on the command line. You will get a window that looks like:
- Type in the number of markers you have and press enter. In the above example, we had 10 markers.
- Select the marker number from the list that corresponds to the vertices you selected and hit the "calculate centroid" button.
- A locator is created with the xyz coordinates of the marker centroid. It will be name "marker##" where ## is the number you typed.
- repeat for all markers
- (hint: if you need to see the bones to determine marker numbers Shift+h will unhide the bones) Export the CT marker locator data
- This step can be done in the vAvg window. Once you have selected all of the markers and created locators for them, the "export centroids" button will become black. Press this button and save the file it produces. If you closed the vAvg window, you can also export the marker locations by doing the following.
- select all of the locators that you just created. click the CTex
- With the bone models still selected, create and place them on a new layer using the button shown below. If you do not the layer editor, click the Channel Box/ Layer Editor tab on the right side of the screen.
- Click the blank 3rd box twice which changes to the letter R and the bone models become unselectable but still show smooth shading.
- Now you should be able to see and select the marker mesh through the transparent bone model.
, reopen the hypershade window, right click on the lambert2 icon and select Assign Material to Selection. Close the hypershade window. You should now be able to see your model markers through the transparent bones, however, it will still be difficult to select the marker models because the bone models are in the way.
For a single marker object: vAvg
Select the marker object.
Click vAvg on the XROMM tool shelf.
Right click-hold and select vertex from the marking menu
Drag your mouse over a single marker (selected vertices should become yellow).
In the Marker Name box, enter a name for the marker.
- Press the Calculate Centroid button and a locator will be created.
- Repeat steps 3 - 8 for each marker.
For all markers in a single object: vAvg2
Select the marker object.
Click Calculate Centroid
Click the Hgph button on the shelf. Note there are two groups created by vAvg two. The first group are the isolated meshes from the marker model. The second group are the calculated centroids with the suffix vAvg2.
- Renaming markers from vAvg2 is best done in the next step; CTexport.
Export the CT marker locator data
- Click the CTex from the XROMMtools Shelf, or type CTMexport in the MEL box
- Save the .csv file
- Save the scene. You will reference this for all animations involving this individual animal
Converting .wrl (VRML) models into Maya-friendly format (Windows only). Note: it is more convenient to export 3D models in .obj format from Amira (or Microscan Tools) because .obj files can be imported directly into Maya. These instructions are provided in case only VRML models are available.
If using older SmoothData MATLAB script, then Reset Bone element pivots(**this step omitted if using rigidBody MATLAB script)
- Select all marker locators for single bone (using shift select for multiple selection)
- Shift select the bone associated with the selected locators
- click the mvPv button on the XROMMtools shelf
- repeat for each bone
If using vAvg2, you may want to rename your markers. To do this, select the marker from the view window, hypergraph or All Locators list, type the new name in the Rename Centroid text field and click rename. The list will update with the new name for the object.
Select markers that you want to export in the left window and click Move Right. You should export marker sets for each rigid body as a single file for easier use with XMALab.
Click Export to .csv File.