Point Menu

Points are the building blocks of the measurements. The Point Menu provides access to the point measurement functions of DigiSize. Here, one can open a form that contains all of the preset points, enable batch points to process a number of scans automatically, export points to a text file and output formatted point reports.

[Point Menu]
Point Menu

Form...

The point form displays all of the available points names and point methods, as well as controls to execute the automatic extraction of all or a part of these points from the current scan file. As each point is manually picked by the user or automatically located by the software, the XYZ point locations will be added to the form, in English or metric values, along with the total time it took to compute that measurement.

NOTE:
The results generated from the Point Form are not automatically saved to the project database. The SAP checkbox at the bottom of the window tells the software to Save All Points, if they are available.
[Point Form]
Point Form

Point Listing

The measurement listing displays the names of all of the measurements that are available. Also displayed are the type/method of gathering the measurement (Geometry, Landmark, Manual, Predict and Special), the point's XYZ values, the units of measurement and the time required to process each point.

[Point Listing]
Point Listing

Point Types

This section of the window determines the types/methods of measurements that will be displayed in the Measure Form. Several types of measurements are available; Geometry, Landmark (available ONLY in the developer version of DigiSize), Manual, Predict and Special. To initiate the location of a point, simply select the desired points or press the Select All button to choose all points. Then, pick the type of point (Geometry, Landmark, Manual, or Predicted), then click on the Locate Points button.

[Point Types]
Point Types
MethodDefinition
GeometryGeometry points are the standard automatic points generated by DigiSize.
LandmarkThis selection will look for landmarks that were placed on the subject at the time of scanning. DigiSize searches for these landmarks and bases the measurement points on the landmarks, rather than looking for features in the scan data. The landmark detection is currently available only in the developer version of the software.
ManualManual measurements require operator interaction to precisely pick a given point/measurement.
PredictPredict points are those that are located automatically, but are based on formulas rather than software-detected features or landmarks. Many anthropological points are based on locating a specific bone by touch, but the bone is not visible. Therefore, the location must be estimated, and the point is created by prediction.
SpecialThis section is reserved for use in unique projects or custom extraction routines.

Point Selection Buttons

The Select All button will select all of the listed measurements while the Select None button will deselect all measurements. The Clear button will remove the values from Point and Time.

[Point Selection Buttons]
Point Selection Buttons

Point Definition

This button opens a window that displays all available definitions for the chosen point. This definition may contain information such as the technical description of the point and a graphical representation of the measurement. This information is very helpful to new users and to guarantee that all users choose points in an accurate and repeatable manner.

[Point Definition]
Point Definition

To access the description for a point, simply click one time on a point in the list. Next, press the Definition... button. The description window will now open for the user to review. When finished with the definition window, simply click the Windows' Close button.

Display Manager

The Display Manager allows the user to modify the default drawing method and orientation that is used when a point is extracted. If a user creates a custom point, this panel is helpful in order to correctly position and render the scan in the DigiSize viewing window.

[Display Manager]
Display Manager

Processing Buttons

These buttons relate to the processing of measurements.

[Processing Buttons]
Processing Buttons

Locate Points

The Locate Points button, when pressed, will extract all of the points that are selected in the point listing. The user must have an active scan in the DigiSize viewing window prior to executing this procedure.

Stop

The Stop button cancels all point extraction. Further processing of the data will continue after the user again presses the Locate Points button.

SAP

This button (Save All Points) will save all selected points into the current database.

GAP

When a user presses this button, DigiSize will Get All Points from the current project database.

GSP

This button instructs DigiSize to Get Saved Points from the current project database.

DAP

The DAP (Delete All Points) button removes all point information from the Point Form. There is no undo for this action, all of the measurement data will be destroyed.

DSP

If previously-saved points appear in this window, they may be deleted by using the DSP button. These points will be removed from the project database permanently.

Batch...

The batch function will automatically process all points for an entire set of selected scans and save those points (XYZ locations) into the project database. To use this function, the user must select from a list of all scan subjects in the database that have been classified as good. Then the user may specify any number of points to be extracted and by what methods. These points are stored in the database where they can be used to calculate measurements or displayed at a later time using the the Database View function. This menu item is available only when the user has set a current project.

[Point Batch]
Point Batch

For examples showing how to use Measure Batch, visit the tutorial:

 

File Filter

The filters allow a user to select a limited range of scans that will be available in the file listing. This is helpful if the user would like to work with a particular Group or ID, rather than the entire database. The pop-up allows for the rapid selection of All scans, a Group of scans, a particular ID or scans from a specific date or range of dates. The filter text establishes the parameters for each selection.

[Point Batch]
Point Batch Filter

File Filter Example

In order to demonstrate the file filter, we will select only those scans in the database that are from Group 1.

  1. Select Group from the pop-up.
  2. [Point Batch]
    Point Batch
  3. The filter text should be entered as "1".
  4. [Point Batch]
    Point Batch
  5. Press the Okay button to use the filter. Notice the updated file listing in the illustration below.
  6. [Point Batch]
    Point Batch
  7. To return to the full listing of files, simply select All from the pop-up, then click the Okay button
  8. [Point Batch]
    Point Batch

Scan Subject Listing

The file listing shows all of the files in the current project that meet the file filtering criteria. By default, all of the files in the current project will be displayed.

[Scan Subject Listing]
Scan Subject Listing

Select All / Select None

The Select All button selects all of the files in the scan subject list. This is very useful if you would like to work with a large number of scans at any one time.

The Select None button will clear any selections in the scan subject list.

[Select All / Select None]
Select All / Select None

Display Manager

The Display Manager allows the user to modify the default drawing method and orientation that is used when working with a point. If a user creates a custom point, this panel is helpful in order to correctly position and render the scan in the DigiSize viewing window.

[Display Manager]
Display Manager

Locate Points

The Locate Points button, when pressed, will extract all of the points that are selected in the point listing. The user must have an active scan in the DigiSize viewing window prior to executing this procedure.

The Stop button cancels all point extraction. Further processing of the data will continue after the user presses the Locate Points button.

[Locate Points]
Locate Points

RP

The RP button will cause DigiSize to search for and Replace Points in the project database.

[Replace Points]
Replace Points

Point Selection Buttons

The Select All button will select all of the listed points while the Select None button will deselect all points in the listing.

[Point Selection Buttons]
Point Selection Buttons

Point Definition

This button opens a window that displays all available definitions for the chosen point. This definition may contain information such as the technical description of the point and a graphical representation of the point. This information is very helpful to new users and to guarantee that all users choose points in an accurate and repeatable manner.

[Point Batch]
Measure Batch

On / Off

These buttons will turn on/off (respectively) any selected measurements. If a point is turned on, DigiSize will use this point in point and measurement calculations. If a point is turned off, this will force DigiSize to ignore that point.

[Point Batch]
Measure Batch

Point Listing

The point listing displays the names of all of the points that are available. Also displayed are the type/method of the point (Geometry, Landmark, Manual, Predict and Special), and the status of the point (on/off).

[Point Batch]
Measure Batch

Export...

This selection allows the user to export the point data from the project database to a tab delimited ASCII text file. This type of file may be viewed in any text editor or in a spreadsheet. A user can select which measurements to export, including traditional (manual) measurements and imported measurements.

[Measurement Export]
Point Export

Export Example

To use the Point Export panel, follow this procedure:

  1. Set the filter preferences to show the files that you are interested in exporting. For information on using the Filter, please consult the Filter description in this user guide.
  2. [Point Export - Select a File]
    Point Export - Select a File
  3. On the left-hand side of the window, choose a scan or set of scans from the listing. This can be accomplished using the mouse or by using the Select All button, located just below the scan subject listing.
  4. [Point Export - Select a File]
    Point Export - Select a File
  5. On the right-hand side of the window, select a point or a set of points to be exported. By default, all of the points are selected (on) and ready for export.
  6. [Point Export - Select Measurements]
    Point Export - Select Measurements
  7. Press the Export button.
  8. [Point Export - Export]
    Point Export - Export

File Filter

The filters allow a user to select a limited range of scans that will be available in the file listing. This is helpful if the user would like to work with a particular Group or ID, rather than the entire database. The pop-up allows for the rapid selection of All scans, a Group of scans, a particular ID or scans from a specific date or range of dates. The filter text establishes the parameters for each selection.

[Point Export]
Point Export Filter

File Filter Example

In order to demonstrate the file filter, we will select only those scans in the database that are from Group 1.

  1. Select Group from the pop-up.
  2. [Point Export]
    Point Export
  3. The filter text should be entered as "1".
  4. [Point Export]
    Point Export
  5. Press the Okay button to use the filter. Notice the updated file listing in the illustration below.
  6. [Point Export]
    Point Export
  7. To return to the full listing of files, simply select All from the pop-up, then click the Okay button
  8. [Point Export]
    Point Export

Scan Subject Listing

The file listing shows all of the files in the current project that meet the file filtering criteria. By default, all of the files in the current project will be displayed.

[Scan Subject Listing]
Scan Subject Listing

Select All / Select None

The Select All button selects all of the files in the scan subject list. This is very useful if you would like to work with a large number of scans at any one time.

The Select None button will clear any selections in the scan subject list.

[Select All / Select None]
Select All / Select None

Export

This button will export all of the selected points (in the point listing) for all of the selected scan subjects (from the scan subject listing) into an ASCII text file.

[Export]
Export

Point Selection Buttons

The Select All button will select all of the listed points while the Select None button will deselect all points in the listing.

[Point Selection Buttons]
Point Selection Buttons

Point Definition

This button opens a window that displays all available definitions for the chosen point. This definition may contain information such as the technical description of the point and a graphical representation of the point. This information is very helpful to new users and to guarantee that all users choose points in an accurate and repeatable manner.

[Point Definition]
Point Definition

On / Off

These buttons will turn on/off (respectively) any selected measurements. If a point is turned on, DigiSize will use this point in point and measurement calculations. If a point is turned off, this will force DigiSize to ignore that point.

[Point Export]
Point Export

Point Listing

The point listing displays the names of all of the points that are available. Also displayed are the type/method of the point (Geometry, Landmark, Manual, Predict and Special), and the status of the point (on/off).

[Point Export]
Point Export

Report...

Point Report is used to display and save formatted reports using information from the project database. This data will encompass an entire set of selected scans from the current project database. A user will select a report name from the report listing on the right-hand side of the window. Reports are created by Cyberware according to specific customer requirements.

[Point Report]
Point Report

Point Report Example

To use the Point Report panel, follow this procedure:

  1. From the pop-up, set the file filter to Group.
  2. [Point Report - Group Filter]
    Point Report - Group Filter
  3. The filter text should be entered as "1".
  4. [Point Report - Filter]
    Point Report - Filter
  5. Press the Okay button to use the filter. Notice the updated file listing in the illustration below.
  6. [Point Report - Filter]
    Point Report - Filter
  7. Press the Select All button to select all of the scans from Group 1.
  8. [Point Report - Select All]
    Point Report - Select All
  9. Press the Browse... button. A DigiSize file browser will open, asking for you to select a destination folder for the report.
  10. [Point Report - File Browser]
    Point Report - File Browser
  11. Navigate to the 'digisize_databases' folder (or any folder that you prefer) then press the Okay button. The file browser will close and return you to the Point Report form.
  12. [Point Report]
    Point Report
  13. Select a Report Name from the drop down menu. The only Report included with a default DigiSize installation is the "UniSA ADAPT" form. Select this form and the window will update and appear similar to the illustration below.
  14. [Point Report]
    Point Report
  15. Press the Save Reports button to complete the process.
  16. [Point Report]
    Point Report

    You should see a dialog similar to the one below when the process completes successfully.

    [Point Report - Complete]
    Point Report - Complete

File Filter

The filters allow a user to select a limited range of scans that will be available in the file listing. This is helpful if the user would like to work with a particular Group or ID, rather than the entire database. The pop-up allows for the rapid selection of All scans, a Group of scans, a particular ID or scans from a specific date or range of dates. The filter text establishes the parameters for each selection.

[File Filter]
File Filter

Scan Subject Listing

The file listing shows all of the files in the current project that meet the file filtering criteria. By default, all of the files in the current project will be displayed.

[Scan Subject Listing]
Scan Subject Listing

Destination Folder

This area of the Point Report form is used to select a folder into which the generated reports will be saved.

[Destination Folder]
Destination Folder

Select All / Select None

The Select All button selects all of the files in the scan subject list. This is very useful if you would like to work with a large number of scans at any one time.

The Select None button will clear any selections in the scan subject list.

[Select All / Select None]
Select All / Select None

Save Reports

This button will export all of the points from the Report for all of the selected scan subjects (from the scan subject listing) into an ASCII text file.

[Save Reports]
Save Reports

Report Name

Reports are created by Cyberware according to specific customer requirements. These reports will be listed in this drop down menu and may be selected by a single mouse click.

[Report Name]
Report Name