CRITICAL UPDATE: Use new XMALab software for marker-based XROMM, including Undistortion, Calibration, Marker Tracking, and Rigid Bodies.
XMALab replaces MATLAB XrayProject. See Bitbucket XMALab wiki for XMALab User Manual (not this wiki). Use 3D world View in XMALab to check calibration.
If Xcam camera panel is not automatically selected, If the images do not display, try this:
Import x-ray videos into Maya with correct x-ray camera perspectives
If Xcam camera panel is not automatically selected,
If the images do not display, try this:
Import XYZ coordinates into Maya
- Select imp from the XROMM toolshelf in Maya.
- Browse to File
- If you are checking Marker Tracking (i. e. Digitizing), select the [Your prefix]xyzpts.csv file that was generated from marker tracking.
- If you are checking Calibration, select the framspec.csv file for the type of cube you used. This file contains the known locations of the beads in the cube. If you don't have this file, it can be downloaded.
- Select xyz or xyz Translation under Data Type, depending on the version you have.
- Select new sphere or new spheres under Object Options, depending on the version you have.
- You can change New Object Scale to something smaller to make sure the markers in the Xray Image will show up behind the imported points. (e. g. 0.5 or 0.1)
- If you are importing unmoving markers (such as for checking Calibration), uncheck Rows are Time Series. Otherwise leave it checked.
- Other options usually stay as defaulted:
- type global
- column headers in row 1
- transformation type between rows absolute
- New object name prefix from: custom (obj)
- Click Import
- Close the window
Understanding Xray Camera Setups
Once you have imported one or more Xray cameras into Maya, you can use them to check that your data makes sense.
- To look through either of the Xray cameras, select Panels -> Perspective -> [Desired camera]
- When looking through these perspectives, imported Xray marker coordinates, cube marker coordinates, animation objects etc. should line up with the Xray behind them. The following are examples of what digitized markers and animated bones should look like.
- If the cube marker coordinates, animation objects etc. don't line up with the Xray image behind them, there is a mistake somewhere. You should go back and check that you have done everything correctly so far.
- Looking through the Persp camera (Panels -> Perspective -> Persp) you should also be able to toggle around the screen and see the whole scene as it was set up in the Xray lab. The Xray emitters will be indicated by little green camera animations, and the image intensifiers are where the Xray images appear.
- If the scene seems incorrect (Especially if the cube marker coordinates, animation objects etc. are behind the Xray plane, rather than between the Xray camera and the Xray image) it is likely that something went wrong, and you should check that you have done everything correctly so far.
- If you imported an animation or image sequence, press play in the lower right corner of the screen to see the whole animation (orange circle). The cube marker coordinates, animation objects, etc. should continue to line up with the Xray Camera behind them.
- The animation range you wish to see must fit within the time in the Blue and Yellow boxes, where Blue is the start frame and Yellow is the end frame.
- Understanding how to play your animation
- The Green and Red boxes are the whole range that the animation sequence can currently be played from.
- To play only part of that, you can change the numbers in the Blue and Yellow boxes.
- You can also drag the Purple dots to change the current segment being played (Blue and Yellow boxes).
- The white number 90 and the 90 in the box indicate the current frame.
- To change your view, click PSDR in the XROMM shelf.
- To zoom in and out, click and hold the left mouse button and move your mouse left and right.
- To pan, click and hold ctrl + left mouse button, and move the mouse left, right, up, or down.
- To change the transparency of a bone model or markers, click and hold the middle mouse button, and move the mouse left and right.
- If you wish to view the scene through both Xray Cameras at once,
- Go to Panels -> Panel Editor -> Edit Layouts -> two planes side by side
- Use Panels -> Perspective and select one of the two x-ray cams for each panel.