Poly Works Talisman User Guide For Android Mobile Devices
Poly Works Talisman User Guide For Android Mobile Devices
This manual, as well as the software described in it, is furnished under license and may be
used or copied only in accordance with the terms of such license. The content of this
document is furnished for informational use only, and is subject to change without notice.
InnovMetric Software Inc. assumes no responsibility or liability for any errors or inaccuracies
that may appear in this document.
Except as permitted by such license, reproduction in whole or in part in any way without
written permission from InnovMetric Software is strictly prohibited.
4 Introduction
5 1. Getting Started
5 1.1 Talisman basics
6 1.1.1 Requirements
7 1.1.2 General information
7 1.2 Starting Talisman
8 1.2.1 Selecting a project
9 1.2.2 Specifying Talisman settings
10 1.2.2.1 Getting help
12 1.3 Interface overview
13 1.3.1 Navigating between pages
14 1.3.2 Using the navigation drawer
14 1.3.2.1 The Projects option
The main purpose of Talisman is to help operators when they are performing tasks
away from their workstation running PolyWorks. For example, it allows operators to do
the following:
Get access to certain tools and options that are useful when probing or scanning on
the shop floor.
The purpose of this document is to explain how to use Talisman on an Android device.
It does not explain the functionalities or options that are specific to the
PolyWorks|Inspector or IMAlign module. These are explained in the
PolyWorks|Inspector Reference Guide or the IMAlign Reference Guide. Note that all the
screenshots were taken from a Nexus 5 mobile device and that user interfaces may vary
from device to device.
Wi-Fi Router
Server Client
The PolyWorks Metrology Suite is installed on the workstation that acts as a server,
while Talisman is installed on the mobile device, which acts as the client. Note that
Talisman works with the PolyWorks|Inspector and the IMAlign modules of the
PolyWorks Metrology Suite.
1.1.1 Requirements
The setup for using Talisman must have been performed. For more information, see
the Talisman Network Security and Setup Guide available from the Help > Reference
Guides > PolyWorks|Talisman submenu of the Workspace Manager.
The workstation and the mobile device must be connected to the same Wi-Fi
network.
In Workspace Manager, choose Tools > Options. The Workspace Manager Options
dialog box opens.
Make sure that the PolyWorks server for Talisman option is selected, then click
Apply.
Note that the arrow located beside the Talisman icon allows viewing
information on the PolyWorks server and restarting the server. These menu
items are to be used by a network administrator, and are explained in the
Talisman Network Security and Setup Guide available from the Help >
Reference Guides > PolyWorks|Talisman submenu of the Workspace Manager.
Messages
When a message is displayed on the server (e.g., a connection to the probing device is
required), the same message is displayed on the mobile device. When you answer the
message on the mobile device, it closes the message and sends the answer to the
server, and vice versa.
Language
When Talisman is opened for the first time, the language used in the display is the one
specified for the mobile device. Once connected to the PolyWorks server, Talisman
synchronizes with the server to use the same language as the one specified in the
PolyWorks Metrology Suite.
Sounds
If a sound is played on the server (e.g., a scan line is acquired), the same sound is played
on the mobile device. This is the default behavior. It can be changed using the Talisman
options (see Section 2.6 Using tools or Chapter 3 Working with IMAlign Projects).
The first page displayed is the Welcome page of Talisman. Talisman automatically
proceeds with the project detection. It searches for open projects on the server (i.e., the
projects whose Talisman functionality is enabled). The list of available projects is
displayed on the screen.
You can either select a project (see Section 1.2.1 Selecting a project), or specify the
Talisman settings (see Section 1.2.2 Specifying Talisman settings).
If you encounter any problems, make sure that your setup meets the requirements
listed in Section 1.1.1 Requirements.
In the list of projects displayed, each one is identified using the following information:
Project name
The connection is established with the server, and the project can be viewed in
Talisman.
Note that the arrow located beside the Talisman icon allows viewing information on
the PolyWorks server for Talisman and restarting the server. These menu items are to
be used by a network administrator, and are explained in the Talisman Network
Security and Setup Guide available from the Help > Reference Guides >
PolyWorks|Talisman submenu of the Workspace Manager.
Talisman can be connected to only one project at a time. However, you can quickly
connect to another project by tapping the Projects option and selecting another
project.
For information on the user interface and the different tools available in Talisman, see
Section 1.3.2 Using the navigation drawer.
When tapping the action overflow button (shown to the right) in the top right corner of
the action bar, it allows specifying the parameters for the Talisman application on the
Android device. If there is no action overflow button, the Talisman parameters can be
accessed by pressing the physical menu button of the device.
Note that the list of parameters is contextual. Some parameters are offered only when
Talisman is connected to a project, while others are offered only when no connection
has yet been established.
Lock orientation – Lock the page orientation (portrait or landscape): Tap to change
the page orientation. By default, the parameter is disabled.
High definition – Choose the resolution of real-time 3D scene images sent by the
server: Tap to change the resolution. By default, the parameter is enabled, which
means that the resolution is of high definition. It corresponds to the exact
dimensions (in pixels) of the display zone. The result is better, but the performance is
lower. When the value is set to OFF, it means that the resolution is of low definition.
Server display – Change the server display setting: Tap to enable/disable the display
on the server when using the 3D Scene page. By default, the parameter is enabled,
which means that images are displayed on both the client and the server. If real-time
images lag, disable Server display to restrict the display to the client only. In this
case, the 3D scene on the server is replaced by the following message:
Choose the sound source (e.g., sounds that are played when new points are
acquired), either Client Only, Server Only, or Client and server. The default value is
Client and server.
Access the Advanced settings, which allows specifying the static port used to
connect to the PolyWorks server. It also allows resetting all the application settings.
To get more information on the Talisman client version, tap About Talisman.
Refer to the Help page or the Demo Video to get information on the application (see
Section 1.2.2.1 Getting help).
To close the page, tap the Up caret when applicable, or the Back button.
The button, when you are not connected to a project, allows obtaining information
on how to get started with Talisman, either in the form of a help page or a
demonstration video. If this button is not shown on the screen, this information can
also be obtained by pressing the physical menu button of the device.
The Help page provides the main steps for getting started with Talisman. It
summarizes the requirements that must be met to use the application.
To return to the Select a project page of Talisman, tap the Up caret or the Back
button.
To return to the Select a project page of Talisman, tap the Back button.
(e)
(b)
(b) - Navigation drawer (see the following sections for information on each navigation
option).
(c) - Page name, which corresponds to the name of the current action category.
(e) - List of actions or action categories available on the current page. When an action is
chosen, the action is immediately performed. When an action category is chosen, it
opens a page that contains the actions of this category.
(f) - Action overflow button (shown to the right), which allows accessing the Settings
page of Talisman (see Section 1.2.2 Specifying Talisman settings). This button is not
available on devices with physical buttons.
Note that the last page selected in the navigation drawer, before exiting the
application, becomes the default page the next time that you open the Talisman
application.
Each main page contains the Up button, found in the action bar, that allows opening
the navigation drawer. This drawer can also be opened by swiping a finger from the left
edge of the screen. The navigation drawer that follows is displayed when working with
PolyWorks|Inspector projects. For IMAlign projects, only the Projects and Tools
navigation options are available.
Navigation
drawer
You can navigate from one category to another by tapping the appropriate option.
Each category offers one or more pages of tools, which can also be navigated by
tapping the appropriate item.
To return to a previous page, tap the Up caret located in the upper-left corner of the
page (only displayed if applicable). See the example shown to the right. When the caret
allows returning to a main page (for example, Measure or Device), the page name is
displayed next to the caret.
The Talisman user interface has been designed to be easy to use. As explained in
Section 1.3.1 Navigating between pages, up to five options may be available, which
allow accessing a category of tools. Each option is described in the present section.
When tapping the Projects option, a page of the same name is displayed (see below). It
displays the list of projects, and a check mark is displayed next to the currently active
project. To open a new project in Talisman, simply tap the desired project.
When tapping the Align option, a page of the same name is displayed (see below). It
offers a functionality, called Probe Surface Points, that allows matching the device
coordinate system to the project coordinate system by aligning probed points to same
locations on Reference objects. The transformation matrix obtained is then used to
transform the acquired points.
For information on how to probe surface points, see Section 2.1 Aligning using surface
points.
When tapping the Measure option, a page of the same name is displayed (see below).
It offers tools that allow probing and scanning objects.
The Measure option allows the following operations for each object category:
Data Objects – Probing surface and boundary point clouds, and scanning objects.
For more information, see Section 2.2 Measuring objects by probing and Section 2.3
Measuring objects by scanning.
When tapping the Device option, a page of the same name is displayed (see below). It
offers tools that allow controlling the probing device. The tools offered depend on the
selected device.
When a device is selected, its name is indicated in the upper part of the page. It is
followed by the active device position.
The Tools option is available for both PolyWorks|Inspector and IMAlign projects.
However, some functionalities apply to PolyWorks|Inspector only.
When tapping the Tools option, a page of the same name is displayed (see below). It
offers general-purpose functionalities.
For more information, see Section 2.6 Using tools (PolyWorks|Inspector projects) or
Chapter 3 Working with IMAlign Projects (IMAlign projects).
1. On the server, make sure that a connection is established with the device.
The Align Surface Points pane opens. It is used to edit surface point and
destination point parameter values after the surface points have been created
and before the source points have been probed. When the source points have
been probed and the alignment process has been completed, the results can
also be viewed in this pane.
The interface changes for one of the following viewing modes: 3D Scene, Digital
Readout, or Remote Control. To change the viewing mode, see Section 2.2.2
Setting probing options.
The probing mode is launched, and is detailed in Section 2.2.1 Probing objects and
device position targets.
Features
Comparison Points
This section explains how to measure objects by using Talisman from the beginning to
the end of the probing operation. If you have started the probing operation from the
server, the 3D scene is automatically displayed in Talisman. In this case, go to Section
2.2.1 Probing objects and device position targets.
1. On the server, make sure that a connection is established with the device.
A connection is automatically established with the selected device (if it was not
previously connected).
Measure > Comparison Points > Create > Trimmed Edge Points
The dialog box used to set the probing parameters opens. You can change these
parameters on the server only.
The interface changes for one of the following viewing modes: 3D Scene, Digital
Readout, or Remote Control. To change the viewing mode, see Section 2.2.1.2.1
Changing the viewing mode.
The probing mode is launched, and is detailed in Section 2.2.1 Probing objects and
device position targets.
When the probing operation is launched, the display in Talisman changes for one of the
following viewing modes: 3D Scene (a), Digital Readout (b), or Remote Control (c).
2.2.1.1 Getting familiar with the 3D Scene, the Digital Readout, and the Remote
Control in Talisman
The interface of the viewing modes has been designed to be user friendly. If you are
familiar with the 3D Scene and the Digital Readout in PolyWorks|Inspector, you will
notice that they look the same in Talisman. Only the Remote Control is specific to
Talisman.
Since the purpose of the viewing modes is the same (i.e., probing objects and device
position targets), they share common items in both the action bar and navigation bar.
Shown as
Action bar Navigation bar large push
buttons
when using
the Remote
(a) (b) (c) (d) (e) (f) (g) Control
Action bar
(a) – Up caret that allows exiting the probing mode. It can also be used to confirm
the probing of an object.
(c) – Button used to change the viewing mode (see Section 2.2.1.2.1 Changing the
viewing mode).
Navigation bar
Note that the buttons explained below are displayed only if they are relevant in the
current context (e.g., the button that allows setting options is not displayed when an
object measurement confirmation is required).
(f) – Button that allows ending the probing operation. Available only if supported by
the device.
When the probing mode is launched, the following operations can be performed:
Change the viewing mode (e.g., to change from the 3D scene to the Remote Control).
See Section 2.2.1.2.1 Changing the viewing mode.
Drag to translate.
Pinch open/close combined with rotation to zoom and rotate about the viewing
axis.
Set the probing options related to the device, which are available by tapping the
button located either on the 3D Scene toolbar, on the Digital Readout toolbar, or on
the Remote Control toolbar.
These options may have been predefined on the server. However, the most
frequently used probing options (e.g., device selection, probe or reflector selection,
tip diameter, measurement mode) can be modified in Talisman. See Section 2.2.2
Setting probing options for more information.
When the probing mode is launched for the first time, the 3D scene is displayed by
default. It can be changed for another viewing mode (e.g., the Digital Readout).
1. In the 3D Scene, Digital Readout, or Remote Control viewing mode, tap the
rightmost button on the navigation bar (as shown below).
The following choices are offered. Note that the remote control is available only for
the devices that can be controlled using the Start/Stop Measurement and End
Probing buttons.
Probing options can be changed at any time in Talisman. Use one of the following
methods to access the Probing Options page:
Tap the Tools option in the Talisman navigation drawer, then choose Probing
Options.
In a viewing mode (3D Scene, DRO, or Remote Control), tap the button (shown to the
right) used to access settings, then tap the icon.
Device
Indicates the current device and allows accessing the list of available devices.
Probe / Reflector
Indicates the tool (probe or reflector) that is currently used and allows accessing
the list of available probes or reflectors.
Mode
Indicates the probing mode and allows accessing the list of modes offered by the
selected device. Available only when the choice of probing mode is supported by
the device.
Continuous Distance
Indicates the 3D distance for continuous distance probing modes, and allows
specifying a new one.
Stability trigger
An option that enables automatically probing points as soon as the tool is stable
for a given period of time.
Air Temperature
Indicates the temperature in degrees Celsius (oC) or Fahrenheit (oF).
Relative Humidity
Indicates the relative humidity.
Air Pressure
Indicates the air pressure in kilopascals (kPa), millibars (mbar), or inches of
mercury (inHg).
3D Scene DRO
An option that enables the Digital Readout display in the upper-right part of the
3D scene (like in PolyWorks|Inspector), as shown below. This option is enabled by
default.
This section explains how to scan objects by using Talisman from the beginning to the
end of the scanning operation. For more information on the scanning operations and
options that are specific to the PolyWorks|Inspector module, see the “Plug-ins for
Scanning Objects” chapter of the PolyWorks|Inspector Reference Guide.
2. Specify a Device.
3. If desired, enable or disable any quality metrics and specify the value of their main
parameter.
Scan type
Indicates the current scan type, and allows accessing the list of scan
types, i.e. Surface Scanning, Surface and Boundary Scanning, and
Sharp Edge Scanning.
The Surface Data Object section is available for the Surface Scanning and the
Surface and Boundary Scanning scan types. It offers the following parameters,
which define the surface Data object:
Data Object
Indicates the current surface Data object to receive the points to be
acquired, and allows accessing the list of available surface Data objects.
Name
Indicates the name of the new surface Data object, and allows specifying
a new one. Available only if the surface Data Object is set to (Create
New).
The Boundary Data Object section is available for the Sharp Edge Scanning and
the Surface and Boundary Scanning scan types. It offers the following parameters,
which define the boundary Data object:
Data Object
Indicates the current boundary Data object to receive the points to be
acquired, and allows accessing the list of available boundary Data
objects.
Name
Indicates the name of the new boundary Data object, and allows
specifying a new one. Available only if the boundary Data Object is set
to (Create New).
Profile
Indicates the current scanning profile, and allows accessing the list of
standard and user-defined profiles. Note that new profiles can only be
created and deleted in the PolyWorks|Inspector module.
Real-Time Comparison
Enables real-time comparison of scanned data to Reference objects.
Available for the Surface Scanning and the Surface and Boundary
Scanning scan types, when Real-Time Quality Meshing is deactivated.
Test Mode
Enables the test mode. When activated, “Test Mode” is displayed in the
top-left corner of the 3D scene as a reminder that the temporary scan
data will be deleted when the scanning session is over. Available for the
Surface Scanning and the Surface and Boundary Scanning scan types.
The 3D scene is displayed. For more information on how to interact with the 3D
scene, see Section 2.3.1 Getting familiar with the 3D scene in Talisman.
When finished, tap the Up caret ( ) or the End Scan button ( ) to end the scanning
mode.
If scanning a point cloud from mesh, tap Finish Scan or tap the Up caret
( ) to end the scanning session.
If you need to move the device to a new location, there is a mechanism that involves
defining targets in the current device position, performing a move device operation,
and then probing targets in the new device position. See Section 2.4.1 Defining targets
and Section 2.4.2 Moving the device.
The mobile device can be used to view and control a line scanning session. When the
scanning mode is launched from either the server or the client, the 3D Scene is
displayed in Talisman as follows:
The 3D scene offers an action bar, which displays information relative to the scanning,
as well as a navigation bar, which allows controlling the scanning session. They are
shown and explained below:
Action bar
(a) – Up caret that allows ending the scanning mode and exiting the 3D scene. The
Data Objects page of the Measure option is then displayed.
If scanning a polygonal model, you will be asked to either finalize the mesh or
delete the acquired scan passes before exiting the 3D scene.
(b) – Name of the Data object(s) that will receive the scanned points.
(c) – Scan type (i.e., Surface Scanning, Surface and Boundary Scanning, or Sharp
Edge Scanning).
(d) – Number of points scanned since the beginning of the scanning session.
Navigation bar
(e) – Button that opens the following menu (not available for Sharp Edge Scanning):
Ends scan line data acquisition. When scanning a point cloud, the 3D
scene is dismissed, and the Data Objects page of the Measure option is
displayed.
Note that if you are scanning with Test Mode enabled, “Test Mode” is displayed in the
top-left corner of the 3D scene to remind you that the temporary scan data will be
deleted when the scanning session is over.
Certain scanning options can be specified from Talisman, namely the scanning device
and quality metrics. To specify any other scanning options, use the Line Scan Options
dialog box in the PolyWorks|Inspector module, accessed by pressing the Options
button of the main dialog box of plug-ins.
To change the scanning options available in Talisman, use one of the following
methods:
In the Tools option of the Talisman navigation bar, tap Scanning Options.
In the 3D scene when scanning a polygonal model, tap the button (shown to the
right) used to access settings, then tap the icon.
Note that Device and Detect Misaligned Scan Passes are not available when scanning
options are accessed from the 3D scene.
For more information on quality metrics, see the “Plug-ins for Scanning Objects”
chapter of the PolyWorks|Inspector Reference Guide.
Use tools for a laser tracker device only, such as Go Home, Go Front, Go to XYZ, Find
Target, Change Face, and Orient to Gravity.
In Talisman, these tools are available through the Device option. Note that the tools
used to control a laser tracker device are also offered while the probing mode is
enabled. See the following subsections for more information.
The Define Targets tool allows defining the targets that will be used to align device
positions. The following procedure explains how to define targets using Talisman.
For complete information on how to use multiple device positions, see the “Device
Positions” chapter of the PolyWorks|Inspector Reference Guide.
To define targets:
A connection is automatically established with the selected device (if it was not
previously connected). Then:
parameters on the server only. For more information, see the “Defining
measured targets” section of the PolyWorks|Inspector Reference Guide.
The interface changes for one of the following viewing modes: 3D Scene, Digital
Readout, or Remote Control. To change the viewing mode, see Section 2.2.1.2.1
Changing the viewing mode.
The probing mode is launched, and is detailed in Section 2.2.1 Probing objects and
device position targets.
The Move Device tool allows creating a new device position or changing the active
device position. The following procedure explains how to use this tool in Talisman.
For complete information on how to use multiple device positions, see the “Device
Positions” chapter of the PolyWorks|Inspector Reference Guide.
To move a device:
Note that the functionality can also be launched in the context of Play Inspection. In
this case, the following particularities apply:
The page header is slightly different from the one shown above since it
contains guiding instructions.
A Close button is offered at the bottom of the page. It allows closing the
page without performing the Move Device operation.
Device Position
Specifies whether the position is a new one or an existing one:
Name
Specifies the default name of the new device position. Tap this name to
display an onscreen keyboard that allows changing the name.
Laser Tracker
Displayed only when the device position is already associated with a specific laser
tracker. Specifies which specific laser tracker is associated with the device position,
or that no specific laser tracker is associated with the device position (i.e., (No
Specific Device)).
Alignment
Specifies the alignment method currently used and allows accessing the list of
available methods (i.e., Custom, Targets, or Device Localization).
Restart
Enables restarting the temperature stability monitoring after creating or
activating a new device position. By default, the parameter is turned on.
Temperature Compensation
Specifies a temperature compensation for a device position. The following
parameters are offered:
Method
Specifies the method currently used for temperature compensation (i.e.,
Numerically, Material and Temperature, or Target Match).
Scaling Factor
Displayed only when the specified method is Numerically. A
scaling factor is set by default. Tap this value to display an
onscreen keyboard that allows changing the default value. Valid
values are integers greater than 0.
Material
Displayed only when the specified method is Material and
Temperature. Specifies the material currently used. Tap this
value to display a list of materials that allows changing the
specified material.
When a new device position is created and activated, the following situations occur:
If the Orient to Gravity tool has been enabled, the probing device launches the
measurement of the angles of inclination of the tracker with respect to the axis of
gravity.
Targets: the Define Targets page is displayed in Talisman (see Section 2.4.1
Defining targets).
The Change Device page is used to associate a specific laser tracker plug-in with a
device position:
A specific laser tracker plug-in is specified for the first time on the Probing Options
page; for more information on this page, see Section 2.2.2 Setting probing options.
Data have been acquired in the current device position with another device.
For more information, see the “Changing the device” section of the
PolyWorks|Inspector Reference Guide.
Tools offered vary from one device to another. The following table lists all the tools that
may be offered. For more information on these items, see the plug-in’s documentation
for the device that you are currently using, which is available from the Help > Reference
Guides menu of the PolyWorks|Inspector module.
Note that the above-mentioned tools are also offered on the toolbar displayed when
probing objects and device position targets (see Section 2.2.1 Probing objects and
device position targets).
Start the measurement sequence (in the Tools option, tap Play Inspection).
Move the device to a new position. See Section 2.4.2 Moving the device.
Stop the measurement sequence using the Left caret located in the upper-left part
of the 3D Scene, the Digital Readout, or the Remote Control.
Three other elements can also be displayed during the measurement sequence:
The progress bar also offers a Continue button (shown to the right) when the
inspection requires user approval before continuing with the next step. In this case,
however, if the progress bar was not previously displayed, it will display to offer the
Continue button and it will disappear as soon as the button is clicked.
A guiding image that represents the operation to perform. Only displayed if guiding
images are specified in the PolyWorks|Inspector module to appear in the 3D scene,
either partially or entirely. If they are specified to appear in a docking window, they
are displayed on the server only.
Note that tapping the image enables to switch from the Entire 3D Scene to the
Partial 3D Scene display mode, and vice versa.
Execute operations that require a user intervention (e.g., replacing Data objects,
measuring objects using a custom method).
View the detailed message that lists the objects that could not be measured.
Save Project: used to save an PolyWorks|Inspector project. If the project is saved for
the first time, it will automatically be saved as Untitled in the folder used by default
for workspaces (e.g., [user account folder]/PolyWorks).
Play Inspection: used to operate the Play Inspection tool. See Section 2.5 Playing a
measurement sequence.
Drag to translate.
Pinch open/close combined with rotation to zoom and rotate about viewing
axis.
Macro Scripts: used to access macro scripts that were saved under the talisman
subfolder of the User Configuration or Workspace macro script folder, so that they
can be executed directly from Talisman. For information on macro scripts, see the
Macro Scripting Reference Guide, which is available from the Help > Reference Guides
menu of the PolyWorks|Inspector module.
Probing Options: used to display a page to configure probing devices and offers
different items depending on the type of selected or connected probing device. For
information on probing options, see Section 2.2.2 Setting probing options.
When connected to an IMAlign project, the following page is displayed by tapping the
Up button, or by swiping the screen from left to right, which opens the navigation
drawer. This allows selecting the Tools option, except if a scanning session is in
progress. In this case, the 3D scene is automatically displayed.
Up button
Save Project: used to save an IMAlign project. If the project is saved for the first time,
it will automatically be saved as Untitled in the folder used by default for workspaces
(e.g., [user account folder]/PolyWorks).
Drag to translate.
Pinch open/close combined with rotation to zoom and rotate about viewing
axis.
Macro Scripts: used to access macro scripts that were saved under the talisman
subfolder of the User Configuration or Workspace macro script folder, so that they
can be executed directly from Talisman. For information on macro scripts, see the
Macro Scripts Reference Guide, which is available from the Help > Reference Guides
menu of the IMAlign module.