Professional Documents
Culture Documents
SURVEILLANCE
SOFTWARE (MASS)
V.3.21
User Guide
TABLE OF CONTENTS
9.3 UI Settings.................................................................................................................. 82
This section lists the changes and updates that have been made to the document since May
2019 (MASS 3.0)
• Added MASS service manager documentation and revised installation procedure in section 2.4
• Added Profile Scheduler feature documentation in section 7.5.
• Added User Management feature documentation in section 9.5
• Added AI documentation in chapter 10
• Added system configuration backup in section in section 9.1
• Revised Zones Logic, removed "view zone", added documentation of alarm zone testing and
documented system default profile setting in Sections 7
• Added Language Selection and Cursor Coordinates documentation in section 4.5
• Revised Plugin page see section 9.4
• Added new threshold schemes and full documentation per model in section 5.3
• Refreshed Sensor Edit mode figures, and added Clear DTM option documentation in section 3.3.
• Added Track Merging Documentation in section 5.5
• Refreshed System configuration documentation to include new UI page and https options in
chapter 9.
• System Health Dashboard – showing critical error messages. Covered in section 4.6.
• GPS Sensors – allowing “Blue-Force” automatic classification within MASS based on GPS position
reported by devices carried by friendly targets. Covered in section 11.
This guide is designed to aid users in the installation and operation of MASS (Magos Area
Surveillance System). MASS is a multi-feature command and control software, developed and
designed for use with Magos radar sensors and third party cameras and VMS.
This guide is intended for both MASS administrators and users.
This guide refers to MASS software version 3.0.
This guide is designed for all level of users. For quick installation and setup refer to Chapters 2 &
3, respectively. These cover the minimum operations required for setting up a new MASS
installation in a new site.
Chapter 4 covers MASS operation once the setup stage is complete.
The rest of the chapters contain detailed description of site-setup procedure and MASS
capabilities.
Magos was established in 2007 to realize its co-founders' vision of bringing advanced radar
technology to the security and perimeter protection and detection market. We are experts in low
cost, low power consumption, high performance radars that can be easily integrated with existing
VMS, PSIM and other control software and automatic PTZ slew-to-cue for an end-to-end cost
effective and easily maintained solution of the customer’s security requirements.
Medium Details
Email support@magosys.com
Mail Gad Feinstein 13 Office 225,
Rehovot
Israel
7638517
Website www.magosys.com
In addition, various actions required for proper integration of the MASS with 3rd party VMS/PSIM
software are documented in version specific integration manuals. These can be found in the
above link. For a full and updated list of supported 3rd party integrations please refer to the online
"Knowledge Base" at https://partners.magosys.com/portal/wiki
MASS has two components: Server side and client side. This chapter provides a system
overview, specifies the measures needed for enabling installation, namely installation
prerequisites and required permissions, and provides instructions for the installation process.
MASS server is a web based “Server-Client” system. The server-side software is typically
installed on a server/computer that is active 24/7 and can be accessed via Ethernet/LAN by
potential clients. Client software is a browser (typically Chrome) which can run anywhere on the
same network. The browser may be used on the server computer as well.
MASS client side application shows a bird's eye view of the protected area, thereby enabling you
to set up, configure, and monitor all installed sensors and their output.
MASS is a capable command and control software suite which allows real-time event
management. When integrated with a 3rd party VMS engine, events can be logged and replayed
in sync with relevant video streams.
For further details about related software and sensors, see section 1.3, Referenced Documents.
Before starting the installation of MASS, ensure that your sensors are supported by MASS and
that your system meets the system requirements, as specified in the following sections.
The SR radar sensors and ONVIF cameras are considered “native” to MASS and are referred to
as “sensors” in this manual.
NOTE
Contact Magos support or visit the partners portal for an updated list of supported
Camera models. In case a new model is required and it supports the above
requirements contact Magos Support to add to the supported model list.
Name Description
Name Description
CPU
Intel® Core™ i3 or better
RAM 4 GB or more
Network Ethernet 100 Mbit or better
Graphics Onboard GFX, AGP or PCI-Express, minimum 1024 x 768 (1280 x 1024
Adapter recommended), 16-bit color or better2
2.2.3 LICENSE
As a customer of Magos Systems a username and password for accessing the Magos Partner
Portal should be assigned to you by the Magos Support team.
It is recommended to login to the Partner Portal, browse to the license management page and
verify that you have an issued license ready for validation.
If you cannot access your account or your account does not include issued licenses contact your
local sales representative or the Magos Support team.
MASS has several defined permission levels. This section specifies these permissions, as well as
the tasks that require Magos administrator privileges and the methods for setting and editing a
password.
By default, MASS only has two pre-configured user-accounts, admin and guest. For adding and
managing users refer to 9.5.
This section contains step-by-step instructions for installing the MASS server application, as well
as for carrying out the measures required for proper operation of the software.
Ensure that you read this section carefully and carry out all specified instructions before
launching the application.
2.4.1 GENERAL
The installation process is divided into the following procedures:
1. Installing the application – Installing the various software components required for running the
MASS server on your computer.
2. Activating and registering the software license– Activating your purchased software, registering the
software, and acquiring the software's license.
NOTE
This chapter refers only to first time installation. For upgrading existing
installation while preserving site data please contact support@magosys.com.
NOTE
Downloading the software from Magos portal requires registration and a
username and password. Please contact support@magosys.com
7. Use the components display to change installation options, or click Browse… to change installation
path.
8. Click Next to proceed to the installation summary window, then click Install.
9. If User Account Control is active on the computer, the Confirm Installation screen appears,
requesting you to confirm the installation of MASS on your computer. This screen appears every
time the server is installed, namely: not only on first installation but also if the server had to be
uninstalled and is later re-installed.
10. Click Finish to exit the wizard. A shortcut for launching the MASS server application is created on
the desktop, called MASS Service Manager.
11. You might be required to restart windows in order to properly run the MASS Service Manager, and
the server manager application.
The service manager is accessible via a shortcut ( ) in the system tray icons menu. If this
icon is not visible for some reason, double click the "MASS Service Manager" shortcut on your
desktop (Figure 3), or run the "ServiceManager.exe" from the installation path (default path is:
"C:\Program Files\MASS3\ServiceManager.exe").
1. Click the tray icon short-cut to open the service manager menu:
5. Fill the form, while ensuring that you enter the following:
• Name – company name
• A valid email address – this is the address to which the issued license file will be sent
IMPORTANT
When selecting a MAC address, verify that the MAC address is of the permanent
adapters, Don’t choose a removable or temporary network adapter.
6. If connected to the internet, click Send Request, and verify that the license request was
successfully sent.
If the send process failed due to lack of connection to the Internet or for any other reason, an
error message is displayed.
7. For "offline" registration, click on Download Request to download the license request file and send
the file to support@magosys.com, or use the online license activation process via the Magos
License Server: https://license.magosys.com/.
Once the support team has processed the license request, a lincense.lic file will be sent to the
email address listed in the request. This could take up to 1 working day.
8. If you have access to the Magos Partners Portal, and you've received an e-mail confirming that a
license has been issues to you follow the instructions in the mail to activate your license using the
license request file you've downloaded in the previous step.
9. Once you receive the license.lic file, login to the MASS server again. The License page should
open automatically. If the license page hasn't opened, you may access it directly by typing <MASS
server IP address>:3000/License in the internet browser address line.
10. Use the Upload license file section to upload the license file by clicking Choose file to browse for
the license file's location on your computer. Alternatively, drag the file to the intended section and
click Upload license.
IMPORTANT
To review your license details, browse to Error! Hyperlink reference not valid..
Once the server-side software is installed and running, you can access MASS from any web-
browser supporting device, provided that both the server running machine and the client side are
connected the same LAN.
This chapter covers the basic necessary steps for initial setup of your site and is designed as a
"quick start" guide. For a more detailed coverage of all MASS features review the next chapters.
Most of the setup steps are only performed during the site setup, and in the event a sensor needs
to be changed or moved.
To launch MASS:
1. Before accessing the MASS server, ensure that your license is updated (see section 2.4.4,
Activating and Registering the Software License, on page 17), and that MASS service is running on
the server machine (see section 2.4.3).
2. Access the client view:
• If you are running the client side on the same computer as the server: http://localhost:3000, or Click
the MASS icon in the system tray icons menu and select Open MASS Client.
• If you are running the client side on another computer: http://[MASS SERVER IP ADDRESS]:3000,
where [MASS SERVER IP ADDRESS] is the IP address of the computer running the MASS server
application (for example, for 192.168.1.207 IP address, use: http://192.168.1.207:3000 ).
The MASS login screen appears, prompting you to provide your credentials.
3. When accessing MASS for the first time you must login as the administrator.
Username: admin
Password: password
The first step when setting up a protected site is to place the map / satellite picture of the area as
a background on top of which targets, sensors, and areas are displayed, and saving the site
location as home-screen.
This ensures the map view will return to the area of interest after each editing phase, and new
sensors will be placed in the area of interest. If no default view is defined, new sensors are
placed at [0,0] coordinates, which is off the west coast of Africa.
The map is automatically acquired from online mapping engines.
1. Click the icon on the left hand side of the Map view. If connected to the internet, type the
address of the site. Otherwise, type in Lat. Long. Coordinates in decimal, north east format (e.g.
"40.748502°, -73.985652°" will take you to the Empire State Building in Manhattan).
2. Right click the icon and confirm the change of your Home map in the prompt window.
3. Click Yes to confirm.
5. You can now navigate to the Home screen at any time by left-clicking on the icon on the map.
6. In order to view the entire site, click on the icon on the map. This will set the zoom and pan to
include all defined sensors.
or click on the or buttons (on the left hand side of the map view) for zooming in or out
respectively. In touchscreen systems use standard two finger gestures for zooming in or out.
This process of positioning and configuring a sensor is required for receiving a correct picture of
the state of the protected area. Because the software displays the radar detections and tracks on
the map relative to their respective positions on the map, inaccurate positioning will result in
misleading readings. Furthermore, the positioning of the cameras relative to the radars (and to
the map) must be accurate, otherwise the automatic camera cueing will not function as expected
and as a result, target verification (through video stream) will not be possible.
3.3.1 PREPARATIONS
Ensure the following "checklist" is complete in order to allow a swift and error-free setup
procedure:
1. Connection: make sure all sensors are powered and connected to the network before starting this
phase. Ethernet link to each sensor may be tested using PING, Magos' Radar Manager Application
for radar sensors or ONVIF Device Manager for cameras.
2. Sensor details: Make sure the IP addresses and MAC addresses of all sensors are known, and
listed.
3. Sensor locations: If possible verify GPS position of each of the sensors. In addition measure the
installation height relative to protected area ground level.
4. Sensor heading: For radars, measure (using a compass) or estimate the direction in which the
radar is facing relative to the north.
5. ONVIF account usernames and passwords required to access PTZ control for each camera sensor
6. Make sure there is an accessible tool for viewing camera video stream (such as a VMS, camera
webpage or ONVIF device manager)
2. To add a Radar, move the cursor over the RADARS menu and click the icon.
The Edit Mode window now opens with the Edit Radar Sensor pane on the left hand side.
MASS Server continuously scans for Magos radars and ONVIF devices that are connected on the
same network
3. To select an auto-detected sensor: click the icon (bottom left of the screen next to the
Discovered heading) to expand the list of auto detected sensors. A list of all auto-detected sensors
that are not yet defined on the server. Review either the Name or MAC column, or the IP Address
column to locate to desired radar. Ensure that the Type column lists the sensor as RADAR and
that radar model matches the Model column.
4. In case sensors are not online during the setup stage, or auto-detection failed, you can manually
add the sensor by filling the General sensor details tab (top left of the edit mode screen). If sensor
was selected in the previous step, just replace the default values in the Name and Color fields.
5. Switch to the "Location" tab on the top left of the edit mode window, and fill in the sensor location
data.
mode window on the right hand side to visually place the radar. Drag and drop the icon on the
estimated position of the sensor or use Ctrl+→/Ctrl+/Ctrl+↑/Ctrl+↓ for moving the radar
location (use Ctrl+Shift+[Arrow] for finer steps). Use Ctrl+[ or Ctrl+] to rotate the radar.
6. When done click on the Save button (top left) to save changes made locally, then click Finish on
the center bottom of the Edit Mode window (if changes haven't been saved a warning window
appears). The Edit Mode window will close, display will return to the Map view and a confirmation
window will appear.
Additional sensor properties and radar location calibration methods are covered in chapter 4.
• Remove sensor: click on the icon next to the radar name in the list, to remove the sensor from
MASS
• Edit Sensor: click on the icon next to the radar name in the list to return to Edit Mode and
change sensor settings.
3. A single click on the track head (of either a "live" target or one from the history layer) will open the
Target Info window, displaying target speed, distance from detecting sensor, confidence level and
detection source (radar name). Double click on track head, or clicking on the icon will re-direct
the nearest camera to start auto-tracking the selected target.
2. To add a camera, move the cursor over the CAMERAS menu and click the icon.
The Edit Mode window now opens with the Edit Camera Sensor pane on the left hand side.
Figure 22: Edit Mode for adding and editing a Camera Sensor
MASS Server continuously scans for Magos radars and ONVIF devices that are connected on the
same network
3. To select an auto-detected sensor: click the icon (bottom left of the screen next to the
Discovered heading) to expand the list of auto detected sensors. A list of all auto-detected sensors
that are not yet defined on the server. Review either the Name or MAC column, or the IP Address
column to locate to desired camera. Ensure that the Type column lists the sensor as CAMERA and
The icon next to the model will be highlighted in orange whenever extra
steps are required through the camera configuration web-interface for proper
operation with MASS, as shown in the example.
5. Switch to the "Location" tab on the top left of the edit mode window, and fill in the sensor location
data.
6. In order to set location, fill in the Latitude and Longitude with the geographic coordinates of the
camera. Alternatively use the map view within the Edit mode window on the right hand side to
visually place the radar. Drag and drop the icon to the estimated position of the sensor or use
Ctrl+→/Ctrl+/Ctrl+↑/Ctrl+↓ for moving the camera location (use Ctrl+Shift+[Arrow] for finer
steps).
Figure 26: Camera Edit Mode Map View – Setting Rotation Angle
8. When done click on the Save button (top left) to save changes made locally, then click Finish on
the center bottom of the Edit Mode window (if changes haven't been saved a warning window
appears). The Edit Mode window will close, display will return to the Map view and a confirmation
window will appear.
• Remove sensor: click on the icon next to the camera name in the list, to remove the sensor
from MASS
• Edit Sensor: click on the icon next to the camera name in the list to return to Edit Mode and
change sensor settings.
• Auto Tracking: click on the / to toggle camera auto-tracking mode on or off respectively.
When on, camera will automatically track any targets that have been reported by one of the radar
sensors.
This chapter can be considered as a "quick-start" guide allowing the reader to quickly place
sensors and review their output and basic MASS functionality. For a complete site setup there
are several additional steps that might be required. Please follow the list below according to the
requirements of your site:
• Fine tuning and calibrating radar location and detection performance: See chapter 5.
• Fine tuning and calibrating camera location: See chapter 6.
• Setting up areas of interest and their priority– alarm zones and coverage zone: See chapter 7
• Advanced map settings: creating a local cache of the map and additional map controls: See
chapter 8
• Additional Configuration options: See chapter 9
• Basic user operations, system behavior description and routine SW operation that does not require
administrator privileges: See chapter 4
This chapter covers the basic operations available to the end user when operating the MASS. All
the actions covered in this chapter have no effect on server-side application and only affect the
current view on the client side. This chapter is designated for end users and operators and
covers routine actions required for operating the MASS once the site configuration and setup
stage is complete.
4.1 LAYERS
This section describes the various viewable layers. Map view is composed of several "layers"
each includes a different set of visual aids that can be displayed on top of the map view.
Move the cursor over the button on the top right of the map view, to open the layers menu:
The items in the display menu are the various layers. Click the checkbox next to them to make this layer
visible/invisible.
• Radars: This layer displays the radar sensor location on map. Radars are indicated by the
icon, where the color is user configurable via the sensor edit mode (see section 3.3.2). Icon
behavior:
o When radar is connected and communicating with the MASS, a round "halo" is constantly
flashing around the icon.
o When radar is not communicating with the MASS for any reason, the halo is not displayed, and
the icon changes to .
o When radar is disabled via the sensor edit mode (see 3.3.2), halo is not displayed, and the
icon changes to .
o Upon setup, in edit mode only, when radar is first defined and communication was not yet
established with it, the icon displayed is .
• Radar Coverage: Displays the estimated coverage area as a semi-transparent grey oval shape.
The white lines are spaced every 100m radially, relative to the radar location. Clicking on a radar
sensor name in the RADARS menu, within the Settings side menu.
• Alarm Zones: Displays the alarm/view polygons defined in the currently active profile. See chapter
7 for more info on zones. Alarm/View zone polygons are displayed as a dashed orange line on the
outline of the polygon. If a Zone is defined as an Alarm Zone, whenever an alarm is triggered (by a
target entering the zone) the polygon will momentarily flash in orange. The same occurs when zone
is clicked in the Alarm Zones menu within the settings side menu.
This section describes how to modify Map display options for better visibility and user
convenience.
The measurement tool is an auxiliary site-planning and target management tool, which allows
distance measurements on top of the Map View.
1. On the right side of the screen there is a ruler icon , move the mouse over the icon to open the
measurement tool.
2. A window “Measure distances and areas” will be opened.
7. As of the second point, the path distance (length of the line connecting the measurement points) is
also displayed in the measurement menu.
8. As of the third point, the area of the polygon defined by the measurement points is also displayed in
the measurement window.
9. Click on “Finish measurement” and a summary will appear on spot. You can close this window
using the X button on the top right.
Presets are pre-defined location and zoom level settings of the map view. When the protected
site is too large to be included conveniently in a single view, presets can be used to manually
navigate the view between the various areas of interest, while still retaining a high zoom level that
allows the desired discretion level of details.
1. Open the main menu by clicking the icon on the top left of the screen. The Settings bar
appears.
2. Move the cursor over the PRESETS menu and click the . Icon to add a new preset.
1. Open the main menu by clicking the icon on the top left of the screen, The Settings bar
appears.
2. Expand the PRESETS menu to open the presets list.
3. Move the cursor over the preferred preset and click the icon to delete the preset.
4. When prompted whether you are sure you want to delete the selected preset, click Yes.
The deleted preset will be removed from the Presets section.
NOTE
If Display Mode is set to "Fit To Screen" (see 3.2.2) whenever the page is
refreshed the display will revert to the "Fit to Screen" mode in which the map is
centered such that all sensors are included in the view.
4.5 MISCELLANEOUS
4.5.1 SOUND
To enable or disable sound open the setting side bar by clicking the icon and expand the
USER menu.
Click the Sound option to toggle sound On /Off.
When enabled, a sound notification will be played whenever an Alarm zone becomes activated.
To configure the sound played use the system configuration page. Refer to 9 for more details.
4.5.2 LANGUAGE
As of MASS 3.20 there is multi-language support for all system menus and text messages.
Language can be set via the USER menu in the settings side bar:
NOTE
Language setting is user specific. Default language for all users is English.
Changing language for administrator, for example, does not apply to other
users. To change default User Interface language use the system
configuration page, as described in 9
MASS includes a system-health module that monitors connection and proper operation of all
system sub-components and sensors. These include plug-ins, AI-Appliances, GPS Sensors,
radars and cameras. The system-health is not an error log and will only display currently active
errors. Once error is resolved it will automatically be removed from the health panel.
System health notifications are displayed on the top right of the map view whenever they occur.
The system health panel can then be access by clicking on the notification tab ( ). This will open the
System Health Panel window as shown in Figure 48.
User can dismiss each error by clicking the button next to it.
User can also filter dismissed errors from the system-health panel by clicking the
on the bottom right. This allows focusing only on newly occurred errors and dis-regarding pre-
known errors already handled.
Finally, once all existing errors are dismissed by the user, the notification bar in the map view will
collapse as shown in Figure 49. As long as the error is still active the system can always be
accessed by moving the mouse cursor over the collapsed notification and tab and clicking it.
MASS contains many useful keyboard shortcuts detailed in the table below.
<CTRL> + Direction arrow Move sensor to arrow Radar and Camera wizard
direction in large steps
This chapter describes additional features available for further fine tuning the radar sensor
performance and location.
Detection related settings and synchronization settings are individual per radar sensor. The
following steps describe them:
NOTE
In current version this operation is only available for Magos Support
personnel.
4. Threshold scheme: use the dropdown menu to choose the "threshold scheme" that best matches
the radar and the observed terrain as described in 5.3.
5. Threshold Factor: This parameter adjusts the thresholds over the entire monitored area. Enter a
number or click the spinner arrows to adjust the field value. A positive number will increase the
thresholds and results in reduced sensitivity. Increase the value to reduce false alarm rates; A
negative number will decrease thresholds and results in increased sensitivity. Decrease value to
improve detection performance.
Synchronize Radars:
To avoid cross interference between radars use the synchronization feature.
NOTE
Timing parameters greatly vary between radar models. Consult with Magos
support if you are unfamiliar with recommended settings per your model.
6. First enable the synchronization by selecting Enable from the Sync dropdown menu.
7. Adjust the Sweep Time and Slot values: Assign a different Slot offset to each adjacent radar, and
ensure that overall Sweep Time value is equal or greater than the Slot Time. E.g. For SR500-I,
minimal slot time is 100ms, minimal Sweep time is 400ms. To sync 3 radars, assign slots 0, 100
and 200 to each of the radars respective. The total allotted time is 0-300ms which is below the
Sweep Time, so sweep time can remain at the default value of 400ms.
A threshold scheme is custom tailored threshold level per range. The thresholds are used to filter
non-relevant detections generated by clutter and thus reducing the chances that the tracker will
declare a valid target based on detection generated by clutter/non-relevant targets.
Threshold schemes are model specific, and nominally the default threshold scheme per model
should provide the best results. However in some extreme cases, where the observed terrain
defers from the normal scheme of operation, radar performance in terms of target detection
probability or in terms of nuisance alarm rate can be further optimized by modifying the threshold
scheme. This section covers the various available schemes per model.
5.3.3 SCEPTER-C
• Normal – Default Threshold scheme for this model. Suites most terrains and scenarios.
• OpenField – In this scheme radar becomes more sensitive (compared to Normal) in all ranges but
mostly in short ranges. Use this scheme in clutter/nuisance free environments, or in order to
improve radar detection performance in ranges up to 250 meters.
• Urban – In this scheme radar becomes less sensitive (compared to Normal) in all ranges. Use this
scheme in cluttered (urban or fauna/flora rich) environments, or in order to reduce nuisance alarms.
• Tangent – radar is more sensitive than Normal in short ranges (up to 150m), and less sensitive
above that. Found to be optimal in relatively cluttered environment for detecting tangent
approaching threats.
5.3.4 SR1000F
• Normal – Default Threshold scheme for this model. Suites most terrains and scenarios.
In order to declare a valid target there are numerous criteria that the collection of detection
(called "hypothesis") must meet. While default parameters have been optimized to suite almost
all scenarios, in some cases there is room for site-specific optimization. Tracker parameters are
global and apply to all the sensors in the system. The following steps describe the process of
viewing and changing these parameters:
5. Click Save on the bottom of the screen to apply any changes made.
6. When done click Close on the bottom of the screen, or click on the Magos logo on the top left to
return to the main Map View.
In some scenarios, e.g. when several radars cover the same area, or when extremely large
targets (boats, trucks) are observed, it is advantageous to merge nearby target reports into a
single track report and thus avoid multiple events generated by single target. This is can be
achieved by enabling Track Merging and adjusting the relevant parameters.
11. Click Save on the bottom of the screen to apply any changes made.
12. When done click Close on the bottom of the screen, or click on the Magos logo on the top left to
return to the main Map View.
The location and heading of radar sensors has to be accurately calibrated to ensure accurate
tracking and cueing of the cameras at tracked targets.
Prior to starting this procedure, it is recommended to measure the heading and GPS location of
each radar, and fill them in the appropriate fields as described in section 3.3.2. This will provide a
rough starting point for each sensor which will make fine tuning the position easier.
2. Figure 50 shows an example of the calibration process. In the left image, the radar is misplaced by
roughly 40 meters and rotated by five degrees. The calibration process in this case includes first
rotating the sensor on the map until the track lines are parallel to landmarks (in our case, roads),
and then shifting the radar till the landmarks coincide (in this case, the radar was shifted till tracks
around the roundabout matched exactly to the roundabout in the map). Follow the steps described
in section 3.3.2 to adjust radar position.
NOTE
In the position calibration process, it is highly recommended to start with rotating
the radar until the tracks are parallel to landmarks, and then shift the radar for
perfect match.
General tips:
3. In our case, the tracks were drawn by random traffic. If traffic is not available, a human target,
walking or driving, has to trace the tracks along visible landmarks. Then the process can be
completed.
4. Repeat this procedure with all other radars. If two or more radars have overlapping coverage areas,
after fine-tuning the first radar position, the other radars can be positioned by moving them so that
the reported target track overlaps that of the first radar (as long as the target is reported by both
radars).
5. To view the output of more than one radar sensor while in Edit Mode locate the desired sensors in
the Existing sensors list and check the checkbox next to it - see Figure 14.
This chapter describes additional features available for further fine tuning the camera sensor
performance and location.
This chapter explains the general mechanisms control camera movement in the MASS. It does
not include actual instructions on how to adjust parameters, these are covered in the next sub-
sections.
The location and heading of camera sensors must be accurately calibrated to ensure that the
video feed from the camera will include the target at any time.
Prior to starting this procedure, it is recommended to measure the GPS location and installation
height of each camera, and fill them in the appropriate fields as described in 3.3.4. This will
provide a rough starting point for each sensor which will make fine tuning the position easier.
IMPORTANT
It is extremely important that camera is perfectly leveled when installed.
Otherwise, if installed with a tilt, camera will be looking too low or too high
when auto-queued to a given position depending on the pan angle it was
directed to.
Camera calibration includes fine tuning of several parameters: Location and heading (required for
accurate pan commands), desired zoom level (required for accurate zoom commands) and
installation height and monitored area ground height (required for accurate tilt commands).
The following steps include instructions on how to easily calibrate and fine-tune the various
parameters.
1. Ensure that you have access to an external tool that allows manual operation of the camera and
video feed display.
2. After setting up the camera, re-enter the Camera Edit Mode, and switch to the location tab (see
3.3.4 for instructions).
3. Click the Validate Location button to start the camera Location Wizard.
4. Step 1 – adjust position, height and azimuth (rotation angle) in the same manner that was
described in 3.3.4 – if this was already done proceed by clicking Next
• Click Add reference point. The point indicator ( ) now appears in the center of the map.
• Drag and drop the indicator to a known and visible landmark on the map.
• Using the external tool prepared in step 1, manually direct the camera such that the landmark
selected on the map is centered in the middle of the video frame.
• Click Lock.
• Repeat the above for 4 or more points. As more points are added, camera initial location on the
map view might change since the wizards constantly recalculates the exact camera position and
adjust accordingly.
• Once enough points are added you will be able to click Next to proceed to the validation stage.
6. Step 3 – Validating points. Click on each of the points in the list and verify in the camera video feed
that camera has been moved to the correct position. If validation fails on one of the points, return to
the previous stage by clicking Back. Click on the icon next to the erroneous point and repeat
the above steps.
7. When done camera FOV can also be clicked and dragged in the map view to various landmarks to
ensure that position and heading is properly aligned. At this stage disregard zoom and tilt – this
means you have to manually adjust the zoom or tilt levels until the desired landmark is seen in the
camera video feed.
8. When done click Next to exit the wizard and update camera position.
9. Click Save then Finish to exit edit mode and return to the map view.
1. Each camera model has its own "zoom profile", that is, a list of FOV angles corresponding to
various zoom levels. By choosing the correct model as specified in section 3.3.4 you can ensure
that zoom parameters are properly calibrated.
2. The next step is to adjust desired field of view. Start with a wide field of view (default value is 70)
ensure that targets appear roughly in the middle of the screen, and then decrease the number to
improve visibility of targets.
1. During DTM tuning it is recommended to turn-off camera auto-tracking. See section 3.3.4 for
instructions.
6. In addition, the DTM Editing menu pops-up at the bottom left of the screen:
7. Click on the menu, and adjust the point altitude - either type a number or use the up/down arrow
key. At this stage it is recommended to verify in the camera video feed that the picture is centered
on ground level.
8. When done adjusting, click the icon to save, or the to discard this vertex.
9. Repeat stages 4 to 8 for every location in the monitored area in which the camera is not aligned to
ground level.
To view edit or delete DTM vertexes:
10. Display the DTM layer via the Layers menu (see section 4.1).
11. For every point added a vertex is displays. Vertexes are connected with blue lines. Click on the
vertex representing the desired dot. A small menu appears next to it indicating coordinate and
defined ground level.
14. Use the option in the Edit Camera Location menu as described in 3.3.4.
Profiles are a set of user-defined zones. Depending on use-cases, several profiles can be
defined in the system, and switched between when required.
"Zones" are user-defined polygons that can be used to control system behavior based on
geographic location of targets or potential targets.
The following sections explain the zones' logic, how to create and edit these zones and how to
define profiles.
The above define logic could be confusing. Following are a few tips and use cases designed to
improve the intuition about these:
• For cameras:
• Use coverage "include" zones to define the area in which the camera is effective. For example, if
camera's effective range is 500m above which targets are too small, define a near-circle polygon
centered on the camera with radius of 500m.
o Use coverage "include" zones in places where you want the camera to auto-track. For example
if multiple Alarm zones defined within camera range and a specific camera is designated to
service only one of them, place coverage include zone only on that area.
Before defining zones it is recommended to create a profile which is a collection of zones. MASS
has a predefined "Generic" profile that by default doesn't contain zones. User can either add
zones to this profile or define a new profile. There is no limit on the number of profiles defined.
4. Enter desired profile name in the pop-up window, and click Save
5. The new profile is now selected. Any new zone added, or any zone edited will apply to this profile.
6. To switch between profile, expand the Profiles list in the Setting side menu and click on the profile
to be activated.
7. To delete a profile, expand the Profiles list in the Setting side menu, move the cursor over the
profile name, and click the next to it. Click Yes in the confirmation pop-up window.
3. Make sure the desired profile is currently active by clicking on it - the check-box next to the profile
4. Click the icon on the right hand side of the profile name to set it as default
5. In the profile menu the icon will now appear on the left hand side next to the profile name,
indicating it is the default system profile.
MASS supports an unlimited number of zones, which can be added by following the instructions
described in this section.
IMPORTANT
Prior to defining zones, ensure that the Alarm Zones check box in the Layers
menu is selected (see section 4.1) - otherwise the zones will not be visible.
In addition, Alarm Zones cannot be defined before a sensor (camera or radar)
has been added.
1. Open the main menu by clicking the icon on the top left of the screen.
2. Make sure that the requested profile is currently active.
3. Move the cursor over the ALARM ZONES menu and click the icon to add a new zone.
In the Map View the edit the zone editing options will appear.
Editing Zones:
8. On the top left of the page, click the button to open the Settings menu on the left of the
screen.
9. Expand the ALARM ZONES menu to open the zones list.
10. Move the cursor over the preferred zone and click the icon to edit the zone or the to delete
the zone.
11. To edit the vertex positions or add new vertexes to existing polygons, click the icon from the
Edit Zones side menu in editing mode:
• All zones are now displayed with semi-transparent red fill color polygons. The edges are marked
with dashed blue lines and the pre-defined vertexes are indicated by small white squares. In
addition, semi-transparent white squares appear on the center of each edge.
Alternatively, you can discard your changes by using either of the following options:
• Revert to the previous state by clicking Cancel.
• Delete fully-drawn polygons (whether newly defined or existing), by clicking the icon and then
clicking the zones to be removed.
When in this mode, an auxiliary menu is available.
12. On the top left of the page, click the button to open the Settings menu on the left of the
screen.
13. Expand the ALARM ZONES menu to open the zones list.
14. Move the cursor over the desired Zone name and click the icon to edit the zone or the to open
the Zone Info pane showing all the settings defined for this zone.
15. Use the ON and OFF buttons in the info panel to emulate an alarm generated by this zone. Clicking
the ON button will cause the alarm zone to continuously flash and an Alarm Sound will be played
(see section 4.5.1). In addition if any plugin is enabled, this will trigger the corresponding event in
that plugin (see section 9.4).
To create/edit/review a Coverage Zone repeat the steps defined in 7.3 for Alarm Zones. With the
following exceptions:
1. Use the Coverage Zones menu instead of Alarm Zones.
2. Colors: When first created the zone is light blue. After saved the zone will be either green bordered
with semi-transparent light green fill (for include Zone) or green bordered with semi-transparent
light grey (for exclude zone).
3. While in Zone Edit mode, move the mouse over the requested, and click it to open the Zone
Properties menu on the bottom left side of the screen.
As of MASS 3.1 a new "Profile Scheduler" feature has been introduced. This feature allows
creation of automatic time-based profile-switching events. This is useful for sites in which
required coverage and level of protection in several zones changes regularly during the day, or
between days of the week; for example if operator does not wants targets to be tracked on the
access road to the site during the day since traffic is allowed there, but after work hours the
access road becomes part of the secured area.
Using these 2 entities, along with the profiles described in 7.2 it is possible to control the coverage and
alarm behvaior of the security system according to zones and schedule.
A simple example would be to setup a "day profile" and "night profile". The day profile will exclude areas
in which traffic is allowed during the day. The night profile will include these areas using extended
coverage and alarm zones. In this scenario 2 calendars will be setup in the profile scheduler: "Work
Hours" and "Off Work Hours", and these will be assigned to "day" and "night" profile, respectively.
Finally events will be added to each of the calendars to cover the entire week schedule of the site.
10. Click the next to the calendar name in the list to expand the calendar sub-menu.
The MASS map interface is based on online mapping engines. However, if internet access is
restricted on the server, MASS map view can use locally stored maps.
In order to use these local maps, the local cache must first be created, using a computer on
which MASS is installed and that has at least temporary internet access.
4. On the top left of the page, click the button to open the Settings menu.
5. Open the OPTIONS menu and click on Create cache
6. A confirmation window will pop up; click Yes to start caching the maps.
7. Local caching takes several minutes depending on selected source and internet link quality. During
the caching process a progress bar is displayed:
8. Once caching is complete, repeat steps 2-3 and select "Local Map" to switch to the locally created
cache. For details, see section 3.2.1 Selecting the Map Image Source.
This parameter affects the units of the Location→Height and General→Field of View fields in the
Edit Camera menu (see section 3.3.4) as well as the Location→Height field in the Edit Radar
Sensor menu (see section 3.3.2)
1. On the top left of the page, click the button to open the Settings menu on the left of the
screen.
2. Expand the USER menu > User settings.
3. Click Height Units to toggle between Meters units or Feet units.
8.3 OVERLAY
The overlay feature allows the user to display a second graphic layer on top of the map displayed
in the Map View. This is useful when online maps are not up to date, or when wishing to add
more details/features to the map.
Displaying the map overlay is done using the layers menu.
To create MASS compatible overlay files from an existing image, contact Magos Support team.
The MASS system configuration is a collection of user configurable settings including web server
port, and configuration of various supported plug-ins.
NOTE
Mass must be restarted in order to apply some of the changes made in the
system configuration. In this case, user will be prompted to restart the service
via a popup window.
1. Open the main menu by clicking the icon on the top left of the screen.
2. Move the cursor over the USER menu, and click on the button.
3. The Mass System Configuration page will open.
Site setup including sensor positioning, alarm zone definitions, profiles, schedules etc. includes a
lot of user specific data.
This data is stored on the MASS server and is labeled as "Current System Configuration". It is
9.2 GENERAL
The general tab, within the system configuration page, includes the following options:
• Click next to the key/pem file or srt file to open windows file explorer and choose the
files. When done click Upload Certificates.
• UI Default Language: Click the drop down menu and choose default UI language for all users.
Users can then override the default value using the User Settings menu, as described in 4.5.2
9.3 UI SETTINGS
The general tab, within the system configuration
• Target Head Colors: Defines a color for the circle representing current target position.
• Target Tail Color: Defines a color for the line representing the path travelled by a live target
• Target History Color: Defines the color of the line representing the path travelled by a target that
is no longer detected.
• Target History Opacity: Defines the opacity level of target history lines. Valid values are between
1 (solid) to 0 (invisible).
• Target History Timeout (Sec): Number of seconds during which target history will be displayed
after it is no longer detected.
• Maximum History Size: Maximum number of target tracks to be retained in history. Use this to
limit amount of tracks saved and improve visibility/performance in "target" loaded scenarios.
MASS software has been integrated with various applications and software. The integrations
between Mass and the various applications typically require defining settings both on Mass and
the integrated software.
Each section of the Plugins page is covered in the integration-specific manual.
To access the plugins page from MASS, and add a plugin:
1. Open the main menu by clicking the icon on the top left of the screen.
2. Move the cursor over the USER menu, and click on the button.
3. The Mass System Configuration page will open, click the Plugins tab.
As of MASS 3.1 the MASS offers an interface for managing user accounts.
To Access the User Management Page:
1. Open the main menu by clicking the icon on the top left of the screen.
2. Move the cursor over the USER: menu title, and click the icon to open the User Manager
page:
To add/edit users:
4. Click the icon to add a new user or the icon to edit an existing user.
5. This opens the "Edit User Details" menu on the right hand side of the screen:
As of MASS 3.1, the software support integration with Magos proprietary AI appliance allowing
automatic target classification and class-based target and alarm filtering.
This application requires a designated server running the AI software, labeled "MASS+AI
Appliance". For more info about the MASS+AI solution contact Magos at: info@magosys.com
For instructions on how to setup the AI appliance itself, refer to the MASS+AI appliance user
guide at https://partners.magosys.com/portal/downloads (browse to the "Documentation" Tab).
This chapter covers the required settings and new features available in an "AI-Enabled" MASS
version.
The MASS+AI solution relies on dedicated servers running the AI target classification software.
The general concept is that once MASS has automatically directed a camera to a suspect target,
the video from target is then sent to the AI server. The AI server runs state-of-art image
processing algorithms to identify the target within the video frame, and classify it.
Target classification data is then sent to the MASS for further processing.
The MASS runs dedicated algorithm for merging the target video classification with the target
locations reported by the radar.
When properly setup, the result is that targets identified by the radar are automatically classified
and can then be filtered to screen out nuisance alarms caused by animals for example, or allow
advance zone monitoring capabilities (e.g. – allow only human traffic in a specific zone).
In terms of HW configuration, the MASS server software itself can either run on the same server
HW running the AI, or on a separate server. AI servers have a limited number of supported video
channels, and hence in some sites more than one AI server is required.
The following diagram illustrates a typical HW configuration and connection scheme:
In this instance, there are several AI servers, and MASS is running on a separate server.
Connection diagram is as follows:
• PTZ Cameras – connected to:
• Third party VMS/DVR for recording and real-time display,
• MASS server – to receive PTZ command
• AI Servers – to stream video into the server for further processing.
• Radar sensors – connected to:
• Radars are connected only to the MASS server, for transferring detection data and received
configuration commands.
• Third Party DVR/VMS Server – connected to:
• Cameras – to receive video streams
• MASS server – to receive alarms and log them in sync with video
• AI server – to receive target classification data in video format.
• Client Computer – for server-client and user interface.
• AI servers – connected to:
• Cameras
• MASS server – control interface and streaming video classification data
• VMS Server
• MASS Server – connected to:
• AI Servers
• Cameras – for PTZ control only
• Radars
• VMS Server – for sending alarms
In an AI enabled MASS system, the target (and alarm) generation process slightly varies from a
non-AI system.
The process is as follows:
• Radar sensors detect a target
• At this stage, depending on user preferences and definitions, the target will be declared and
displayed on the Map View as a "non-classified" target (assuming user has not applied target class
filtering).
• The MASS Resource Scheduler chooses a camera and sends a PTZ command to direct it to the
position of the suspect target
• The MASS Resource Scheduler instructs the AI server to start processing the video stream from
the assigned camera.
• The AI server runs the classification algorithm and sends the MASS classification results (class and
estimated location within the video frame)
• The MASS runs a correlation algorithm to try and match classification information with the radar
reported targets
• If successful the target is now classified, and if user has not filtered the specific target class it will
be displayed in the Map View.
The target classification algorithm is extremely complex and the resulting raw classification data
is very diverse.
For simplicity, the MASS user interfaces grouped the numerous classification objects into 4
possible groups:
• Person – including only human targets
• Bike – including bicycles and motor-cycles
• Vehicle – including cars, trucks, buses, trains, airplanes and boats
• Animal – including birds, cats, dogs, horses, sheep, cow, elephants, bears, zebras, giraffes and
other wild-animals
The 4 target classes are displayed in the map view by assigning a color to the track line (indicating the
entire tracked path of the target) and replacing the track head with a class related icon:
Target class is also displayed in the target info window when clicking on the track.
The first step in setting up a MASS+AI system is configuring the AI appliances connected to the
MASS server (even if MASS is running on the same server HW as the AI appliance).
Prior to this step ensure that:
• MASS has Ethernet connection to the AI server (or running on the same machine)
• Both MASS and the AI server are connected to the cameras
• All required camera sensors have been setup in the MASS, and are set to auto-tracking
• AI server IP address is known (see the AI Appliance user manual for details on server network
discovery methods)
In an AI enabled MASS installation zone logic slightly changes from the logic described in 7.1.
In terms of Coverage Zones there is no difference at all.
In terms of Alarm/View zones following are the differences:
• When no alarm zone is defined in the system, all targets are displayed by default within the defined
coverage zones of the sensors.
1. Open the main menu by clicking the icon on the top left of the screen.
2. Move the cursor over the ALARM ZONES menu and click the icon to add a new zone, or
expand the menu, and click the next to an existing alarm zone to edit it.
3. On the bottom left of the screen the Edit Alarm Zone menu opens:
As of MASS 3.21.0 MASS supports the new “Blue Force” feature. The feature allows automatic
classification of “friendly”, predefined, targets in the MASS to avoid un-necessary alarms. For
example, this feature can be used to filter alarms caused by routine patrols of the security
personnel within the monitored area while maintaining protection against unwanted perpetrators.
The feature relies on GPS location readings from a device carried by the authorized
personnel/vehicle and correlates those to track location reported by the radar.
This feature requires 3 modules:
• GPS Gateway Server – a computer with the “GPS Gateway Server” installed on it.
• MASS Server – running MASS 3.21.0 or above, with network access to the GPS Gateway server
• Magos GPS Tracker application – an android device with a GPS sensor, running the Magos GPS
Tracker application, with network access (cellular or WiFi) to the GPS Gateway Server.
The following sections will review the 3 modules.
https://partners.magosys.com/portal/downloads/
• Using the Windows Services panel ensure that the “MAGOS-GPS-Gateway” service is running
• Ensure that port 44300 is accessible, and that there is network access to the MASS server.
There are no specific HW requirements on the host machine. Operating system should be Windows 8
and above.
No additional configuration is needed.
Currently the HW requirements for the end device is that it is an Android machine with a GPS sensor.
In some cases, other OS and end devices might be supported – contact Magos Support team for more
information.
• Download and install the GPS Tracker Application Apk file from the Magos partners portal:
https://partners.magosys.com/portal/downloads/
The application requires permission to access device location.
• Run the App and tap the settings button ( ) on the top right of the screen.
• Tap the “Enable radio button to turn on the location reporting to the GPS gateway.
Once GPS Gateway server is installed and the GPS application has been installed on one or
more devices, the final step is enabling and configuring the GPS plugin within the MASS
software.
To Enable the GPS Plugin:
1. Click the icon to display the Settings bar.
2. Click on the icon next to the USER menu to access the System Configuration window.
3. Click the Plugins tab, then click on the bottom right of the screen.
4. Check the GPS Manager plugin and click .
5. The GPS Manager plugin configuration menu now appears in the Plugins tab.
6. Type the IP address of the GPS Gateway server in the Server WS url field.
7. Click the radio button to enable the plugin.
8. Click on the bottom of the screen and return to the MASS map view.
11. The Add GPS Sensor menu will open. This menu lists all the devices that are currently connected
to the GPS Gateway server and are not yet authorized as “known” sensors (meaning devices that
have the Magos GPS Application installed and running)
12. Click the next to add each connected device to the “Known” sensors list, then click Yes. The
device will be removed from the candidates list, and will now appear under the GPS SENSORS list
in the settings bar.
13. The GPS sensor information can now be accessed by moving the mouse over the sensor name
and clicking the button. Sensor info includes Name, State (Enabled/Disabled) and Status
(Connected/Disconnected).
14. The GPS sensor can be edited moving the mouse over the sensor name and clicking the
button. The sensor can be enabled/disabled by clicking the Enable radio button. Click Save to
apply changes made.
Camera panning. A horizontal camera movement, in which the camera points left or right from a fixed
location such as a tripod.
Camera tilt. A vertical camera movement, in which the camera points up or down from a fixed location
such as a tripod.
Magos administrator. The highest permission level in MASS. A Magos administrator is authorized to
view the entire system and to carry out certain tasks that involve making changes to the
system.
Map caching. The process used for storing the map data locally on server. Such a configuration is ideal
for installations where the server’s connection to the Internet is of low bandwidth or non-
existent.
PTZ. http://www.networkwebcams.com/ip-camera-learning-center/2008/07/08/glossary-term-pan-tilt-
zoom-ptz/
Panning. http://www.networkwebcams.com/ip-camera-learning-center/2008/07/08/glossary-term-pan-
tilt-zoom-ptz/
PTZ Slew to Cue. “Slew to Cue” refers to the integration of a radar or other target detection device,
which instruct and electro-optic or infra-red surveillance PTZ camera where to point.
The detection sensor - a radar, in the case of MASS - is designed to detect the target
and pinpoint its location, then transmit that information to the PTZ camera which in turn
auto-tracks, identifies and recognizes the target. Slew to cue is considered the best
solution for long 24/7 security and surveillance, due to a radar's ability to provide 360-
degree coverage and detect vehicle-sized targets up to 40km away for marine, ground
or aerial targets day or night, even in bad weather conditions. The day/night PTZ
surveillance cameras can then recognize and identify the targets that are detected.
Tracks. Lines indicating the movement course (track) of a currently active target. The black dot at the
end of the line indicates the most current position of the target, as detected by the
radar. The color of the line matches the color assigned to the sensor that reported the
track.
Zooming. Zooming is the process of adjusting the focal length of a camera lens to make a subject
appear close or far away, based on the setting. Zooming is carried out by using a zoom
lens, as opposed to a fixed focal length (prime) lens.