HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » other » AMASS » documentation » Shell
other:amass:documentation:shell

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:documentation:shell [2024/07/03 17:34] – created sgrangerother:amass:documentation:shell [2024/07/17 15:44] (current) – created sgranger
Line 5: Line 5:
 The main AMASS program is the control center that provides easy access to all AMASS functions, parameters, and data. The main AMASS program is the control center that provides easy access to all AMASS functions, parameters, and data.
  
-{{shell_no_v3d.jpg}}+{{:shell_no_v3d.jpg}}
  
 The controls are divided into three groups; the **Input files** group, the **Project** group, and the **Function** group. This section provides a detailed description of the first two groups and an overview of the **Function** group. The controls are divided into three groups; the **Input files** group, the **Project** group, and the **Function** group. This section provides a detailed description of the first two groups and an overview of the **Function** group.
Line 16: Line 16:
 This area allows the selection of any number of data files for processing. It also allows the naming of destination folders for files to be generated by processing of the input files. This area allows the selection of any number of data files for processing. It also allows the naming of destination folders for files to be generated by processing of the input files.
  
-{{input_files.jpg}}+{{:input_files.jpg}}
  
 === Input files === === Input files ===
Line 34: Line 34:
 //**Notes:**// Setting a folder by using **Browse…** will set that folder for all extension types to the right of the currently selected radio button. This facilitates setting the same folder for all file types. //**Notes:**// Setting a folder by using **Browse…** will set that folder for all extension types to the right of the currently selected radio button. This facilitates setting the same folder for all file types.
  
-The leftmost radio button is only active if raw camera data are being supplied via files other than //.cen// files. See //**[[Other:AMASS:Documentation:Convert|Convert]]**//.+The leftmost radio button is only active if raw camera data are being supplied via files other than //.cen// files. See //**[[Other:AMASS:Documentation:Convert_AMASS2|Convert]]**//.
  
 ==== Project group ==== ==== Project group ====
Line 40: Line 40:
 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//. 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}}+{{: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. 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}}+{{: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. Here the user may create a new project file containing default values for all parameters, or open a different, existing project file.
Line 52: Line 52:
 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. 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}}+{{: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. 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.
Line 64: Line 64:
 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. 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}}+{{: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. 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.
Line 79: Line 79:
 After selecting one or more Input files, you can click on any enabled button in the **Function** group to perform the indicated processing. 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}}+{{: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. 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.
Line 95: Line 95:
 === Convert === === 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.+The //**[[Other:AMASS:Documentation:Convert_AMASS2|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 === === ViewCen ===
Line 103: Line 103:
 === Calibrate === === 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 AMASS //**[[Other:AMASS:Documentation:Calibrate_AMASS2|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_AMASS2#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.+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_AMASS2#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 === === ViewLin ===
Line 125: Line 125:
 === Analyze === === 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.+The //**[[Other:AMASS:Documentation:Analyze_with_AMASS2|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.
  
  
  
other/amass/documentation/shell.1720028074.txt.gz · Last modified: 2024/07/03 17:34 by sgranger