HAS-Motion Software Documentation

This is an old revision of the document!

---

convert]]**//. ===== project group ===== the project group has a non-editable window containing the project name, and **edit**, **open…**, and **new…** buttons. the project’s file name is the same as the project name with the extension //.prj//. project_group.jpg when the amass shell program is started it automatically loads the last used project file. if the program cannot find or open the last used project it presents the following dialog. no_last.jpg here the user may create a new project file containing default values for all parameters, or open a different, existing project file. ==== edit project parameters (edit) ==== once a project file has been loaded its parameters may be examined or changed by use of the **edit** button which displays the following parameter edit dialog. edit_params.jpg this dialog provides a tab for each of the main processing functions ( **input** (**convert**), **calibrate**, **track**, **identify**, **analyze**) as well as a **comment** tab in which the user can enter comment information about this particular project. for a detailed description of the parameters in a particular tab refer to the appropriate function. ==== open another project (open...) ==== the **open…** button allows the user to navigate to and load any existing project file. upon file selection all parameters and folder information for that project are loaded and become available for immediate use. the data for the current project file are automatically saved before the selected file is loaded. ==== create new project (new...) ==== on pressing the **new…** button the current project file is saved and the user is presented with a dialog requesting a new project name and a folder location where the new project file is to be stored. new_proj.png the initial contents of the new project file will be identical to the current project file and should be customized by use of the **edit** command. once you have created a new project file you will also probably want to change the folders where the input and output data files will be stored. to do this click on each radio button extension name (**cen**, **cal**, etc.) in the **input files** group box and either type in or **browse…** for the required folder name. //**note:**// when using the **browse…** button all folders for file extension types to the right of the current one will be changed, i.e. if you change the **cal** folder to //d:\tmp\data// by using **browse…**, the **seg**, and **c3d** folders will also become //d:\tmp\data//. \\ ===== function group ===== after selecting one or more input files, you can click on any enabled button in the **function** group to perform the indicated processing. functions_nov3d.jpg note that only those buttons whose function can process the selected input files (.//cen// files in this example) will be enabled, providing a valuable guide to the novice user. the rest of this section provides a very brief overview of the various functions. ==== capture2d... ==== this button launches the c-motion camera //**capture2d**// program that can be used to collect .//cen// files from supported camera systems. the program is strictly not a part of amass but is designed to be run in parallel with the amass shell and feed .//cen// files directly to amass functions. the **captur2d…** button will only be enabled if the //**cen**// file extension is selected for **input files** in the shell, __and__ **capture2d** is selected in the **input** page of the parameters dialog. note that the parameters that control the //**capture2d**// program are not stored in the project file. //**capture2d**// is designed to operate in conjunction with the amass shell program and normally both will be open simultaneously. if the output folder in the //**capture2d**// program is the same as the .//cen// input file folder in amass, the amass **input files** window will reflect files created in the //**capture2d**// program. ==== view3d ==== //**[[other:amass:documentation:view3d|view3d]]**// is an advanced function that can displays processed camera data in real time provided the project file is set up correctly. the camera data may be streamed from //**capture2d**// (not yet implemented) or a .//cen// file. ==== convert ==== the //**[[other:amass:documentation:convert|convert]]**// function provides a conversion capability from raw camera data files produced by some commercial systems to .//cen// files required by amass. this button becomes enabled if one or more camera raw data files are selected in the **input files** list. the extension of the raw data files will depend upon the camera system that created the files, and the system type must first be set in the **input** page of the parameters dialog. for systems that produce individual camera files for each data capture only the lowest numbered file will be displayed in the input file list. the conversion process creates a single .//cen// file for each capture even if multiple camera files were produced by the originating system. ==== viewcen ==== //**[[other:amass:documentation:viewcen|viewcen]]**// is a utility program for visually checking the quality of data in .//cen// files. if one or more .//cen// files are selected you can click on **viewcen** to display the image data from each camera, over all frames. a **parameter** button in the window also provides information on some internal camera parameters stored in the .//cen// file. if you check the **viewcen** box in **input** parameters, the //**viewcen**// program will be automatically called after each file conversion. ==== calibrate ==== the amass //**[[other:amass:documentation:calibrate|calibrate]]**// program performs the camera system calibration from the selected input .//cen// file(s) using the **calibrate** parameters in the current project file. if successful it writes the resulting calibration data to a .//cal// file in the cal folder designated via the **input files** group. this calibration file can then be used by the //**track**// program to generate 3d marker trajectories. during a calibration data capture an [[other:amass:documentation:calibrate#the_calibration_wand|amass wand]] must be moved throughout the volume where it is desired to perform 3d measurements. the requirements for wand motions during the calibration trial capture are rather specific, and must be carefully done in order to provide a successful and accurate calibration. an accurate calibration in turn leads to good, clean marker trajectories which makes the task of segment identification much easier. the calibration software performs a series of complex computations in order to determine, among other things, each camera’s focal length, lens distortions, internal camera geometry, and location and orientation in the global coordinate system. simultaneously the program also deduces the distribution of the markers on the wand, and the wand’s location in every frame. examination of the required [[other:amass:documentation:calibrate#calibration_parameters|calibration parameters]] will show that user input to the program is very limited, greatly reducing the possibility of errors. however, it is important to read and pay close attention to the [[other:amass:documentation:system_calibration|system calibration]] section which provides detailed instructions on setting up cameras and collecting calibration data. ==== viewlin ==== every .//cal// file can be examined with the //**[[other:amass:documentation:viewlin|viewlin]]**// utility program. in addition to a view of the area of the image that was calibrated and can participate in 3d reconstruction for each camera, the display provides some overall information on the quality of the calibration. //**viewlin**// also has an **apply** button which designates the currently displayed .//cal// file as the calibration file to be used in subsequent //**track**// operations. ==== track ==== the //**[[other:amass:documentation:track|track]]**// program acts on the selected .//cen// files to generate .//seg// files using the calibration file and **track** parameters specified in the project file. the tracking process is automatic and involves a complex computation that combines the centroids of each marker from different cameras, reconstructs the markers' locations in 3d space, and assigns the markers to 3d trajectories. these 3d trajectories extend over five or more consecutive frames and are called __segments__. the segments are arbitrarily numbered according to the order of their commencement, and typically vary in length because of interruptions due to marker image loss from camera views. the resulting .//seg// file is a binary file containing all possible segments that could be reconstructed from the .//cen// file. ==== viewseg ==== //**[[other:amass:documentation:viewseg|viewseg]]**// is a utility program that operates on the selected .//seg// files, and for each file provides a graphical overview of the number of segments generated by the tracking. it also shows the lengths of the segments with respect to the total number of frames processed. if **connect gap** in the track parameters is greater than zero then the //**track**// program connects discontinuous segments which have a high probability of belonging to the same marker to form single segments. hence the //**viewseg**// display may show gaps in some segments indicating that a marker could not be specifically tracked for one or more frames. ==== identify ==== the //**[[other:amass:documentation:identification_basics|identify]]**// program allows the user to associate each segment with a marker label and then write the identified marker data to a .//c3d// file. input consists of a .//seg// file, [[other:amass:documentation:identification_basics#identify_parameters|identify parameters]], a marker labels file (.//mrk//), and an optional a link file (.//lik//), with both files being named in the identify parameters. ==== analyze ==== the //**[[other:amass:documentation:analyze_|analyze]]**// function can launch a user specified application program to process .//c3d// files selected in the **input files** window. the **analyze** tab in the project parameters allows the entry of the name and folder location of the application program to be executed. }}}}}}}}}}}}