other:amass:documentation:identification
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| other:amass:documentation:identification [2024/06/17 18:12] – created sgranger | other:amass:documentation:identification [2024/07/17 15:44] (current) – created sgranger | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| + | ====== Identification ====== | ||
| The Identify program reads in a .seg file and a set of Identify parameters, and presents a graphical interface which allows a user to assign segments to markers. The list of available markers is read from the specified //.mrk// file. As an aid to the identification the user may also provide a link (//.lik//) file to indicate which markers are to be connected with straight lines in the display. | The Identify program reads in a .seg file and a set of Identify parameters, and presents a graphical interface which allows a user to assign segments to markers. The list of available markers is read from the specified //.mrk// file. As an aid to the identification the user may also provide a link (//.lik//) file to indicate which markers are to be connected with straight lines in the display. | ||
| Line 5: | Line 5: | ||
| The end result of the identification process is exporting a [[Visual3D: | The end result of the identification process is exporting a [[Visual3D: | ||
| - | ===== Parameters | + | ==== Parameters ==== |
| The Identify parameters provide input to the Identify program which allows the user to associate maker labels with the segments generated by the Track program. | The Identify parameters provide input to the Identify program which allows the user to associate maker labels with the segments generated by the Track program. | ||
| - | [[parameters_identify.jpg]] | + | {{:parameters_identify.jpg}} |
| - | ==== Pan axis ==== | + | === Pan axis === |
| When the left mouse button is held down and the mouse is dragged left or right in the Identify 3D view display, the Pan axis defines the direction of the axis about which the view will be rotated. The user may select the negative or positive direction of any of the three Global Coordinate System (GCS) axes. | When the left mouse button is held down and the mouse is dragged left or right in the Identify 3D view display, the Pan axis defines the direction of the axis about which the view will be rotated. The user may select the negative or positive direction of any of the three Global Coordinate System (GCS) axes. | ||
| - | ==== View axis ==== | + | === View axis === |
| This setting determines along which GCS axis the initial view of the markers is presented. During identification the view will typically be changed by the user as the image is manipulated by panning, tilting, and zooming. | This setting determines along which GCS axis the initial view of the markers is presented. During identification the view will typically be changed by the user as the image is manipulated by panning, tilting, and zooming. | ||
| - | ==== Display volumes | + | === Display volumes === |
| The user may create up to ten “virtual” boxes in the Identify 3D view to mark regions of interest and aid in identification of segments. The boxes are defined by Low and High corner points in the GCS, where every Low coordinate is less than any corresponding High coordinate. Any box may be reduced to a plane by the entry of the same value in a common Low and High coordinate, i.e. if the floor is at the z-coordinate of -20, then entering -20 in the z-component of Low and High corners will cause a plane to be drawn at z = -20 user units. The size of the plane is specified by the other two coordinates. | The user may create up to ten “virtual” boxes in the Identify 3D view to mark regions of interest and aid in identification of segments. The boxes are defined by Low and High corner points in the GCS, where every Low coordinate is less than any corresponding High coordinate. Any box may be reduced to a plane by the entry of the same value in a common Low and High coordinate, i.e. if the floor is at the z-coordinate of -20, then entering -20 in the z-component of Low and High corners will cause a plane to be drawn at z = -20 user units. The size of the plane is specified by the other two coordinates. | ||
| - | === Volume number | + | == Volume number == |
| This box allows the user to select the volume number to be edited. | This box allows the user to select the volume number to be edited. | ||
| - | === Display | + | == Display == |
| The check box tells whether the particular box is to be displayed when the Identify program starts. Within Identify the facility exits to turn on and off the display of individual volumes. | The check box tells whether the particular box is to be displayed when the Identify program starts. Within Identify the facility exits to turn on and off the display of individual volumes. | ||
| - | === Low coordinates | + | == Low coordinates == |
| These three values hold the X, Y, and Z coordinates of the Low corner of the box. | These three values hold the X, Y, and Z coordinates of the Low corner of the box. | ||
| - | === High coordinates | + | == High coordinates == |
| These three values hold the X, Y, and Z coordinates of the High corner of the box. Each High coordinate value must be larger than the corresponding Low corner value. Only one (x, y, or z) coordinate of Low and High corners may be equal, in which case a plane will be drawn. | These three values hold the X, Y, and Z coordinates of the High corner of the box. Each High coordinate value must be larger than the corresponding Low corner value. Only one (x, y, or z) coordinate of Low and High corners may be equal, in which case a plane will be drawn. | ||
| - | === Color === | + | == Color == |
| The user can choose a color for the wire frame of each box when it is displayed. The Select color button presents a color picker window from which the user can select a standard color or create a custom color. | The user can choose a color for the wire frame of each box when it is displayed. The Select color button presents a color picker window from which the user can select a standard color or create a custom color. | ||
| - | ==== Marker file ==== | + | === Marker file === |
| The marker (//.mkr//) file is a file containing the marker labels that the user applies to the segments during the identification process. Clicking the //Edit// button launches Notepad and allows the user to edit the file. Clicking on the // | The marker (//.mkr//) file is a file containing the marker labels that the user applies to the segments during the identification process. Clicking the //Edit// button launches Notepad and allows the user to edit the file. Clicking on the // | ||
| Line 51: | Line 51: | ||
| Note that if the //.seg// file you are processing has saved identifications, | Note that if the //.seg// file you are processing has saved identifications, | ||
| - | === Example .mkr file === | + | == Example .mkr file == |
| An example .mkr contains a comment line and a marker name on each line: | An example .mkr contains a comment line and a marker name on each line: | ||
| Line 58: | Line 58: | ||
| This first line is a comment line. one two three four | This first line is a comment line. one two three four | ||
| - | ==== Link file ==== | + | === Link file === |
| This entry accepts the name of a Link (.lik) file which contains a list of marker label pairs that are to be joined in the 3D view. Clicking the Edit button launches Notepad and allows the user to edit the file. Clicking on the Browse… button allows the user to load an existing .lik file or create a new one. | This entry accepts the name of a Link (.lik) file which contains a list of marker label pairs that are to be joined in the 3D view. Clicking the Edit button launches Notepad and allows the user to edit the file. Clicking on the Browse… button allows the user to load an existing .lik file or create a new one. | ||
| Line 64: | Line 64: | ||
| To create a new Link file, click Browse…, and in the browse window type in a file name, select a destination folder, and then click Open. A window will pop up asking if you wish to create a new file. If you answer Yes a NotePad window will open allowing you to enter links. After the comment line type in one link per line, and then save the file. | To create a new Link file, click Browse…, and in the browse window type in a file name, select a destination folder, and then click Open. A window will pop up asking if you wish to create a new file. If you answer Yes a NotePad window will open allowing you to enter links. After the comment line type in one link per line, and then save the file. | ||
| - | ===== The Identify screen | + | ==== The Identify screen ==== |
| The Identify screen has four main areas. The //**control area**// on the left contains nine buttons. The central area presents a marker //**view area**//, a 3D view of the markers for the current frame above a // | The Identify screen has four main areas. The //**control area**// on the left contains nine buttons. The central area presents a marker //**view area**//, a 3D view of the markers for the current frame above a // | ||
| - | [[Identify_1.jpg]] | + | {{:Identify_1.jpg}} |
| - | ==== Marker view area ==== | + | === Marker view area === |
| In the image area unidentified markers are indicated in white and identified markers are drawn in yellow. An identified marker in the current frame will have its label background as yellow. Moving the mouse cursor over a marker will show its segment number if it is unidentified, | In the image area unidentified markers are indicated in white and identified markers are drawn in yellow. An identified marker in the current frame will have its label background as yellow. Moving the mouse cursor over a marker will show its segment number if it is unidentified, | ||
| - | ==== Continuity area ==== | + | === Continuity area === |
| The strip below the //**view area**// has vertical space for every label shown in the //**label area**//. If there are more labels than fit into the //**label area**//, the segments in the // | The strip below the //**view area**// has vertical space for every label shown in the //**label area**//. If there are more labels than fit into the //**label area**//, the segments in the // | ||
| Line 82: | Line 82: | ||
| By default, each segment is given a vertical space of three pixels. You may use the up and down arrow keys on the keyboard to increase or decrease the height devoted to the // | By default, each segment is given a vertical space of three pixels. You may use the up and down arrow keys on the keyboard to increase or decrease the height devoted to the // | ||
| - | ==== label area ==== | + | === label area === |
| - | ===== Marker view manipulation | + | ==== Marker view manipulation ==== |
| The following mouse actions are effective for manipulating the //**view area**// view: | The following mouse actions are effective for manipulating the //**view area**// view: | ||
| Line 104: | Line 104: | ||
| You can hide all unidentified markers by clicking on the //Hide UnIDd// button. This is useful for turning off all junk markers after you have finished the identification process. You can also resurrect all hidden markers by clicking on //Unhide All//. | You can hide all unidentified markers by clicking on the //Hide UnIDd// button. This is useful for turning off all junk markers after you have finished the identification process. You can also resurrect all hidden markers by clicking on //Unhide All//. | ||
| - | ===== Segment identification | + | ==== Segment identification ==== |
| Identify provides two methods for assigning segments to markers; //point select// and //label select//. | Identify provides two methods for assigning segments to markers; //point select// and //label select//. | ||
| - | ==== Point selection mode ==== | + | === Point selection mode === |
| This technique lets the user select a series of labels in the label area and then click on markers in the view to do the assignment. Left click on individual marker labels in the label area in the order you wish to assign them (the mouse may also be dragged over a sequence of labels). Clicking or dragging over a selected label will unselect it. The background of the first label selected will change to red, and the backgrounds of successively selected labels will change to aqua, and all markers that may be assigned the first label will circled in red in the image area. Left click on the marker you wish to give this first (red) label. The marker will change to yellow, and the background of the label will become yellow indicating an identified marker. The next label in the order selected will now assume a red background indicating that it is the next one to be applied. At any time the entire label selection may be cleared by left double-clicking on any label in the label area | This technique lets the user select a series of labels in the label area and then click on markers in the view to do the assignment. Left click on individual marker labels in the label area in the order you wish to assign them (the mouse may also be dragged over a sequence of labels). Clicking or dragging over a selected label will unselect it. The background of the first label selected will change to red, and the backgrounds of successively selected labels will change to aqua, and all markers that may be assigned the first label will circled in red in the image area. Left click on the marker you wish to give this first (red) label. The marker will change to yellow, and the background of the label will become yellow indicating an identified marker. The next label in the order selected will now assume a red background indicating that it is the next one to be applied. At any time the entire label selection may be cleared by left double-clicking on any label in the label area | ||
| - | [[Identify_2.jpg]] | + | {{:Identify_2.jpg}} |
| - | ==== Label selection mode ==== | + | === Label selection mode === |
| This mode is entered by left-clicking to the left or right of the red frame cursor in the continuity area, depending on whether you wish to scan forwards or backwards in frames. Pressing the left or right arrow keys on the keyboard achieves the same purpose. | This mode is entered by left-clicking to the left or right of the red frame cursor in the continuity area, depending on whether you wish to scan forwards or backwards in frames. Pressing the left or right arrow keys on the keyboard achieves the same purpose. | ||
| - | [[Identify_3.jpg]] | + | {{:Identify_3.jpg}} |
| The program searches for the next unidentified marker in the current frame, or if there is not one in the current frame, the next (or previous) frame that has an unidentified marker. It then indicates the marker with a blue cross in the image area, and in the label area shows which labels may be assigned to the marker by an aqua background. To perform the assignment left click on a permitted label. The program will then automatically scan to the next unassigned marker, etc. If you wish to hide a marker that the scan has selected, do a left-click anywhere in the image area. To skip labeling a selected marker without hiding it, right click anywhere in the image area. Pressing the left or right arrow keys also has the effect of skipping the immediate identification of a marker. | The program searches for the next unidentified marker in the current frame, or if there is not one in the current frame, the next (or previous) frame that has an unidentified marker. It then indicates the marker with a blue cross in the image area, and in the label area shows which labels may be assigned to the marker by an aqua background. To perform the assignment left click on a permitted label. The program will then automatically scan to the next unassigned marker, etc. If you wish to hide a marker that the scan has selected, do a left-click anywhere in the image area. To skip labeling a selected marker without hiding it, right click anywhere in the image area. Pressing the left or right arrow keys also has the effect of skipping the immediate identification of a marker. | ||
| Line 124: | Line 124: | ||
| To exit Label select mode, move the frame slider to a different frame number. | To exit Label select mode, move the frame slider to a different frame number. | ||
| - | ==== Saving identifications | + | === Saving identifications === |
| At any time the current identifications may be saved to the input .seg file by using the //Save IDs// button, and retrieved by the //Reload IDs// button. Of course, if Tracking is performed again to regenerate the //.seg// file, any saved identifications are lost. Clicking the //Clear IDs// button cancels all assignments current in the program, but does not modify the identifications stored in the .seg file. | At any time the current identifications may be saved to the input .seg file by using the //Save IDs// button, and retrieved by the //Reload IDs// button. Of course, if Tracking is performed again to regenerate the //.seg// file, any saved identifications are lost. Clicking the //Clear IDs// button cancels all assignments current in the program, but does not modify the identifications stored in the .seg file. | ||
| - | ===== Button functions | + | ==== Button functions ==== |
| **Write C3D:** Outputs all identified marker data to a [[Visual3D: | **Write C3D:** Outputs all identified marker data to a [[Visual3D: | ||
| Line 147: | Line 147: | ||
| **Close:** Closes the Identify program and takes the user back to the AMASS shell. | **Close:** Closes the Identify program and takes the user back to the AMASS shell. | ||
| - | |||
| - | |||
other/amass/documentation/identification.1718647961.txt.gz · Last modified: 2024/06/17 18:12 by sgranger