Motion Capture System User Manual - Metria Innovation

MPT Users’ Manual3.4.3Section 3.4.3, Equipment SetupMultiple system wired connectionIt is possible to connect multiple Measurement Controllers (MCs) together. In this configuration,measurements are synchronized across all systems. The amount of data involved, however, requiresthat the systems be connected via ethernet.As shown in Figure 12, the user computer and all MCs connect to each other through anethernet switch. One (and only one) MC must connect to the switch from its DHCP ethernetport. This machine is called the Master. It gives ethernet addresses to all of the other MCs, whichare called Followers. They connect to the switch from their LAN ethernet ports.Once a follower MC has connected to the master MC, its WiFi will stop, and it will synchronizewith the master MC. This process can take up to 30 seconds. Please wait at least this long beforecollecting data with the system.MasterRouter/SwitchDHCPLANFollower NFollower 1Follower NDHCPLANDHCPLANRouter/SwitchUser ComputerLANFigure 12: Wiring diagram of a multi-controller system(Revised: Aug 12, 2012) Page 10

MPT Users’ ManualSection 4.0, Series2 UI4 MoCapClient: The Series2 User InterfaceThe user interacts with the Series2 system through MoCapClient, a platform independent userinterface program. MoCapClient will run on any operating system that supports a recent versionof Java. Its main window and settings window are shown in Figures 13 and 14.Figure 13: MoCapClient Main Window upon launch.(Revised: Aug 12, 2012) Page 11

MPT Users’ ManualSection 4.0, Series2 UIFigure 14: MoCapClient Settings Window(Revised: Aug 12, 2012) Page 12

MPT Users’ ManualSection 4.1.1, Series2 UI4.1 Terminology4.1.1Main Window PanelsThe MoCapClient main window is divided into 7 sections or panels. These are named in Table 1and highlighted in Figure 15. Each panel has a different role to play in operating the Series2System. They are labelled here, at the outset, for convenient reference later on.1. Banner6. Protocol2. Preview3. Dash4. Camera7. Acquisitions5. SessionTable 1: Panel LabelsFigure 15: MoCapClient Main Panels(Revised: Aug 12, 2012) Page 13

MPT Users’ Manual4.1.2Section 4.1.3, Series2 UIAcquisitionAn acquisition is the basic unit of data collection in the Series2 System. When one runs or firesan acquisition, the system collects data for a set number of images or frames from the camera andsaves the resulting measurements to a data file (or data files, when analog input is enabled). Forexample, if the camera is running at 90 frames per second, an acquisition of 900 images will collectdata for 10 seconds.Each acquisition has a unique name and an iteration counter, both of which appear in thename of the data file(s) created by the acquisition. The iteration counter starts at 1 and increasesevery time the aqcquisition is fired. If an acquisition is named longAcq, its output data files willhave names like longAcq1.hts, longAcq2.hts, longAcq3.hts, and so on. If analog input is enabled,longAcq1.ana, longAcq2.ana, . . . will also be available. If C3D file output is properly configured,longAcq1.c3d, longAc2.c3d, . . . will be available as well.4.1.3ProtocolA protocol is a list of acquisitions that can be saved and reloaded in MoCapClient. The names ofthe acquisitions, their order in the protocol list, and the number of images set for each acquisitionare all stored in the protocol. This allows users to conveniently reuse a particular data collectionsetup.(Revised: Aug 12, 2012) Page 14

MPT Users’ ManualSection 4.2.0, Series2 UI4.2 Adding and Editing AcquisitionsFigure 16: Protocol Panel and Acquisition Settings WindowTo add an acquisition, hit the Add Acq button in the protocol panel (Figure 13 Panel 6). This willopen the Acquisition Settings Window (Figure 16), where one can set the Acquisition Name andNumber of Images. Number of Images has a minimum value of 10 and a maximum value limitedby the amount of RAM in the Measurement Controller.Optionally, a Detailed Description may be added to an acquisition. This description is viewableonly when adding or editing an acquisition; it is useful if the Acquisition Name is unclear.If Confirm to Fire is checked, the Fire Confirmation Dialog (Section 4.3.1) will appear andrequire another button to be pressed before data is actually collected. Acquisition Repetitions setsthe number of times an acquisition is fired every time firing is initiated. It is a form of auto repeatcovered in Section 4.3.2.Figure 17: Acquisitions panel with three configured acquisitionsAdded acquisitions appear in the Acquisitions Panel (Figure 15 panel 7). Figure 17 shows acompressed Acquisitions panel with three acquisitions named long, medium, and short. To the left(Revised: Aug 12, 2012) Page 15

MPT Users’ ManualSection 4.3.0, Series2 UIof each acquisition is a circle called a Radio Button. The radio button for the long acquisition isfilled in, meaning this acquisition is selected. To change the settings of the selected acquisition,click the Edit Acq button in the protocol panel (Figure 16). This opens the Acquisition Settingswindow with all the settings of the selected acquisition. Any changes made can be saved by hittingthe Commit button.Any acquisition can be selected by clicking on the radio button to the left of the acquisition.4.3 Firing AcquisitionsThe Acquisitions Panel (Figure 18) provides two mechanisms for firing acquisitions. One way isto simply click the button bearing the name of the acquisition. This will fire it. The other way is toclick the Acquire Next button in the bottom right of the Acquisitions Panel. This will fire whateveracquisition is selected. After the acquisition has completed, the next acquisition will be selected.Hitting the Up button causes the previous acquisition to be selected.In Figure 18, the acquisition named long is selected (the radio button to its left is filled in witha black dot). After firing with Acquire Next, the acquisition named medium will be selected. If theacquisition named short is fired with Acquire Next, long will be selected after short has finishedacquiring.Figure 18: Acquisitions panel before (left) and after (right) Acquire NextTo the right of each acquisition is its iteration counter. This counter begins at 1 and increasesevery time an acquisition is fired. This number appears in the name of the data file(s) created byan acquisition, allowing acquisitions to be fired multiple times without overwriting data. Hittingthe Acquisition Iteration Reset button will reset all acquisition iteration counters to 1.Whenever an acquisition is fired, a window pops up to notify the user that data acquisition is inprogress. That window for the acquisition named long is shown in Figure 19.(Revised: Aug 12, 2012) Page 16

MPT Users’ ManualSection 4.3.2, Series2 UIFigure 19: Acquiring Dialog, present while measurments are being acquired4.3.1Fire ConfirmationIf Confirm to Fire is selected in an acquisition’s settings (Section 4.2), the dialog of Figure20 willappear whenever the acquisition is fired. Data collection will only start after the Fire button inthis dialog is pressed. Hitting the Cancel will abort data collection. This is very handy when thesystem is operated using a presenter tool, as it allows the user to be sure the correct acquisition hasbeen selected before collecting data.Figure 20: Fire Confirmation Dialog4.3.2Repeated AcquisitionsIf Acquisition Repetitions is set to a value greater than 1 in the Acquisition Settings Window(Figure 21), the acquisition will be fired multiple times whenever firing is initiated by any ofthe methods in this section. If Confirm to Fire is on and Acquisition Repetitions is set to 10,the acquisition will be fired 10 times consecutively after the Fire button of the Fire ConfirmationDialog is pressed once.(Revised: Aug 12, 2012) Page 17

MPT Users’ ManualSection 4.5.0, Series2 UIFigure 21: Acquisition Settings Window4.4 Arranging AcquisitionsThe Move Up and Move Down buttons in the Protocol Panel (Figure 22) move the currently selectedacquisition up or down in the list of acquisitions in the Acquisitions Panel. The acquisition namedlong is shown as selected in Figure 22. Since it is at the top of the acquisitions list, the Move Upbutton will not affect it. The Move Down button will cause the long acquisition to change placeswith the medium acquisition.Figure 22: Protocol and Acquisition Panels4.5 Creating, Loading, and Saving ProtocolsSince a protocol is defined by the list of acquisitions, a protocol is created by adding, editing, andarranging acquisitions (Sections 4.2 and 4.4). A protocol also has a name, which is set using theName: field in the Protocol Panel (Figure 23).A protocol may be saved to a file using the Save button in the Protocol Panel. Once saved, aprotocol may be loaded later using the Open button in the Protocol Panel. The list of acquisitions(Revised: Aug 12, 2012) Page 18

MPT Users’ ManualSection 4.6.2, Series2 UIin the Acquisitions Panel will be the same as when the protocol was saved, except all AcquisitionIteration counters will be set to 1.The New button in the Protocol Panel deletes the current protocol and sets the protocol nameto New. Be sure to save the existing protocol before hitting the New button.Figure 23: Protocol Panel4.6 Organizing Measurement Data Files4.6.1Results RootMeasurement data files are saved under the Results Root directory, which is configured using theResults Root button in the Sessions Panel (Figure 24).Figure 24: Sessions Panel4.6.2Results PathThe filename and directory structure used to save the measurement data files may be configuredusing the Results Path Config section (Figure 25) of the Settings Window (Figure 14). Hit the gearshaped settings button on the Banner Panel (Figure 4.1.1 Panel 1) to open the Settings Window.(Revised: Aug 12, 2012) Page 19

MPT Users’ ManualSection 4.6.3, Series2 UIFigure 25: Settings Button and Results Path ConfigurationThe Results Path (or simply path) is an expanded filename of a measurement data file, includingthe directories leading to it from the Results Root directory. The Results Path Config section hasa list of fields that can be entered into the path where measurement data files are saved. Theseinclude Plan Name, Acq Name, and Acq Iteration (See Section 4.6.3 for Dynamic Labels). To theleft of each field are three radio buttons labelled \, , and x. The \ setting causes a field to begin a new directory in the path. The setting includes a field as part of the path, but does not use it to begin a new directory.An underscore is added before the field when needed. The x setting removes the field from the path.Results Path Example shows what the Results Path will look like in practice. Changes to theResults Path will be lost unless the Save Configuration button is pressed before exiting the SettingsWindow.4.6.3Dynamic FieldsDynamic Fields are configurable Results Path fields that allow general information about adata collection session to be included in the Results Path. The labels of Dynamic Fields(Dynamic Labels) are entered in the Results Path Config section of the Settings window; theDynamic Fields themselves are displayed in the Session Panel of the Main Window.Figure 26 includes both locations involved with Dynamic Fields. It shows Dynamic Labels1 and 2 set to Tester and Subject in Settings. The Tester and Subject fields receive the valuesJane and S19 in the Main Window. The Results Path is configured to create a directory thatstores acquisitions for each Tester, while the Subject field is connected to the acquisition name anditeration counter. A filename such as Jane\S19 standing 1.hts will result.(Revised: Aug 12, 2012) Page 20

MPT Users’ ManualSection 4.8.0, Series2 UIFigure 26: Using Dynamic Fields4.7 Camera SettingsFigure 27: Camera PanelFigure 27 shows the Camera Panel. It has several features:System The name of the Measurement Controller (MC) to which MoCapClient is connected. Thisdropdown menu is essential to setups with multiple MCs.Framerate The camera framerate of the connected system, in units of frames per second. Itsminimum value is 1 frame per second, and its maximum value is set by the camera hardware.Exposure Technically, the number of microseconds that the camera imager is exposed for everyframe. Setting this number higher results in a brighter image.Analog Ratio The number of analog samples per channel that are saved for every frame of cameradata. If the camera runs at 90 frames per second, and Analog Ratio is set to 10, each analogchannel will run at 900 samples per second.Ring Light A button which may be used to turn the CLU ring light (Figure 5) On or Off.(Revised: Aug 12, 2012) Page 21

MPT Users’ ManualSection 4.8.1, Series2 UI4.8 Preview SettingsThe Preview Panel (Figure 15 Panel 2) is designed to display what the camera is seeing in a helpfulmanner. It has many capabilities and settings, which may be adjusted via the Dash Panel (Figure15 Panel 3) and which are described below.Figure 28: Preview Window Markers & Marker Info4.8.1Image, Markers, DiagnosticsThe Dash Panel has four checkboxes for image- and marker-related features available in thePreview Panel:Image Displays the grayscale image seen by the camera.Marker Info Displays full marker ID, marker brightness, and marker focus index.Markers Places colored circles over markers identified by the system. Marker ID is displayedinside each circle, and the colors match those of the relevant Marker Info line.(Revised: Aug 12, 2012) Page 22

MPT Users’ ManualSection 4.8.2, Series2 UIDiagnostics Displays system diagnostic information.The above four features may be turned on or off in any combination. Figure 28 shows Markersand Marker Info together, Figure 29 shows Image and Diagnostics together. Turning off all fouroptions results in a black Preview Panel.Figure 29: Preview Window Image & Diagnostics4.8.2AnalogThe Preview Panel is also able to display data from Analog Input. Figure 30 shows Channels 1and 2 together on the same screen. Each channel receives its own color, and 0V coincides with thecenterline of the voltage readout text.The Analog Gain setting in the Dash Panel comes in handy for faint signals. It can be setanywhere from 1 to 100 and is simply a multiplier applied to the Analog Input data before display.(Revised: Aug 12, 2012) Page 23

MPT Users’ ManualSection 4.9.0, Series2 UIFigure 30: Analog Channels 1 & 2 displayed(Revised: Aug 12, 2012) Page 24

MPT Users’ ManualSection 4.10.0, Series2 UI4.9 Tracking ConfigFigure 31: Tracking ConfigurationWhile any readable markers are in the field of view of the camera, the Series2 system will trytrack their position immediately and send the measurment as a UDP packet. The destination portand address of these packets can be set using the Tracking Config panel shown (Figure 31). Thestructure of the UDP is defined in Appendix 6.6.The number of markers that a system can track at any given time is based on a number offactors, including but not limited to, scene brightness, current processing of acquisitions, systemtemperature and number of markers in the scene. Due to these uncertainties the system will onlyattempt to send UDP measurement packets using a “best effort” algorithm. An unloaded systemcan reasonably be expected to track markers at about 500 measurements per second. To say thisanother way, a user could resonably expect to track 5 markers in realtime at a framerate of 100fps.4.10 Room CoordinatesBy default, all Series2 marker measurements are given in camera coordinates (See Section 6.7.1).In some applications, measurement data may be easier to visualize or interpret if represented inanother coordinate system; commonly, a coordinate system aligned with the floor of a room oranother flat surface is chosen. The Room Coordinates section of the settings window (Figure 32)allows such a coordinate system to be established by recording three points using the pointing tool(Section 6.5). The three points are:1. The origin of room coordinates.2. A point on the X axis of the room coordinate frame.3. A point on the XY plane of the room coordinate frame not colinear with the X axis.(Revised: Aug 12, 2012) Page 25

MPT Users’ ManualSection 4.11.1, Series2 UITo set each of these points, hold the tip of the pointing tool at the point’s location and hit theappropriate button in the Room Coordinates section of the Settings Window (Figure 32). Ifsomething goes wrong with a point measurement, it may be cleared and re-measured. Once allthree points have been recorded, the room coordinates transform, rcT, will be calculated, and allsubsequent marker measurements will be given in room coordinates. For more information, seeSection 6.7.3.Figure 32: Room Coordinates4.11 Force Plate RegistrationForce plate registration causes Series2 marker measurements to be recorded in the coordinate frameof an attached force plate. To register a force plate, first record the tare information by hitting theAcquire unloaded forceplate button in the Registration section of the Settings Window. Next, pushthe tip of the pointing tool (Section 6.5) firmly into the force plate at a point away from the forceplate center. Have another operator hit the Acquire forceplate point A button while the pointingtool is held in this condition. Repeat at two other points (B and C), chosen such that the threepoints are some distance from the force plate center and are not colinear.Once the unloaded force plate and all three points have been acquired, hit the Performforceplate registration button. Finally, hit Propagate registration to cameras. Subsequent markermeasureme

The CLU power cable connects to a jack on the Measurement Controller (MC) labelled “CAM PWR” which looks just like the one on the CLU base (Figure 5). The data cable for USB systems may plug into any USB port on the back of the MC. If this connector is not fully inserted, the system wi