other:amass:documentation:identification_using_links
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
other:amass:documentation:identification_using_links [2024/06/19 12:45] – sgranger | other:amass:documentation:identification_using_links [2024/07/17 15:44] (current) – created sgranger | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | {{{{{{{{===== introduction | + | ====== Identification Using Links ====== |
- | the automatic labeling of segments is based on computations using only link lengths (separations between markers). no other application specific information is required or used, resulting in an extremely general method. the entire process is incorporated into the // | + | ==== Introduction ==== |
- | every effort has been made to make the process as simple and intuitive as possible but the underlying complexity | + | The automatic labeling |
- | the current implementation is still evolving because the techniques | + | Every effort has been made to make the process as simple |
- | ===== applicability ===== | + | The current implementation is still evolving because the techniques and procedures described in this documentation are novel and are based on limited experience with limited data sets. Users are encouraged to experiment with applications to their own data sets and share their experiences with the AMASS user community. |
- | the techniques described here are designed to facilitate the association of segments with marker labels and make it a less manually intensive process. effectiveness will depend on the quality of the .seg data and a number of factors related in complex ways to the links that the user defines between markers. | + | ==== Applicability ==== |
- | the data base for the automatic labeling consists of a list of __links__ (pairs | + | The techniques described here are designed to facilitate |
- | ===== definitions ===== | + | The data base for the automatic labeling consists of a list of __links__ (pairs of marker labels plus their separations) between markers whose separations are expected to be more-or-less constant throughout the .seg file, i.e. the process is most effective if the links are of constant or near constant length. A link may be defined between any pair of segments by simple mouse clicks on two points, but the effectiveness of a link in aiding segment identifications will depend on a number of factors. On the other hand the method is completely general and does not depend on any other input pertaining to the marker configurations. |
- | * ****link**** a link is a defined connection between two markers. it consists of the labels of the two markers, a nominal separation of the markers in user distance units, the maximum and minimum separations of the two markers, and a three component rgb color value that is to be used to draw the link in the **view area**. | + | ==== Definitions ==== |
- | * ****user identified segments (uids)**** during the identification process segments are associated with markers | + | * ****Link**** A link is a defined connection between two markers. |
- | **uids** are always indicated in __yellow__ in the **label**, **view**, and **continuity areas**, and in contrast to **c**omputer **id**entified | + | |
- | * ****computer identified | + | |
- | | + | **UIDs** are always indicated in __yellow__ in the **label**, **view**, and **continuity areas**, and in contrast |
+ | * ****Computer IDentified segments (CIDs)**** Segment identified by the program will be called **CIDs** and they will always be indicated by __green lines__ in the **continuity area**, __green__ points in the **view area**, and __green__ backgrounds in the **label area**, and they may be modified by the program. The user may confirm **CIDs** and convert them to **UIDs** by use of the **Confirm frame** or **Confirm all** (frames) buttons. | ||
- | //**body**// | + | |
- | a body is defined as a collection of markers where every marker is connected by a link to __at least__ one other marker. computationally the program treats each body as a unit, i.e. it processes each body in turn. bodies with many links and unidentified makers may take a long time to process. | + | |
- | //**chain**// | + | |
- | the simplest body is a chain of links where **n** markers are connected by **n-1** links to form a simple chain. we do not treat the case where **n = 2** because there is no way the data from a single link can be used to distinguish between | + | |
- | //**fully connected body**// | + | |
- | a fully connected body is a collection of markers where each marker is connected to every other marker in the body. in this case we have **n** markers connected by **n.(n-1)/ | + | |
- | // | + | |
- | a composite body is a most general type and contains a mixture of chains and fully connected bodies connected by links. | + | |
- | ===== identify buttons ===== | + | |
- | this section briefly describes | + | // |
+ | A body is defined as a collection of markers where every marker is connected by a link to __at least__ one other marker. Computationally | ||
+ | //**Chain**// | ||
+ | The simplest body is a chain of links where **n** markers | ||
+ | //**Fully connected body**// | ||
+ | A fully connected body is a collection of markers where each marker is connected to every other marker in the body. In this case we have **n** markers connected by **n.(n-1)/ | ||
+ | // | ||
+ | A composite body is a most general type and contains a mixture of chains and fully connected bodies connected by links. | ||
+ | ==== Identify buttons ==== | ||
- | id_buttons.jpg | + | This section briefly describes the buttons in the **command area** that are used to identify segments using link information. |
- | * ****id frame**** this button __switches to a mode__ whereby each frame selected by the frame cursor is processed to compute segment identifications using the current link information. each frame is treated independently of all other frames but all uids are preserved, i.e. the cids from any previous computation are first cleared. all resulting cids are shown in green. | + | {{: |
- | * ****id all**** the program attempts | + | * ****ID frame**** This button __switches to a mode__ whereby each frame selected by the frame cursor is processed |
- | * ****confirm frame**** this button will convert cids to uids (from green to yellow) but only for the current | + | * ****ID all**** The program attempts |
- | * ****confirm all**** this button | + | * ****Confirm frame**** This button |
- | * ****scale**** this spin box allows the user to temporarily scale all link lengths in the program memory, and is primarily useful | + | * ****Confirm all**** This button converts |
- | ===== link buttons ===== | + | * ****Scale**** This spin box allows the user to temporarily scale all link lengths in the program memory, and is primarily useful for applying a link file to different sized subjects. |
- | the **links** mode button enables/ | + | ==== Link buttons ==== |
- | id_links.jpg | + | The **LINKS** mode button enables/ |
- | * ****clear**** clicking this button deletes all link data currently in memory. | + | {{:id_links.jpg}} |
- | * ****reload**** this button | + | * ****Clear**** Clicking |
- | * ****set**** this command re-computes the data for all links using the current | + | * ****Reload**** This button first deletes |
- | * ****extend**** use this button to extend | + | * ****Set**** This command re-computes |
- | * ****save**** this button | + | * ****Extend**** Use this button |
- | ===== menu commands ===== | + | * ****Save**** This button becomes enabled once **Set** (links) has been performed. It saves the link data to the Project link file. To save to a different file use the menu **File/Save links as…** command. |
- | the following | + | ==== Menu commands |
- | * ****file/ | + | The following commands pertaining to links are available from the main menu bar. |
- | * ****file/save links as …**** | + | * ****File/Load links …**** |
- | * ****edit/ | + | * ****File/Save links as …**** If you wish to save the links to a file other than the project link file use this command. It will present |
- | * ****edit/link color**** the default color for drawing links is initially set to red but can be changed by selecting this item from the main tool bar. the selected color will then be applied to all the links that you create. | + | * ****Edit/Links**** This command writes |
- | * ****view/link vars.**** this command causes the links in the view area to be drawn in colors depending on how much each link varies in length (by percentage). it is useful for assessing link variations in a link file, and can be useful for finding an incorrectly defined link. approximate color assignments are as follow: | + | * ****Edit/Link color**** The default color for drawing |
- | link varies by | + | * ****View/ |
- | +/- 20% or more, red | + | |
- | +/- 15% yellow | + | |
- | +/- 10% green | + | |
- | +/- 5% aqua | + | |
- | +/- 0% blue | + | |
- | ===== links ===== | + | |
- | this section describes links in detail. | + | Link varies by |
+ | +/- 20% or more, Red | ||
+ | +/- 15% Yellow | ||
+ | +/- 10% Green | ||
+ | +/- 5% Aqua | ||
+ | +/- 0% Blue | ||
+ | ==== Links ==== | ||
- | ==== defining | + | This section describes |
- | links may be created any time the **links** mode is selected, and they may be defined in conjunction with segment identifications. | + | === Defining |
- | use the **left** mouse button to create a __single__ link to a previously **left** clicked point, and the **right** mouse button to create __multiple__ links with the previously **right** clicked points. | + | Links may be created any time the **LINKS** mode is selected, and they may be defined in conjunction |
- | to define | + | Use the **Left** mouse button |
- | * **left click** on the first point. | + | To define a chain of links for points that have __already been identified__ do the following: |
- | * **left click** on the next point, etc. | + | |
- | * to cancel the link creation, **left click** | + | |
- | to connect | + | * **Left click** on the first point. |
+ | * **Left click** on the next point, etc. | ||
+ | * To cancel the link creation, **Left click** for a second time (not a double-click) on the last body point. | ||
- | * **right click** on the first point. | + | To connect |
- | * **right click** on the next point, etc. | + | |
- | * to cancel the link creation, **right click** for a second time (not a double-click) on the last body point. | + | |
- | for a rigid body of //**n**// points, a maximum of //**n . ( n – 1 ) / 2**// links can be specified. defining all links for bodied with a larger number of points | + | |
+ | | ||
+ | * To cancel the link creation, **Right click** | ||
- | it is possible to use a combination | + | For a rigid body of //**n**// points, a maximum of //**n . ( n – 1 ) / 2**// links can be specified. Defining all links for bodied with a larger number of points |
- | two bodies may be combined into a single body simply by linking one or more points in the first body with one or more points in the second body. note however that __it is better | + | It is possible |
- | in order to identify | + | Two bodies may be combined into a single body simply by linking one or more points in the first body with one or more points |
- | ==== deleting | + | In order to identify points in conjunction with link creation first select marker labels in the label area in the order in which they will be applied to unlabeled points, then proceed to create the links as described above. The selected marker labels will only be assigned when you click on unidentified points, and you may include already identified points freely during the sequence. |
- | to delete a particular link it must be visible in the **view area** display. move the mouse cursor so that it is near the link and then **left double-click** while holding down the **shift** key. | + | === Deleting links === |
- | all links in memory may be deleted by use of the **clear** (links) button. | + | To delete a particular link it must be visible in the **view area** display. Move the mouse cursor so that it is near the link and then **Left double-click** while holding down the **Shift** key. |
- | you may also edit the links currently | + | All links in memory |
- | ==== changing | + | You may also edit the links currently in memory by selecting **Edit/ |
- | the user can select the color with which an individual | + | === Changing |
- | ==== graphing | + | The user can select the color with which an individual |
- | you may use the capability described in **[[other: | + | === Graphing |
- | ==== setting links ==== | + | You may use the capability described in **[[Other: |
- | when a links is first created only its length at the current frame is known, and its minimum and maximum lengths are set at +/- 10% of its current length. these data are then used to calculate other identifications, | + | === Setting |
- | ==== extending | + | When a links is first created only its length at the current frame is known, and its minimum and maximum lengths are set at +/- 10% of its current length. These data are then used to calculate other identifications, |
- | this command updates the current link length limits held in memory by incorporating the link lengths available from the current data. it can only decrease the minimum lengths and increase the maximum permitted lengths of links, and as such will mostly have an effect on the **id all** function. | + | === Extending |
- | ==== saving | + | This command updates the current link length limits held in memory by incorporating the link lengths available from the current data. It can only decrease the minimum lengths and increase the maximum permitted lengths of links, and as such will mostly have an effect on the **ID all** function. |
- | once **set** (links) has been activated the **save** | + | === Saving |
- | the link data may also be written | + | Once **Set** (links) has been activated the **Save** (links) button becomes enabled allowing |
- | if you use the **save** (links) button and have not specified | + | The link data may also be written to a different |
- | ==== editing | + | If you use the **Save** (links) button and have not specified a project link file you will be presented with the **Save links as…** option, and the opportunity to designate it as the project link file. |
- | the **edit/links** selection from the main menu bar writes the current link data to a temporary file and opens the file in a // | + | === Editing |
- | ==== link file format ==== | + | The **Edit/ |
- | the link file is an ascii file that contains a comment line as the first line, followed by a line of data for each defined link. a line describing a link consists of: | + | === Link file format === |
- | * the label for the first marker | + | The link file is an ASCII file that contains a comment line as the first line, followed by a line of data for each defined link. A line describing |
- | * a hyphen | + | |
- | * the label for the second marker | + | |
- | * a minimum distance between the two markers | + | |
- | * a mean distance between the markers | + | |
- | * a maximum distance between the two markers | + | |
- | * an rgb color value in the format ( red, green, blue) where the color components are in the range 0 – 255 | + | |
- | the numerical items must be separated by spaces. an example of a link file is: | + | * The label for the first marker |
+ | * A hyphen | ||
+ | * The label for the second marker | ||
+ | * A minimum distance between the two markers | ||
+ | * A mean distance between the markers | ||
+ | * A maximum distance between the two markers | ||
+ | * An RGB color value in the format ( red, green, blue) where the color components are in the range 0 – 255 | ||
- | links.jpg | + | The numerical items must be separated by spaces. An example of a link file is: |
- | note that the minimum and maximum distances used are not true values but may be modified by the program to remove outliers caused by measurement noise. | + | {{:links.jpg}} |
- | ===== identify tools ===== | + | Note that the minimum and maximum distances used are not true values but may be modified by the program to remove outliers caused by measurement noise. |
- | the techniques for using links to aid in identification are still evolving, but described here are some methods that seem to work quite well, at least for the data sets on which testing has been carried out. the computation to identify segments based solely on distances is very complex and the outcome depends on many factors, some of which are: | + | ==== Identify tools ==== |
- | * the total number of markers | + | The techniques for using links to aid in identification |
- | * the types of bodies | + | |
- | * the number of links we are trying to fit to the markers | + | |
- | * the number of bodies we are trying | + | |
- | * the body linkage configurations | + | |
- | * the continuities | + | |
- | * the variations in link lengths over all frames | + | |
- | * how similar | + | |
- | here are some general guidelines for creating useful | + | * The total number of markers |
+ | * The types of bodies | ||
+ | * The number of links we are trying to fit to the markers | ||
+ | * The number of bodies we are trying to identify | ||
+ | * The body linkage configurations | ||
+ | * The continuities of the marker segments | ||
+ | * The variations in link lengths over all frames | ||
+ | * How similar are the link lengths to each other | ||
- | * a body must contain at least 3 markers | + | Here are some general guidelines |
- | * define bodies with smaller numbers of markers to avoid excessive computation times | + | |
- | * avoid creating links whose lengths vary a lot | + | |
- | * bodies with multiply connected markers | + | |
- | * avoid creating | + | |
- | * situations with many links of approximately the same length may require excessive computation times | + | |
- | * the program is capable of distinguishing very subtle differences in link lengths provided they remain constant. | + | |
- | the techniques incorporated in the //**identify**// | + | |
+ | | ||
+ | * Avoid creating | ||
+ | * Bodies with multiply connected markers are better than simple chained bodies | ||
+ | * Avoid creating symmetric objects, although a single manual marker identification | ||
+ | * Situations with many links of approximately the same length may require excessive computation times | ||
+ | * The program is capable of distinguishing very subtle differences | ||
- | the link methods implemented | + | The techniques incorporated |
- | the following subsections describe | + | The link methods implemented in // |
- | ==== the id frame mode ==== | + | The following subsections describe in detail |
- | after initially defining or loading the links you will typically start the identification process by clicking on the **id frame** button to put the program into the **id frame** | + | === The ID frame mode === |
- | in the **id frame** | + | After initially defining or loading the links you will typically start the identification process by clicking on the **ID frame** |
- | the calculation uses the point coordinates and existing uids present in that frame, but does not use any cids that may have been computed previously, i.e. each frame is treated independently and the identifications | + | In the **ID frame** mode the program attempts to calculate the segment |
- | depending on the data, quite frequently the computed identifications may be incorrect, especially if there are a number of links of similar lengths, | + | The calculation uses the point coordinates and existing UIDs present in that frame, but does not use any CIDs that may have been computed |
- | the strategy should | + | Depending on the data, quite frequently the computed identifications may be incorrect, especially |
- | in some situations the computation | + | The strategy should be to search |
- | the **id frame** mode can be cancelled by clicking again on the **id frame** button, clicking on the **id all** button, or clicking on the **set** (links) button. | + | In some situations |
- | ==== id all ==== | + | The **ID frame** mode can be cancelled by clicking again on the **ID frame** button, clicking on the **ID all** button, or clicking on the **Set** (links) button. |
- | the **id all** button causes the program to try and identify all segments over all frames using the currently available link data and uids. the button only becomes enabled when the **id frame** mode is on, and when clicked it | + | === ID all === |
- | | + | The **ID all** button causes the program |
- | | + | |
- | | + | |
- | | + | |
- | you should first ensure that all cids for the current | + | * Turns off the ID frame mode |
+ | * Confirms all CIDs in the current frame | ||
+ | * Cancels all other CIDs | ||
+ | * Attempts to compute identifications over all frames | ||
- | this computation may or may not produce useable results depending on the quality of the link length data and the marker data. it builds upon cids which may have errors that propagate throughout | + | You should first ensure that all CIDs for the current frame are correct since the computation uses the current frame as a starting point. |
- | the program attempts to identify segments starting at the current frame and proceeds, in five frame increments, to the last frame or the last frame selected for output. in contrast to the **id frame** mode cids are retained | + | This computation may or may not produce useable results depending on the quality of the link length data and the marker data. It builds upon CIDs which may have errors that propagate throughout |
- | the results may range from perfect | + | The program attempts |
- | if there are just a few incorrect cids you can cancel them or correct them before doing the confirmation, | + | The results may range from perfect to very poor depending on a number of complex interacting factors. In any case the action |
- | ==== confirm | + | If there are just a few incorrect CIDs you can cancel them or correct them before doing the confirmation, |
- | any time all cids are correct in the currently displayed | + | === Confirm |
- | ==== confirm | + | Any time all CIDs are correct in the currently displayed frame you can click on the **Confirm frame** button (or press **Enter**) to convert the CIDs to UIDs which will then add to the pool of data used to make additional identifications. Only the CIDs under the frame cursor and those shown in green in the label and view areas will be affected. |
- | this command will typically be used after an **id all** command and results in the conversion of all cids (drawn in green in the continuity area) to uids. before using this command you should scan the file over all frames and make corrections as necessary to ensure that all cids are correct. incorrect uids will typically compromise all successive identification computations. | + | === Confirm |
- | ==== scale ==== | + | This command will typically be used after an **ID all** command and results in the conversion of all CIDs (drawn in green in the continuity area) to UIDs. Before using this command you should scan the file over all frames and make corrections as necessary to ensure that all CIDs are correct. Incorrect UIDs will typically compromise all successive identification computations. |
- | the scale value can only be modified when the program is in the **id frame** mode and the **links** mode is switched off, and it is most easily changed by placing the mouse cursor over the box and rotating the mouse wheel. the indicated scaling is temporarily applied to the link lengths when doing the identification computations, | + | === Scale === |
- | ==== clear ids ==== | + | The Scale value can only be modified when the program is in the **ID frame** mode and the **LINKS** mode is switched off, and it is most easily changed by placing the mouse cursor over the box and rotating the mouse wheel. The indicated scaling is temporarily applied to the link lengths when doing the identification computations, |
- | the action of this button has been modified to provide two levels of functionality. if any cids are present (indicated by green in the **continuity area** and green points in the **view area**) then clicking on this button will delete all of the cids and leave uids unchanged. a second click of the button will then delete all uids (yellow). **caution: | + | === Clear IDs === |
- | ==== canceling assignments ==== | + | The action of this button has been modified to provide two levels of functionality. If any CIDs are present (indicated by green in the **continuity area** and green points in the **view area**) then clicking on this button will delete all of the CIDs and leave UIDs unchanged. A second click of the button will then delete all UIDs (yellow). **Caution: |
- | both cids and uids for a point may be cancelled by **double left-clicking** on the point in the **view area**. __additionally__ they can be cancelled by placing the mouse cursor near the point so that the marker label shows and then pressing the **delete** key. | + | === Canceling assignments === |
- | for cids another method | + | Both CIDs and UIDs for a point may be cancelled by **double Left-clicking** on the point in the **view area**. __Additionally__ they can be cancelled by placing the mouse cursor near the point so that the marker label shows and then pressing |
- | ==== transferring computed assignments ==== | + | For CIDs another method may be used. Selecting a CIDs label in the label area cancels the identification and also selects the label for use in the next identification to be applied. To cancel the identifications of a number of CIDs it is possible to select their labels in the **label area** and then cancel them all with a **double Left-click** within the **label area**, or by changing the displayed frame with the frame slider or mouse wheel. |
- | you can select any number of labels belonging to cids in the **label area** (ones with a green background) just as you can for unassigned labels, and then apply them to unlabeled points in the normal manner. as you select each label the identification of the segment having that label will be cancelled. | + | === Transferring computed assignments === |
- | the first label you select | + | You can select |
- | the assignment can actually | + | The first label you select will have its background changed to red, indicating that the label will be applied |
- | overlap.jpg | + | The assignment can actually be made to any other unidentified point, however you will be presented with a message that there is a conflict in the assignment, and asked to resolve it. |
- | in this case you can cancel the assignment (**cancel**), | + | {{:overlap.jpg}} |
- | ==== set (links) ==== | + | In this case you can cancel the assignment |
- | the ability of the program to identify marker segments is highly dependent on accurate link length data which is usually not available when the link is first defined. when a link is first created the program records its length at the current frame and estimates its minimum and maximum lengths which are then used to identify other segments. at any time we may use the set (links) | + | === Set (links) |
- | typically **set** (links) should be used to better define | + | The ability of the program to identify marker segments is highly dependent on accurate |
- | note that before using the **set** or **extend** command you must first confirm or cancel | + | Typically |
- | ==== set vs. extend ==== | + | Note that before using the **Set** or **Extend** command you must first confirm or cancel the identifications of any CIDs. |
- | the **set** command measures the current | + | === Set vs. Extend === |
+ | |||
+ | The **Set** command measures the current | ||
---- | ---- | ||
- | ===== identifying | + | ==== Identifying |
- | the suggested procedure for creating a link file or identifying a one-of trial is essentially the same, and is described in this section. | + | The suggested procedure for creating a link file or identifying a one-of trial is essentially the same, and is described in this section. |
- | ==== select | + | === Select |
- | you may first wish to set the frame limits to avoid computations in part of the file where the data is poor. to set the first relevant frame move the frame slider to the desired position and press the **home** key. to set the last frame use the **end** key after moving to the last desired frame. | + | You may first wish to set the frame limits to avoid computations in part of the file where the data is poor. To set the first relevant frame move the frame slider to the desired position and press the **Home** key. To set the last frame use the **End** key after moving to the last desired frame. |
- | ==== identify | + | === Identify |
- | the next step is to move the frame slider to a location in the file where most markers are visible and can be readily identified. | + | The next step is to move the frame slider to a location in the file where most markers are visible and can be readily identified. |
- | ==== create | + | === Create |
- | next click the **links** mode button to allow the creation of links, and then create the links for the body by left and/ | + | Next click the **LINKS** mode button to allow the creation of links, and then create the links for the body by Left and/ |
- | ==== use the id frame mode ==== | + | === Use the ID frame mode === |
- | once you have created the desired links click on the **id frame** button and move the frame slider to a new position (you can also use the mouse wheel to do this). | + | Once you have created the desired links click on the **ID frame** button and move the frame slider to a new position (you can also use the mouse wheel to do this). |
- | the strategy should be to move the frame slider to positions where cids are calculated correctly, and then confirm the assignments by use of the **confirm | + | The strategy should be to move the frame slider to positions where CIDs are calculated correctly, and then confirm the assignments by use of the **Confirm |
- | ==== correct | + | === Correct |
- | however | + | However |
- | the initial goal should be to have uids for all markers you are labeling at several locations over the frame range that is of interest so as to incorporate the full length range of each link. actually, if the markers are firmly attached to a rigid body then any frame supplies this information except for measurement noise. | + | The initial goal should be to have UIDs for all markers you are labeling at several locations over the frame range that is of interest so as to incorporate the full length range of each link. Actually, if the markers are firmly attached to a rigid body then any frame supplies this information except for measurement noise. |
- | once you have good identifications at several locations in the file, you can proceed with the //set// (links) command. | + | Once you have good identifications at several locations in the file, you can proceed with the //Set// (links) command. |
- | ==== set links ==== | + | === Set links === |
- | use the **set** (links) button to have the program update the link length data using all available | + | Use the **Set** (links) button to have the program update the link length data using all available |
- | ==== use id all ==== | + | === Use ID all === |
- | once you have refined the link length data you can use the **id all** command to have the program try to identify segments over all frames. | + | Once you have refined the link length data you can use the **ID all** command to have the program try to identify segments over all frames. |
- | ==== set links again ==== | + | === Set links again === |
- | once you have good identifications for all frames of interest you should once again **set** (links) if you wish to save a link file to use with other .//seg// files. | + | Once you have good identifications for all frames of interest you should once again **Set** (links) if you wish to save a link file to use with other .//seg// files. |
- | ==== save links ==== | + | === Save links === |
- | use the **save** (links) button to write the link data to the project link file. you may also use the **file/save links as…** menu item to save the data to a different file. | + | Use the **Save** (links) button to write the link data to the project link file. You may also use the **File/Save links as…** menu item to save the data to a different file. |
---- | ---- | ||
- | ===== identifying | + | ==== Identifying |
+ | |||
+ | This section describes some techniques for using an appropriate link file to identify the segments in a .seg file. When a .//seg// file is opened in // | ||
- | this section describes some techniques for using an appropriate link file to identify the segments in a .seg file. when a .//seg// file is opened in // | + | === Select frames === |
- | ==== select | + | If desired first select |
- | if desired first select | + | === Use the ID frame mode === |
- | ==== use the id frame mode ==== | + | Click on the **ID frame** button to enter the individual |
- | click on the **id frame** button | + | First you may wish to adjust the __link scaling__ if there is a uniform size difference in the separation of markers in the .//seg// file used to define the links and the current .//seg// file. The easiest way to change the scaling is to place the mouse cursor over the **Scale** box and use the mouse wheel to modify the % value. Note that the **Scale** box is only enabled when the **LINKS** |
- | first you may wish to adjust | + | The scaling parameter temporarily modifies |
- | the scaling parameter temporarily modifies | + | Move the frame cursor to various locations in the file and find a location where all or most of the CIDs are correct. If a frame shows all correct CIDs press the **Enter** key (or click on the **Confirm frame** button) to convert |
- | move the frame cursor to various locations in the file and find a location where all or most of the cids are correct. if a frame shows all correct cids press the **enter** key (or click on the **confirm frame** button) to convert the cids (green) to uids (yellow). if one or more cids are incorrect you need to correct them before confirming the frame. | + | Once you have a frame with good UIDs you may move to another |
- | once you have a frame with good uids you may move to another frame location and repeat | + | === Correct |
- | ==== correct | + | Even the best frames may have CIDs that are incorrect, especially if there are a number of links of similar lengths, the link lengths have large variations throughout the trial, or markers are missing from the view. In such situations you can manually cancel and/or modify assignments before doing the confirmation. |
- | even the best frames may have cids that are incorrect, especially if there are a number of links of similar lengths, the link lengths have large variations throughout the trial, or markers are missing from the view. in such situations you can manually cancel and/or modify assignments before doing the confirmation. | + | === Use ID all === |
- | ==== use id all ==== | + | At any time you can try using the **ID all** button. Its first action is to confirm all CIDs in the current frame (same as using the **Confirm frame** button or pressing **Enter**). Hence before using it first make sure that all CIDs in the current frame are correct. It also cancels all other remaining CIDs (those not present in the current view area) before doing the computation. Once the computation is finished you should scan through the file to check the correctness of the CIDs and make corrections and deletions as appropriate. At any point you may use the **Confirm frame** or **Confirm |
- | at any time you can try using the **id all** button. its first action is to confirm all cids in the current frame (same as using the **confirm | + | If the **ID all** results are unsatisfactory, |
- | if the **id all** results are unsatisfactory, | ||
- | }}}}}}}} |
other/amass/documentation/identification_using_links.1718801129.txt.gz · Last modified: 2024/06/19 12:45 by sgranger