HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » other » capture2d » Documentation
other:capture2d:documentation

Differences

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

Link to this comparison view

Next revision		Previous revision
other:capture2d:documentation [2024/06/14 17:19] – created sgrangerother:capture2d:documentation [2024/07/17 15:44] (current) – created sgranger
Line 1: Line 1:
-|**Language:**|** English**  • [[index.php?title=Capture2D_Documentation/fr&action=edit&redlink=1|français]] • [[index.php?title=Capture2D_Documentation/it&action=edit&redlink=1|italiano]] • [[index.php?title=Capture2D_Documentation/pt&action=edit&redlink=1|português]] • [[index.php?title=Capture2D_Documentation/es&action=edit&redlink=1|español]] ****|+====== Documentation ======
  
-|===== Contents =====\\ \\ \\ \\ * [[#Overview|1 Overview]]\\ * [[#The_Capture2D™_Interface|2 The Capture2D™ Interface]]\\ * [[#Clients|3 Clients]]\\ * [[#Settings|4 Settings]]\\   * [[#Stream|4.1 Stream]]\\   * [[#Display|4.2 Display]]\\   * [[#Record|4.3 Record]]\\   * [[#Save_Options_and_Default|4.4 Save Options and Default]]\\   * [[#Help_&_About|4.5 Help & About]]\\ * [[#Capture_Comments|5 Capture_Comments]]\\ * [[#Recording_Data|6 Recording Data]]\\   * [[#Connecting_to_Cameras|6.1 Connecting to Cameras]]\\   * [[#Where_to_Save_on_Disk|6.2 Where to Save on Disk]]\\   * [[#Recording_Data_2|6.3 Recording_Data]]\\   * [[#Playback|6.4 Playback]]\\   * [[#Calibration|6.5 Calibration]]\\     * [[#Motion_Trial_versus_Calibration_Trial|6.5.1 Motion Trial versus Calibration Trial]]\\     * [[#Calibration_Wand|6.5.2 Calibration Wand]]\\     * [[#Reference_Markers|6.5.3 Reference Markers]]\\   * [[#Capturing_Motion_Trials|6.6 Capturing Motion Trials]]| +===== Overview =====
- +
-====== Overview ======+
  
 Capture2D™ is a desktop application used for recording and saving 2-D motion data from Natural Point Inc. camera systems. The data is stored in the [[Other:Report3D:Documentation:Centroid_Files|centroid (*.cen)]] file format, developed by Dr. Andrew Dainis. Capture2D™ is a desktop application used for recording and saving 2-D motion data from Natural Point Inc. camera systems. The data is stored in the [[Other:Report3D:Documentation:Centroid_Files|centroid (*.cen)]] file format, developed by Dr. Andrew Dainis.
  
-While Capture2D™ can be used independently to collect and store 2-D centroid data, Capture2D™ is designed to integrate seamlessly with the Ad Tech™ motion analysis software system (AMASS™). AMASS™, also developed by Dr. Dainis, takes 2-D centroid input files and provides volume calibration, segment tracking and marker labeling and ultimately produces C3D data files. C-Motion™'s flagship product [[[https://www.c-motion.com/products/Visual3D|Visual3D™]]] reads C3D files and provides extensive modeling and analysis tools for motion capture data. Capture2D™ can be launched directly from the [[|AMASS™ Shell]] using the Capture2D button.+While Capture2D™ can be used independently to collect and store 2-D centroid data, Capture2D™ is designed to integrate seamlessly with the Ad Tech™ motion analysis software system (AMASS™). AMASS™, also developed by Dr. Dainis, takes 2-D centroid input files and provides volume calibration, segment tracking and marker labeling and ultimately produces C3D data files. C-Motion™'s flagship product [[[https://www.c-motion.com/products/Visual3D|Visual3D™]]] reads C3D files and provides extensive modeling and analysis tools for motion capture data. Capture2D™ can be launched directly from the [[Other:AMASS:Documentation:Shell|AMASS™ Shell]] using the Capture2D button.
  
 Capture2D™ provides support for the following [[http://www.naturalpoint.com/|NaturalPoint™]] [[http://www.naturalpoint.com/optitrack/|OptiTrack™]] camera systems: Capture2D™ provides support for the following [[http://www.naturalpoint.com/|NaturalPoint™]] [[http://www.naturalpoint.com/optitrack/|OptiTrack™]] camera systems:
Line 48: Line 46:
 During the initial set up we highly recommend that you toggle the Save Data as CSV file and Save Settings check boxes for all initial captures. Should you require C-Motion's help with set up or problem solving we will require the problematic data as well as a copy of the settings .xml file and .csv files for each of the recordings. During the initial set up we highly recommend that you toggle the Save Data as CSV file and Save Settings check boxes for all initial captures. Should you require C-Motion's help with set up or problem solving we will require the problematic data as well as a copy of the settings .xml file and .csv files for each of the recordings.
  
-====== The Capture2D™ Interface ======+===== The Capture2D™ Interface =====
  
 The user interface to Capture2D™ consists of a main application window and a Settings dialog. The user interface to Capture2D™ consists of a main application window and a Settings dialog.
Line 54: Line 52:
 The main application window is modeless (i.e., you do not need to press an OK or Apply button for changes to take effect.) Where as the Settings dialog is modal (i.e., you must press the Apply button in order for changes to take effect.) The main application window is modeless (i.e., you do not need to press an OK or Apply button for changes to take effect.) Where as the Settings dialog is modal (i.e., you must press the Apply button in order for changes to take effect.)
  
-[[File:Capture_2D_start_up_screen.png|{{/images/thumb/0/0b/Capture_2D_start_up_screen.png/550px-Capture_2D_start_up_screen.png?550x408}}]]+{{:Capture_2D_start_up_screen.png}}
  
-====== Clients ======+===== Clients =====
  
 The clients button indicates which client programs (such as AMASS) are currently connected to Capture2D. Thus when Capture2D is streaming to AMASS, AMASS will appear as a client in the client window. This function is not currently operational, as such the client window remains blank. The clients button indicates which client programs (such as AMASS) are currently connected to Capture2D. Thus when Capture2D is streaming to AMASS, AMASS will appear as a client in the client window. This function is not currently operational, as such the client window remains blank.
  
-====== Settings ======+===== Settings =====
  
-[[File:Capture_2D_settings.png|{{/images/e/e7/Capture_2D_settings.png?380x311}}]]+{{:Capture_2D_settings.png}}
  
-=== Stream ===+== Stream ==
  
 The Stream portion of the settings dialogue allows you to control the data that is coming in such as Thread Priority and Thread Sleep Time. The Stream portion of the settings dialogue allows you to control the data that is coming in such as Thread Priority and Thread Sleep Time.
Line 71: Line 69:
 The code that acquires frames operates in a separate thread of execution (much like a separate program). Each thread (or program) on a computer has a priority. In fact, if you start the Windows task manager (right click the Task bar at the bottom of the screen) you'll see, under the processes tab, that you can view and set the "priority" of any program. Normal Priority is usually fine for most threads (and programs). The code that acquires frames operates in a separate thread of execution (much like a separate program). Each thread (or program) on a computer has a priority. In fact, if you start the Windows task manager (right click the Task bar at the bottom of the screen) you'll see, under the processes tab, that you can view and set the "priority" of any program. Normal Priority is usually fine for most threads (and programs).
  
-[[File:thread_priority.png|{{/images/8/8c/thread_priority.png?151x24}}]]+{{:thread_priority.png}}
  
 **Thread Sleep Time Preference**\\ **Thread Sleep Time Preference**\\
Line 80: Line 78:
 It is likely that these features will be either hidden or removed at some point as this level of user control is not that useful now that the frame acquisition code has been refined. It is likely that these features will be either hidden or removed at some point as this level of user control is not that useful now that the frame acquisition code has been refined.
  
-[[File:threadsleep.png|{{/images/5/5e/threadsleep.png?148x26}}]]+{{:threadsleep.png}}
  
-=== Display ===+== Display ==
  
 The display portion of the settings dialogue allows you to control the program outputs by personalizing the graphics. The display portion of the settings dialogue allows you to control the program outputs by personalizing the graphics.
  
-[[File:Display_settings.png|{{/images/5/5e/Display_settings.png?156x107}}]]+{{:Display_settings.png}}
  
 **Text Size**\\ **Text Size**\\
Line 97: Line 95:
 The draw empty frames checkbox tells the program that when the box is checked if there are no new frames when it is time for the graphics to redraw to leave the previous graphics on the screen. If the box is not checked then if there is no new data then graphics will not be drawn. Leaving the checkbox checked will result in smoother graphics however, you will have no visual indication that frames may be missing. The draw empty frames checkbox tells the program that when the box is checked if there are no new frames when it is time for the graphics to redraw to leave the previous graphics on the screen. If the box is not checked then if there is no new data then graphics will not be drawn. Leaving the checkbox checked will result in smoother graphics however, you will have no visual indication that frames may be missing.
  
-=== Record ===+== Record ==
  
 The record portion of the settings dialogue controls record function which allows for signal when recordings begin and end as well as saving preferences. The record portion of the settings dialogue controls record function which allows for signal when recordings begin and end as well as saving preferences.
  
-[[File:Capture_2D_record_settings.png|{{/images/1/16/Capture_2D_record_settings.png?180x192}}]]+{{:Capture_2D_record_settings.png}}
  
 **Countdown**\\ **Countdown**\\
Line 121: Line 119:
 The beep after save checkbox gives a beep when the file has successfully been saved. This allows a single user who is the capture volume to know that the recording has stopped even though they may not be able to see the computer screen. The beep after save checkbox gives a beep when the file has successfully been saved. This allows a single user who is the capture volume to know that the recording has stopped even though they may not be able to see the computer screen.
  
-=== Save Options and Default ===+== Save Options and Default ==
  
 **Save Settings File**\\ **Save Settings File**\\
Line 145: Line 143:
  
  
-===== Help & About =====+==== Help & About ====
  
 The help button at the bottom of the Capture2D pages will open this wiki page in order to provide information on the layout and functions of Capture2D. The about button will provide the version and release date of your current software. Furthermore, it contains copyright information and contact information should you desire further support. The help button at the bottom of the Capture2D pages will open this wiki page in order to provide information on the layout and functions of Capture2D. The about button will provide the version and release date of your current software. Furthermore, it contains copyright information and contact information should you desire further support.
  
-[[File:AboutCapture_2D_window.png|{{/images/e/e7/AboutCapture_2D_window.png?289x365}}]]+{{:AboutCapture_2D_window.png}}
  
-====== Capture_Comments ======+===== Capture_Comments =====
  
 Comments can be added to .cen files with the 'Edit Comment' button before or after the recording. Comments can be added to .cen files with the 'Edit Comment' button before or after the recording.
  
-[[File:Capture_Browse.jpg|{{/images/4/41/Capture_Browse.jpg?225x61}}]]+{{:Capture_Browse.jpg}}
  
-====== Recording Data ======+===== Recording Data =====
  
-===== Connecting to Cameras =====+==== Connecting to Cameras ====
  
 Connect to the cameras by selecting the Connect Button. Connect to the cameras by selecting the Connect Button.
  
-[[File:CaptureConnectButton.jpg|{{/images/c/c4/CaptureConnectButton.jpg?92x58}}]]+{{:CaptureConnectButton.jpg}}
  
 When the cameras are connected, the Connect button becomes a Disconnect button. When the cameras are connected, the Connect button becomes a Disconnect button.
  
-[[File:CaptureDisconnectButton.jpg|{{/images/c/c4/CaptureDisconnectButton.jpg?102x62}}]]+{{:CaptureDisconnectButton.jpg}}
  
   * Currently Capture2D™ supports OptiTrack FLEX:100 (R1 and R2) cameras from [[[http://www.naturalpoint.com|Natural Point Inc.]]] C-Motion, Inc., does not distribute the Natural Point software, so it is important that the user download and install the latest [[[http://www.naturalpoint.com/optitrack/downloads/developer-tools.html#camera-sdk|camera drivers from Natural Point Inc.]]].   * Currently Capture2D™ supports OptiTrack FLEX:100 (R1 and R2) cameras from [[[http://www.naturalpoint.com|Natural Point Inc.]]] C-Motion, Inc., does not distribute the Natural Point software, so it is important that the user download and install the latest [[[http://www.naturalpoint.com/optitrack/downloads/developer-tools.html#camera-sdk|camera drivers from Natural Point Inc.]]].
Line 173: Line 171:
   * Please let us know about other camera systems of interest as this will help guide future development.   * Please let us know about other camera systems of interest as this will help guide future development.
  
-===== Where to Save on Disk =====+==== Where to Save on Disk ====
  
 Use the browse button to select a good location in which to store your cen files. We highly recommend that you use a separate folder for each subject and for each session that the subject completes. The default path is the Capture2D™ application folder, which isn't writable on Windows 7 and isn't a smart place to store data (fix coming soon). The program will remember the previously selected a folder and will use this path the next time that Capture2D is opened from the desktop. If you open Capture2D through AMASS it will use the same file path that is being used by AMASS. Also be sure to give your files good names (i.e., cal.cen for calibration trial, jump.cen for a trial that involves jumping, etc.). Use the browse button to select a good location in which to store your cen files. We highly recommend that you use a separate folder for each subject and for each session that the subject completes. The default path is the Capture2D™ application folder, which isn't writable on Windows 7 and isn't a smart place to store data (fix coming soon). The program will remember the previously selected a folder and will use this path the next time that Capture2D is opened from the desktop. If you open Capture2D through AMASS it will use the same file path that is being used by AMASS. Also be sure to give your files good names (i.e., cal.cen for calibration trial, jump.cen for a trial that involves jumping, etc.).
  
-[[File:browse_button.png|{{/images/3/33/browse_button.png?117x28}}]]+{{:browse_button.png}}
  
-===== Recording_Data =====+==== Recording_Data ====
  
 Recording is initiated by selecting the "Start Recording" button on the right. At the bottom left is the "Duration" field that allows you to set how long of a trial or calibration that you would like to record. Recording is initiated by selecting the "Start Recording" button on the right. At the bottom left is the "Duration" field that allows you to set how long of a trial or calibration that you would like to record.
  
-[[File:recording_buttons.png|{{/images/9/9c/recording_buttons.png?226x52}}]]+{{:recording_buttons.png}}
  
 Note that this button is not available unless cameras are connected. Note that this button is not available unless cameras are connected.
  
-===== Playback =====+==== Playback ====
  
 When the trial has been collected Capture2D™ enters playback mode, so that the captured images can be reviewed. When the trial has been collected Capture2D™ enters playback mode, so that the captured images can be reviewed.
  
-[[File:post_recording_buttons.png|{{/images/4/4c/post_recording_buttons.png?198x54}}]]+{{:post_recording_buttons.png}}
  
 In Playback mode there is an option to proceed to the "Next" recording which will result in the trial being saved, or to "Delete" the recording if the captured images are not of use. In Playback mode there is an option to proceed to the "Next" recording which will result in the trial being saved, or to "Delete" the recording if the captured images are not of use.
  
-===== Calibration =====+==== Calibration ====
  
 Before any data can be processed by AMASS, it is important to calibrate the system. Before any data can be processed by AMASS, it is important to calibrate the system.
Line 201: Line 199:
 Once your volume is de-cluttered and your IREDs, Thresholds and Exposures are adjusted as needed you should be able to capture a calibration trial (wand movement and L-frame trail). About 30 seconds should be long enough for four cameras. You might need to record for longer if you have more than four cameras or a large volume (maybe 60 or 90 seconds or longer). You want to give yourself enough time for each camera to see the wand throughout the volume. Once your volume is de-cluttered and your IREDs, Thresholds and Exposures are adjusted as needed you should be able to capture a calibration trial (wand movement and L-frame trail). About 30 seconds should be long enough for four cameras. You might need to record for longer if you have more than four cameras or a large volume (maybe 60 or 90 seconds or longer). You want to give yourself enough time for each camera to see the wand throughout the volume.
  
-==== Motion Trial versus Calibration Trial ====+=== Motion Trial versus Calibration Trial ===
  
 There is no real distinction between recording a motion trial and calibrating the motion capture collection volume. There is no real distinction between recording a motion trial and calibrating the motion capture collection volume.
Line 207: Line 205:
 A calibration file is simply a recorded trial used for [[Other:AMASS:Documentation:System_calibration|calibration]], stored as a [[Other:Report3D:Documentation:Centroid_Files|.cen file]], and the order of collection is unimportant. For example, the calibration trial could be the last trial recorded. A calibration file is simply a recorded trial used for [[Other:AMASS:Documentation:System_calibration|calibration]], stored as a [[Other:Report3D:Documentation:Centroid_Files|.cen file]], and the order of collection is unimportant. For example, the calibration trial could be the last trial recorded.
  
-==== Calibration Wand ====+=== Calibration Wand ===
  
 The unique feature of the calibration is the use of the [[Other:AMASS:Documentation:System_calibration#The_wand|calibration wand]] and the placement of an L-Frame in the volume. The unique feature of the calibration is the use of the [[Other:AMASS:Documentation:System_calibration#The_wand|calibration wand]] and the placement of an L-Frame in the volume.
  
-==== Reference Markers ====+=== Reference Markers ===
  
 The Reference Markers are typically an L-Frame that is used to identify the Laboratory Coordinate System of the data collection volume. The Reference Markers are typically an L-Frame that is used to identify the Laboratory Coordinate System of the data collection volume.
Line 217: Line 215:
 For most 3D analyses, the principal purpose of the L-Frame is to identify the direction of gravity (e.g. the vertical direction) For most 3D analyses, the principal purpose of the L-Frame is to identify the direction of gravity (e.g. the vertical direction)
  
-===== Capturing Motion Trials ===== +==== Capturing Motion Trials ====
- +
-Once the volume has been appropriately calibrated in AMASS then, so long as the cameras are not moved any number of static or motion trials can be collected. We recommend that you develop a naming convention for your motion files prior to beginning your collection in order to facilitate clear naming and organization of the trials. Once all desired trials have been collected they can then be tracked and labeled using [[|AMASS]].+
  
 +Once the volume has been appropriately calibrated in AMASS then, so long as the cameras are not moved any number of static or motion trials can be collected. We recommend that you develop a naming convention for your motion files prior to beginning your collection in order to facilitate clear naming and organization of the trials. Once all desired trials have been collected they can then be tracked and labeled using [[Other:AMASS:Documentation|AMASS]].
  
-Retrieved from "" 
  
  
other/capture2d/documentation.1718385598.txt.gz · Last modified: 2024/06/14 17:19 by sgranger