User Manual

68 Location Software Library PLUS System Manual
Proprietary Information: Do not disclose unless authorized under a Nondisclosure Agreement and the Partner Agreement.
Maps can be used to provide a common coordinate system for all Readers that are part of the Map.
Maps are useful in multi-floor or multi-building installations. Maps must not overlap. To avoid this, a
Reader cannot be assigned to Groups in a way that allows the Reader to appear in more than one Map.
The Location Software supports limiting a Tag position to allowable regions, called Tracking Cells. The
Tracking Cell is defined by a set of points that form a polygon. Any Tag position outside the Tracking
Cell is discarded. Tracking cells can be defined for both Groups and Maps. Tracking Cells can also be
configured with a ―snap to‖ feature. If a Tag position is just outside the Tracking Cell, the ―snap to‖
feature allows the location software to move that position to the boundary of the Tracking Cell. For
example, if there is a walkway on the edge of the Tracking Cell, a Tag in this area could generate
positions just outside the Tracking Cell. With ―snap to‖ enabled, these positions are moved to the
nearest points on the Tracking Cell.
4.4 Location Software Configuration
The Tracker Object includes a complete API for configuring the operating parameters of the Location
Software. However, most applications do not need to use these capabilities. Instead, most installations
will use the PLUS Visualizer application to perform the initial system configuration. Once installation
is complete, Visualizer will generate a configuration file that contains all information necessary to
completely initialize the Location Software. All an application needs to do is perform a single Location
Software function call to tell the Tracker Object which file it will use to load its configuration
information.
V is u a liz e r
L o c a tio n
E n g in e
C o n fig u ra tio n
F ile
U s e r
A p p lic a tio n
L o c a tio n
E n g in e
S y s te m In s ta lla tio n S y s te m O p e ra tio n
U s e r
In s ta lle r
4.5 Location Software API
This section documents the components of the Location Software API in detail. Although the Tracker