HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » other » AMASS » tutorials » Getting Started
other:amass:tutorials:getting_started

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
other:amass:tutorials:getting_started [2024/06/19 13:53] – created sgrangerother:amass:tutorials:getting_started [2024/07/17 15:44] (current) – created sgranger
Line 1: Line 1:
-===== Overview =====+====== Getting Started ====== 
 + 
 +==== Overview ====
  
 Here is how a new user to AMASS/Capture2D would use the system. Here is how a new user to AMASS/Capture2D would use the system.
Line 6: Line 8:
  
   - Once the **AMASS Wand** (pictured below) arrives in the mail, it is unfolded and the calibration process can start. NOTE: make sure the little black dots on each marker are pointing down, towards the handle. To calibrate a volume, you get all the cameras plugged in and start Capture2D. You then **Connect** to the cameras and set the duration to 20 seconds (or more if lots of cameras are used). Finally, click **Start Recording** and wave the wand all around the capture volume - high, low, spinning, waving, and near the floor.\\   - Once the **AMASS Wand** (pictured below) arrives in the mail, it is unfolded and the calibration process can start. NOTE: make sure the little black dots on each marker are pointing down, towards the handle. To calibrate a volume, you get all the cameras plugged in and start Capture2D. You then **Connect** to the cameras and set the duration to 20 seconds (or more if lots of cameras are used). Finally, click **Start Recording** and wave the wand all around the capture volume - high, low, spinning, waving, and near the floor.\\
-{{Wand2.jpg}}+{{:Wand2.jpg}}
   - Save the .cen recording (giving it a meaningful name), and in AMASS, click the **Refresh** button so that the new file shows up. Then click the **Calibrate** button. If it doesn't work, collect new data and try again until is does. You simply can't proceed until you have a calibrated volume. There are also troubleshooting pages in the wiki if you have problems. AMASS automatically recognizes the markers on the wand and can linearize the camera lenses, calculates a residual, and calibrates the entire motion capture volume.   - Save the .cen recording (giving it a meaningful name), and in AMASS, click the **Refresh** button so that the new file shows up. Then click the **Calibrate** button. If it doesn't work, collect new data and try again until is does. You simply can't proceed until you have a calibrated volume. There are also troubleshooting pages in the wiki if you have problems. AMASS automatically recognizes the markers on the wand and can linearize the camera lenses, calculates a residual, and calibrates the entire motion capture volume.
   - Once the calibration works, click the **Apply** button in the Calibration report screen.   - Once the calibration works, click the **Apply** button in the Calibration report screen.
Line 12: Line 14:
   - Now you can go back to Capture2D and collect subject data for analysis. The tutorial illustrates how to process that data using the track and Identify buttons in AMASS.   - Now you can go back to Capture2D and collect subject data for analysis. The tutorial illustrates how to process that data using the track and Identify buttons in AMASS.
  
-===== Sample Data =====+==== Sample Data ====
  
 Get the [[[https://www.has-motion.com/download/AMASS/AMASS_Sample.zip|AMASS Sample Files]]] here. Get the [[[https://www.has-motion.com/download/AMASS/AMASS_Sample.zip|AMASS Sample Files]]] here.
  
-===== Getting Started with AMASS =====+==== Getting Started with AMASS ====
  
 This section provides a brief tutorial of how to use AMASS and the steps necessary to generate 3D data from motion capture data files. It presumes that AMASS is already installed. This section provides a brief tutorial of how to use AMASS and the steps necessary to generate 3D data from motion capture data files. It presumes that AMASS is already installed.
Line 37: Line 39:
 //Note: AMASS starts and loads the last project it was working on. If there was no previous project, or it was moved, then the following screen appears.// //Note: AMASS starts and loads the last project it was working on. If there was no previous project, or it was moved, then the following screen appears.//
  
-{{a1.png}}+{{:a1.png}}
  
 Click “Open an Existing Project” and select the sample project file (project.prj) from the files you just installed to begin. Click “Open an Existing Project” and select the sample project file (project.prj) from the files you just installed to begin.
  
-===== Step 1: Project Control =====+==== Step 1: Project Control ====
  
 If the Project name is not Project, click on **Open…** and navigate to the samples folder. This section duplicates much of the [[Other:AMASS:Tutorials:Installation_|installation]] information, but goes into more detail about the options. If the Project name is not Project, click on **Open…** and navigate to the samples folder. This section duplicates much of the [[Other:AMASS:Tutorials:Installation_|installation]] information, but goes into more detail about the options.
Line 47: Line 49:
 Make sure the Folder box in the bottom left of the screen points to the sample data. Make sure the Folder box in the bottom left of the screen points to the sample data.
  
-{{a2.png}}+{{:a2.png}}
  
 In the Project Section click on the **Edit** button and verify that the parameters have the following entries: In the Project Section click on the **Edit** button and verify that the parameters have the following entries:
  
-==== Input Tab ====+=== Input Tab ===
  
 This tab set AMASS input data format options. No need to change anything. This tab set AMASS input data format options. No need to change anything.
Line 58: Line 60:
   * ViewCen = Checked (to view centroids meaning to actually see the targets/markers)   * ViewCen = Checked (to view centroids meaning to actually see the targets/markers)
  
-{{a3.png}}+{{:a3.png}}
  
-==== Calibrate Tab ====+=== Calibrate Tab ===
  
 This tab set AMASS volume calibration options. This tab set AMASS volume calibration options.
Line 69: Line 71:
 Assuming the file location changed, click **Browse…** and navigate to select the L-Frame file. This file identifies your L-Frame and where the markers are located on it. The sample is for a NaturalPoint frame. Assuming the file location changed, click **Browse…** and navigate to select the L-Frame file. This file identifies your L-Frame and where the markers are located on it. The sample is for a NaturalPoint frame.
  
-{{a4.png}}+{{:a4.png}}
  
-==== Track Tab ====+=== Track Tab ===
  
 This tab set AMASS target tracking options. This tab set AMASS target tracking options.
Line 79: Line 81:
 This is not critical, since when you create a new calibration file (part of the tutorial) you click an "Apply" button that will overwrite whatever is here. This is not critical, since when you create a new calibration file (part of the tutorial) you click an "Apply" button that will overwrite whatever is here.
  
-{{a5.png}}+{{:a5.png}}
  
-==== Identify Tab ====+=== Identify Tab ===
  
 This tab set AMASS target naming and identification options. No need to change anything unless the file location changed. This tab set AMASS target naming and identification options. No need to change anything unless the file location changed.
Line 88: Line 90:
   * Link File = can be blank. It is unused now, but will be needed for the automatic tracking feature (coming soon)   * Link File = can be blank. It is unused now, but will be needed for the automatic tracking feature (coming soon)
  
-{{a6.png}}+{{:a6.png}}
  
 \\ \\
 Click **OK** to close the AMASS Parameters window. Click **OK** to close the AMASS Parameters window.
  
-===== Step 2: Collecting Data =====+==== Step 2: Collecting Data ====
  
 This part assumes you already set up your camera system. Clicking the “Capture” button in AMASS launches the Capture2D program to connect to NaturalPoint cameras and perform a data collection. Use the Advanced button to set non-traditional settings on the cameras. The 3D View tab in newer versions of Capture2D are for force plate data. This part assumes you already set up your camera system. Clicking the “Capture” button in AMASS launches the Capture2D program to connect to NaturalPoint cameras and perform a data collection. Use the Advanced button to set non-traditional settings on the cameras. The 3D View tab in newer versions of Capture2D are for force plate data.
Line 115: Line 117:
 Note: If systems other than NaturalPoint are used, a different capture program is needed. Note: If systems other than NaturalPoint are used, a different capture program is needed.
  
-{{a7.png}}+{{:a7.png}}
  
-===== Step 3: Calibrating the Volume =====+==== Step 3: Calibrating the Volume ====
  
 AMASS requires the motion capture volume be properly calibrated before ANY processing can be done. If someone bumps a camera or anything moves or changes, your volume must be re-calibrated. AMASS requires the motion capture volume be properly calibrated before ANY processing can be done. If someone bumps a camera or anything moves or changes, your volume must be re-calibrated.
Line 131: Line 133:
 Once the data is available, like our sample calibration file, here is how it is processed: Once the data is available, like our sample calibration file, here is how it is processed:
  
-{{a8.png}}+{{:a8.png}}
  
   - First, make sure the **CEN** radio button at the bottom of the AMASS window is selected.   - First, make sure the **CEN** radio button at the bottom of the AMASS window is selected.
Line 147: Line 149:
 You should be able to get considerably better results in your own lab. This sample data was not collected carefully, and the cameras were simply set up on tripods in a random fashion as a system test. You should be able to get considerably better results in your own lab. This sample data was not collected carefully, and the cameras were simply set up on tripods in a random fashion as a system test.
  
-{{a10.png}}+{{:a10.png}}
  
 \\ \\
Line 154: Line 156:
   * OPTIONAL step -- To view ANY centroid file (to validate that it looks OK), click the ViewCen button to launch the Centroid Viewer window. You can click each of the cameras views (right panel) and play the data (bottom controls) from each camera in the viewer.   * OPTIONAL step -- To view ANY centroid file (to validate that it looks OK), click the ViewCen button to launch the Centroid Viewer window. You can click each of the cameras views (right panel) and play the data (bottom controls) from each camera in the viewer.
  
-{{a9.png}}+{{:a9.png}}
  
 If open, CLOSE the ViewCen window. If open, CLOSE the ViewCen window.
Line 164: Line 166:
 EXTRA Information: EXTRA Information:
  
-{{a11.png}}+{{:a11.png}}
  
 To view the calibration report screen at any time: To view the calibration report screen at any time:
Line 172: Line 174:
   - Click the **ViewLin** button   - Click the **ViewLin** button
  
-===== Step 4: Tracking Targets =====+==== Step 4: Tracking Targets ====
  
 Once the volume has been calibrated, AMASS will then allow the processing of data collected in that volume. For this example, a Static trial and a Movement trial were already collected, and now we can process the data. Once the volume has been calibrated, AMASS will then allow the processing of data collected in that volume. For this example, a Static trial and a Movement trial were already collected, and now we can process the data.
Line 183: Line 185:
   - Click the **Track** button (We skip calibrate button since that is done.)   - Click the **Track** button (We skip calibrate button since that is done.)
  
-{{a12.png}}+{{:a12.png}}
  
 The result of the tracking process is a 3D marker segments file. This is documented on the wiki, but as a rule of thumb, the more long lines across the screen, the better. Each segment track is given a different color. The result of the tracking process is a 3D marker segments file. This is documented on the wiki, but as a rule of thumb, the more long lines across the screen, the better. Each segment track is given a different color.
Line 195: Line 197:
 After you close the ViewSeg display the newly created .seg file is saved and automatically selected in the AMASS window. Also, the Identify and ViewLin functions become enabled. We can now proceed to identify the specific markers in the selected .seg file. After you close the ViewSeg display the newly created .seg file is saved and automatically selected in the AMASS window. Also, the Identify and ViewLin functions become enabled. We can now proceed to identify the specific markers in the selected .seg file.
  
-{{a13.png}}+{{:a13.png}}
  
 \\ \\
Line 203: Line 205:
  
  
-===== Step 5: Identify Targets =====+==== Step 5: Identify Targets ====
  
 Once segment tracking is complete, AMASS enables the Identify button. AMASS should now have the SEG radio button selected and the Static-001.seg file should be highlighted. Once segment tracking is complete, AMASS enables the Identify button. AMASS should now have the SEG radio button selected and the Static-001.seg file should be highlighted.
Line 226: Line 228:
 Now we will identify the markers. There are two methods for assigning marker identifications to the segments. The simplest approach is a one-to-one marking. Now we will identify the markers. There are two methods for assigning marker identifications to the segments. The simplest approach is a one-to-one marking.
  
-{{a14.png}}+{{:a14.png}}
  
 \\ \\
Line 237: Line 239:
   - Click the marker and it will get assigned. The marker will turn yellow, and the name will appear when the mouse hovers over it. NOTE: double-clicking on the marker will clear an assignment (in case you mislabel one). Beware – double-clicking an unassigned marker hides it (for spurious reflections). The Unhide button on the left can bring it back.   - Click the marker and it will get assigned. The marker will turn yellow, and the name will appear when the mouse hovers over it. NOTE: double-clicking on the marker will clear an assignment (in case you mislabel one). Beware – double-clicking an unassigned marker hides it (for spurious reflections). The Unhide button on the left can bring it back.
  
-{{a15.png}}+{{:a15.png}}
  
 Now, to speed up the process, we can label a group of markers at once. Now, to speed up the process, we can label a group of markers at once.
Line 250: Line 252:
 NOTE: Automatic marker identification is possible (and in the next release), but it still requires a setup process and verification step. Automatic identification is a tremendous time saving option, but not a replacement for data validation. NOTE: Automatic marker identification is possible (and in the next release), but it still requires a setup process and verification step. Automatic identification is a tremendous time saving option, but not a replacement for data validation.
  
-{{a16.png}}+{{:a16.png}}
  
 \\ \\
Line 257: Line 259:
   * Click in the area to the left of the red bar (the frame indicator) – at the bottom pane of the screen. AMASS will highlight the next unidentified marker like a blue star, and simultaneously highlight the marker names on the right.   * Click in the area to the left of the red bar (the frame indicator) – at the bottom pane of the screen. AMASS will highlight the next unidentified marker like a blue star, and simultaneously highlight the marker names on the right.
  
-{{a17.png}}+{{:a17.png}}
  
   * Click the R_THIGH label on the right, and the program will assign the name and automatically move to the next marker. (If it does not move automatically, just click again in to the left of the frame indicator. This happens because when you click there, it moves the frame too, and the “next” markers may already be identified.)   * Click the R_THIGH label on the right, and the program will assign the name and automatically move to the next marker. (If it does not move automatically, just click again in to the left of the frame indicator. This happens because when you click there, it moves the frame too, and the “next” markers may already be identified.)
Line 265: Line 267:
 //NOTE: You will only see the label names when the mouse is over the marker - we PhotoShopped them in here...// //NOTE: You will only see the label names when the mouse is over the marker - we PhotoShopped them in here...//
  
-{{a18.png}}+{{:a18.png}}
  
 Finally, we need to enhance and validate the result. Finally, we need to enhance and validate the result.
Line 277: Line 279:
 Save the identifications you have done by writing them back into the seg file by clicking the Save ID’s button on the right. WARNING!! All of the label identifications will be LOST if you do not save them. However, it is the c3d file that needs them more than the seg file. Chances are you will not ever need to relabel a file once written to c3d format. Save the identifications you have done by writing them back into the seg file by clicking the Save ID’s button on the right. WARNING!! All of the label identifications will be LOST if you do not save them. However, it is the c3d file that needs them more than the seg file. Chances are you will not ever need to relabel a file once written to c3d format.
  
-===== Summary =====+==== Summary ====
  
 That finishes the tutorial. Once a volume is calibrated, markers can be tracked and identified, and then the result saved in c3d format for later analysis. That finishes the tutorial. Once a volume is calibrated, markers can be tracked and identified, and then the result saved in c3d format for later analysis.
other/amass/tutorials/getting_started.1718805232.txt.gz · Last modified: 2024/06/19 13:53 by sgranger