Pelco Calipsa Web App Reference Guide reference-guide
Calipsa® Professional
Reference Guide
Document number:C6749M
Publication date:02/23
C6749M | 02/23 1
Calipsa® Professional Reference Guide
Table of Contents
Accessing Calipsa 5
Calipsa Dashboard 6
Accessing Calipsa 6
Calipsa Dashboard Features 6
Sidebar Features 8
Clients 9
Reports 9
Most True and False Alarming Sites 10
Most True Alarming Sites 10
Most False Alarming Sites 10
Analytics 11
Basic Camera Requirements 11
Camera Placement 11
Calipsa Alarm Definitions 12
True Alarm 12
False Alarm 12
Reduction 12
Recall 13
Alarms 14
Accessing Alarms 14
Alarms Page 18
Latest Alarm 18
Labeling 19
Filtering 19
Alarms Queue 20
Alarm Tools 21
Show Annotations 21
Add/Edit Mask 21
Share Alarm 21
Searching and Filtering Alarms 22
Show Drop-down Menu 22
Filter Funnel 22
Customizing Alarm Overlay 24
Masking Configuration 24
Adding and Editing Masking 27
Selecting a Camera 27
Editing a Mask 27
Human and Vehicle Filtering 29
Enabling and Disabling Human and Vehicle Filtering 29
User Management 31
Managing Users 31
C6749M | 02/23 2
Calipsa® Professional Reference Guide
Accessing Users Window 31
Adding a New User 31
Editing Users 33
Deleting Users 33
Sharing for Installers 34
Sharing Sites 34
Sharing for Key Holders 38
Sharing Sites 38
Creating and Deleting Clients 44
Grouping Feature 46
Client Grouping 46
Overview 46
Managing Groups 48
Creating A New Group 49
Rename group 49
Delete group 50
Refresh 50
Reports 51
Accessing Reports 51
Accessing Reports through Report 51
Accessing Reports through Clients 51
Reporting Advanced User Guide 55
Direct to Reports 55
Accessing Reports through Report 55
Selecting Mode Reporting 56
Report Page 57
Summary Reports 65
Camera Selection 65
Duration 65
Activity Chart 66
Download 66
Camera List 66
Automatic Reports 68
Automatic Report 68
Add Report 68
Labelling Alarms 71
Alarm Labelling 71
Audit Log 71
Alarm queue 72
Where to Categorize these topics? 73
Calipsa Protect 73
Advanced real-time analytics for video surveillance 73
Enabling Calipsa Protect 73
Advanced Analytic Features 74
C6749M | 02/23 3
Calipsa® Professional Reference Guide
Applying Scheduling 75
Alarms Tab 76
Detect Pro 78
Activating Scene Change 78
Bulk Activation / Deactivation 79
Setting Periods 79
Setting Schedules 80
Dashboard 81
Alarm Queue 82
Advanced Idle Detection 83
Audit Trail 85
Reviewing Change History 85
Object Detection Scheduling 87
Camera Level Scheduling 91
Frequently Asked Questions 92
How to use Arm / Disarm tool 92
Permissions 92
Arming and Disarming on the Mobile App 94
C6749M | 02/23 4
Calipsa® Professional Reference Guide
Accessing Calipsa
To log in and start using Calipsa, use the following link and enter your credentials:https://m.calipsa.io.
Note: If you do not have a login, contact your system administrator to grant you access.
After logging in, you will see the Calipsa Homepage. Use the sidebar on the left to navigate to a given
section.
C6749M | 02/23 5
Calipsa® Professional Reference Guide
Calipsa Dashboard
This section walks you through the different features of the Calipsa Dashboard.
Accessing Calipsa
Start by accessing the following link: https://m.calipsa.io.
Calipsa Dashboard Features
After logging into the link above, you’ll find a number of different options to explore.
Dashboard: Graphical user interface (GUI) which provides at-a-glance views of key performance
indicators (KPIs) relevant to all applicable alarms received into Calipsa.
C6749M | 02/23 6
Calipsa® Professional Reference Guide
Insights: Statistical display of the Number of filtered alarmsand the Percentage of filtered alarmsafter
Calipsa analysis.
Account Overview: Displays Total # of clients, Total # of sites, and Total # cameraswithin your Calipsa
account.
Alarms: Graphical display of Total alarmsreceived into Calipsa and the number of False alarms filtered
after analysis.
Idle cameras: List of specific Cameras, categorized by Clientand Site, which have not alarmed recently
(Last alarm).
Most alarming sites: List of Sitesthat have received the most alarms out of all Clientswithin Calipsa.
C6749M | 02/23 7
Calipsa® Professional Reference Guide
Sidebar Features
The Sidebar provides a method to navigate all available options within the dashboard.
l
Home:navigates you back to the Calipsa Dashboard
l
Clients: list of Clientsthat you’ve added into Calipsa
l
Alarms: direct link to Alarm Reporting
l
Report: allows you to View, Validate, and Download alarm datawithin a Summaryor Automatic
Reportformat
l
Help: Help Centerwhich provides Calipsa FAQs, Camera guides, etc.
l
Settings: provides a way to manage your Calipsa instance via: Account Settings, Security, and
Notifications
l
Manage Users: allows the opportunity to Manage usersand overall access to your sites
l
Log out: logs you out of Calipsa
C6749M | 02/23 8
Calipsa® Professional Reference Guide
Clients
The Clientstree structure is nested into the following format: Clients, Sites, and Cameras
Reports
By clicking Selectand choosing the specific Clients, Sites, Cameras, etc. OR by selecting Reportwithin
the Sidebar you’ll then have the ability to view statistical data for the chosen devices within the
Alarmspage.
C6749M | 02/23 9
Calipsa® Professional Reference Guide
Most True and False Alarming Sites
This section of the Calipsa homepage indicates which sites are creating the most true alarms and which
sites are creating the most false alarms. This helps you determine whether a site is creating difficulties.
Most True Alarming Sites
Some sites will have a high number of true alarms in Calipsa. A true alarm is one that Calipsa flags as a
legitimate cause of alarm, although it may not be. Often true alarms are triggered due to traffic from roads
around the monitored area or by designated employees on the site. If the alarm is coming from traffic
near the site, try masking the zone. If the alarm is coming from designated employees on the site, try
scheduling around hours of operation.
Most False Alarming Sites
A site might have a high number of false alarms. This might not be an issue for operators, but sending
that information across might carry an associated cost or might end up overloading the NVR. One
possibility is that the sensitivity for the trigger is too high and is triggering the alarm at the slightest
movement. One option is lowering the sensitivity of the trigger. A second option is adjusting the camera
direction.
C6749M | 02/23 10
Calipsa® Professional Reference Guide
Analytics
Basic Camera Requirements
This document outlines the basic requirements for camera setups on site for optimal performance with
the Calipsa AI.
Camera Placement
Objects of interest
l
Objects of Interest must occupy at least 8% of the screen height and 10% of the screen width.
Angle
l
We recommend an angle of 30°, and no more than 45° down from the horizontal.
Distance
l
Length: no more than 100 meters (330 ft) / width: 55 meters (180 ft).
Mounting
l
We recommend the camera being mounted around 2.5 meters (8 ft) or higher off the ground.
Camera Type: Single lens cameras provide the best detection results. Fish eye and extended lenses
may distort image definition and at present have lower performance. PTZ cameras are supported but
don’t allow for masks which may lead to false activations from peripheral areas.
Images per alarm : We require alarms to contain at least 2 non-identical images. If a system sends only 1
image or multiple copies of the same image, Calipsa is unable to distinguish between a moving or
stationary vehicle and will pass these alarms through a simpler algorithm. Since there is less information
available for the algorithm to make its decision (due to the lack of motion), there is a resulting decrease in
reduction.#
Shutter speed: The shutter speed is the length of time a camera’s shutter is open. This controls the
amount of light reaching the sensor. In low light situations, the shutter needs to stay open longer in order
for the sensor to receive enough light. A possible side effect of this is motion blur, where moving objects
become blurred. In environments where moving vehicles are important, we recommend shutter speeds
between 1/50 and 1/100.
Image resolution: Camera resolution defines how many individual pixels are available to record the
actual scene. This resolution is generally defined in megapixels, which indicates how many millions of
pixels are on the camera sensor that is used to record the scene. The more megapixels the camera
offers, the more information is being recorded in the image. We require a minimum resolution of 320x240
to process alarms accurately.
Note: Videofied systems are processed through a different algorithm to accommodate for the lower
resolution of these cameras. Please speak to your account manager if you have questions about this
specific system.
Lighting:The region of interest within a camera view must be illuminated sufficiently so that there is good
contrast between any objects of interest and the background. If an IR illuminator is being used for
nighttime viewing ensure that the area being monitored is within the illumination range specified by the
manufacturer.
C6749M | 02/23 11
Calipsa® Professional Reference Guide
Calipsa Alarm Definitions
True Alarm
A true alarm is any alarm that contains human activity. This includes any motion coming from a human or
a vehicle in the footage. Parked cars will not be marked as true. All true alarms will be passed to your
monitoring station for human verification by your team.
NOTE: If you receive single images, or identical images, the person or vehicle seen triggering the true
alarm will be marked in green. Since there is no motion in the alarms, parked cars will be flagged as true.
Click True Alarms triggered by stationary vehicle to troubleshoot this issue.
False Alarm
A false alarm is an alarm triggered when there is no human activity e.g., a cat running across the camera
view or a tree blowing in the wind. Calipsa marks these alarms as false and does not forward them to
your monitoring station.
Note: Some integrations forward both true and false alarms on to your monitoring station software where
it is then separated.
Reduction
Reduction is a measurement of how well the system has managed to reduce the number of nuisance
alarms. It is calculated from the number of alarms Calipsa deemed false that actually were false i.e.,
contained no human activity. Calipsa's current reduction is approximately 95%. This means that out of
100 alarms with no human activity we would expect our AI to correctly mark 95 of them as false.
Improving Reduction is a tricky process as we will only increase our reduction if it doesn't have a negative
impact on our current recall.
Note: Reduction is not the same as the percentage of alarms filtered out shown on your dashboard. The
percentage of alarms filtered out includes the correctly marked true alarms.
C6749M | 02/23 12
Calipsa® Professional Reference Guide
Recall
Recall is a measurement of the accuracy in determining true alarms i.e., alarms with actual human
activity. Recall is the most vital metric, since alarms with human activity must be marked true. Alarms
with human activity that are not marked true could mean a security breach. Calipsa's current recall is
currently just under 99%. This means that out of 100 alarms with human activity we would expect our AI
to mark 99 of them correctly as true.
Note: This is for single alarms, during an intrusion event we would generally expect a small number of
alarms to be triggered therefore the chance of missing an entire event is much lower.
C6749M | 02/23 13
Calipsa® Professional Reference Guide
Alarms
Accessing Alarms
In Calipsa you are able to view processed alarms as they come in. You can see if they were marked True
or False and why. The video below outlines all the features available in Calipsa's alarm page.
Link to a video that walks through this process.
There are two ways to navigate to the Alarms section in Calipsa. The most direct way is selecting Alarms
from the Main Menu.
Alternatively, you can select multiple Clients, Sites, and Cameras from the Clients list to view their
alarms. On the Client list, click Select in the lower left corner. You are now in Select mode.
C6749M | 02/23 14
Calipsa® Professional Reference Guide
Once in Select mode, select the boxes next to the Clients, Sites, and Cameras you want to report on.
Selecting a client will automatically select all sites associated with that client. Selecting a site will
automatically selects all cameras within the site.
C6749M | 02/23 15
Calipsa® Professional Reference Guide
Once you have selected all necessary items, click Switch to Alarms in the light grey text box.
After accessing Alarms from either the global navigation or select mode, you will see a catalogue of
alarms inCalipsa. If you accessed the Alarms section through the global navigation, Calipsa will pull
alarms from all cameras from the last 24 hours. When you first access the Alarms page, Auto-refresh is
enabled. Auto-refresh means that the list automatically displays new alarms at the top and continues to
update as new alarms are added.
C6749M | 02/23 16
Calipsa® Professional Reference Guide
Select an alarm to view the footage that triggered the alarm. Now you are able to review the footage and
determine why Calipsa marked it as a true or false alarm. Click Show Annotations for more information
on what the Calipsa AI saw.
C6749M | 02/23 17
Calipsa® Professional Reference Guide
Alarms Page
The Alarms Page displays every single alarm triggered in Calipsa.
Latest Alarm
The Latest Alarm is the last alarm that was triggered. When clicking on the latest alarm footage a new
page will open. This new page includes additional information on the alarm. Right below the footage,
select from the following options:
l
Save: Allows the alarm to be kept in the “Saved Alarms” section.
l
Full Screen: Sets the alarm footage in full screen mode.
l
Share: Allows the user to share the alarm’s footage and URL through the desired method or app.
C6749M | 02/23 18
Calipsa® Professional Reference Guide
Labeling
The labeling option indicates whether the alarm has been labeled as true or false. You have the option to
change the label by selecting either true or false.
Filtering
The filtering option enables you to filter your search based on clients, sites, and cameras. There is also a
section where you can choose a specific timeframe to search through the alarms. After the desired filters
are selected, click Submit.
C6749M | 02/23 19
Calipsa® Professional Reference Guide
Alarms Queue
The alarm queue enables you to see each alarm individually. Click each alarm to view the date of the
alarm, the site and camera that generated the alarm, and the label.
C6749M | 02/23 20
Calipsa® Professional Reference Guide
Alarm Tools
Alarms Tools enable you to show annotations, add/edit mask, and share alarms. Access Alarm Tools
next to the alarm.
Show Annotations
When you select Show Annotations in a true alarm, Calipsa will highlight the area of motion it detected
i.e., the cause of the alarm. The annotations include what the Calipsa AI determined the motion to be. For
instance, the source of the motion could be a person or a vehicle.
Add/Edit Mask
To access the masking page, click Add/Edit Mask. The masking page will open in a new tab.
Share Alarm
Selecting Share Alarm will open the user's emailing tool. This option allows you to share the alarm
information e.g., the owner of the site being monitored.
C6749M | 02/23 21
Calipsa® Professional Reference Guide
Searching and Filtering Alarms
Calipsa offers various filtering options when searching for alarms. At the top of the alarms queue, there
are two options: the show drop-down menu and the filter funnel.
Show Drop-down Menu
The Show drop-down menu allows you to select the types of alarms in the results list. You can show
alarms based on Validity, Label status, and Detection types. The reset button will automatically include
all options.
Filter Funnel
Access the Filter Alarms menu by clicking the Funnel icon. From this menu you can select specific
clients, sites, or cameras to display alarms. Click Select All to select all cameras in your Calipsa
account. In the bottom left corner you can set the duration, or date range, of alarms you want to view.
C6749M | 02/23 22
Calipsa® Professional Reference Guide
You can quickly pull the last 24 hours, last week, or last month. You can also manually select dates and
time, by selecting Other.
Note: Calipsa stores alarms for 30 days before clearing them from the platform.
C6749M | 02/23 23
Calipsa® Professional Reference Guide
Customizing Alarm Overlay
Calipsa offers a range of customization options for masking and highlighting. This guide shows you how
to change the color and opacity of the different areas.
Masking Configuration
Link to a video that walks through this process.
Note: This feature is found under settings at the Company level.
1. After signing in, click Settings from the main menu.
2. Under Settings, select Operation.
3. Next to Mark & Highlight Appearance, click Edit. You can change the color and opacity of the
mask or highlight as well as pick the highlighting style.
4. Click on the color menu. You can now select a color.
5. Adjust the opacity from 20% to 80%.
Note: You cannot reach 0% or 100% as that would remove or block the masked area.
C6749M | 02/23 24
Calipsa® Professional Reference Guide
6. Under Highlight style, select either a contour highlight or a box highlight.
Contour Highlight
Shown here is a contour highlight. The mask highlight is cropped around the edges of the figure shown in
the image.
Box Highlight
Shown here is a box highlight. The mask highlight appears as a box around the figure shown in the
image.
C6749M | 02/23 25
Calipsa® Professional Reference Guide
7. Click Save Changes.
C6749M | 02/23 26
Calipsa® Professional Reference Guide
Adding and Editing Masking
Calipsa enables you to mask off zones that you do not need monitored. This helps remove false alarms
from passing vehicles or pedestrians.
Selecting a Camera
Once a camera is properly set up in Calipsa, the first alarm it sends will be used as a snapshot.
Editing a Mask
1. After selecting the camera, click Edit on the Mask section. The add/edit mask window will open.
There are two sections in the add/edit mask window:
l
Select a snapshot from available alarms:this is a collection of previous alarms you can use a
snapshot to mask. This is useful if a different snapshot has better lighting for contrast to better
apply the mask.
l
Draw Mask:is where you will draw the actual mask and denote areas for Calipsa to ignore.
2. Under Select a snapshot from previous alarms, choose a snapshot.
3. Under Draw mask, click the Pencil icon.
4. After clicking the pencil, start clicking points to draw your mask. Each click will drop a single point
to shape the mask.
Note: A minimum of 3 points are needed. You can click and drag an existing point to shape the mask
more accurately.
C6749M | 02/23 27
Calipsa® Professional Reference Guide
5. To deselect the current mask you are working on, click the X icon. This allows you to draw multiple
masks.
6. The Arrow Symbol next to the X icon undoes any changes made since the last time the mask was
saved.
7. The trash can symbol next to the Arrow will delete any mask you have currently selected.
Tip: The Grid Symbol on the far right will open a grid on the snapshot to help with masking.
8. Once the masks are in place, clickSave. Calipsa will start filtering any alarms triggered by objects
within the masked areas.
C6749M | 02/23 28
Calipsa® Professional Reference Guide
Human and Vehicle Filtering
Calipsa can help determine if an event is triggered by a human or vehicle. This helps determine true
alarms. This is useful for areas where a large amount of vehicle traffic is expected but human intrusions
are rare.
This feature only applies to alarms received after the settings are edited. If Vehicle detection is OFF and
a True Alarm caused by a vehicle happens during this time we will not be able to reevaluate after the
capture. Shared Sites Do Not support this feature at this time. This setting can only be adjusted by Admin
and Members.
Note: Currently only Vehicles can be filtered. Human filtering may be included in a future release.
Enabling and Disabling Human and Vehicle Filtering
1. Sign into Calipsa.
2. Navigate to the site and camera.
Note: This feature is currently only available at the Camera level. There are plans to support site and
client-level settings in future releases.
3. Select the camera. Once the camera is selected, you will see options for Human and Vehicle
detection under the False Alarm Filter toggle.
4. To enable or disable vehicle filtering, toggle Vehicle Detection.
Note: Human Detection is currently always set to ON and cannot be edited.
C6749M | 02/23 29
Calipsa® Professional Reference Guide
Considerations for the Immix AI-link
If you are connected to Calipsa via the Immix AI-link then the above toggles will not be accessible in the
Calipsa platform. You can make these changes in your Immix server. By default, they will both be
enabled when adding cameras.
C6749M | 02/23 30