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/26 20:19] – created sgrangerother:amass:tutorials:getting_started [2024/07/17 15:44] (current) – created sgranger
Line 1: Line 1:
-====== Getting_Started ======+====== Getting Started ======
  
 ==== Overview ==== ==== Overview ====
Line 8: 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 39: 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.
Line 49: 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:
Line 60: 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 ===
Line 71: 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 ===
Line 81: 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 ===
Line 90: 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}}
  
 \\ \\
Line 117: 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 ====
Line 133: 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 149: 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 156: 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 166: 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 185: 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 197: 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 228: 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 239: 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 252: 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 259: 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 267: 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.
other/amass/tutorials/getting_started.1719433168.txt.gz · Last modified: 2024/06/26 20:19 by sgranger