Difficulty: expert

Using Spacewell PointGrab™ hardware, the configuration of the devices is typically done in the Spacewell PointGrab™ Platform.
However, perhaps a PointGrab™ Platform is already present (or will be set up if sensors are procured from PointGrab™ directly). Of course, we can also work with that. In this case:

a) Provide access to PointGrab™ Sensing Platform to the Spacewell Implementation Consultant
b) Share API information from the PointGrab™ Sensing Platform with the Workplace development team in order to set up an integration between the Spacewell-external PointGrab™ Platform and the relevant Workplace tenant. Create an Application user in the external PointGrab™ Platform, which will give you a Client ID and Client Secret, and relay the information to the Workplace development team, so they can set up the data stream between the PointGrab™ Platform and the Workplace IoT Platform.

Overview

This document describes the PointGrab™ Sensing Platform, which includes the following components:

• PointGrab™ sensors: physical sensor devices that are installed at customer sites. The sensors detect human presence, produce people counts and send analytics data to the PointGrab™ Management System (PointGrab™)

• PointGrab™ Management System (PointGrab™): a cloud software service that manages the PointGrab™ sensors, receives their analytics data, and makes it available to partner applications via API.

• PointGrab™ Platform: a web interface for viewing and configuring the components of the PointGrab™ Sensing Platform.

Using the PointGrab™ Platform, you can define entities such as sites, buildings, floors and sensor devices, create system users, configure the sensor devices to detect people in your areas, and monitor your PointGrab™ system’s operation.

Terms and Definitions

The following table describes some basic terms and concepts that you’ll encounter when working with the PointGrab™ Sensing Platform.

Log in to the PointGrab™ Platform

To login to the PointGrab™ Sensing Platform, you will need a username and password. To get access to the Spacewell PointGrab™ Platform, contact the Spacewell hardware manager. You will have to follow a course or online training prior to receiving your log-in.

To login to the PointGrab™ Platform :

1. Browse to http://platform.pointgrab.com

2. Enter your user name and password

3. Click Sign in

Views and Workflows

You can use the PointGrab™ Platform to set up a new PointGrab™ system, to perform maintenance operations and to monitor the system’s performance in real time.

Different types of actions can be performed in the various PointGrab™ Platform views (see the list below).

To display one of the views, click on the view tab on the left of the screen. The selected tab will be highlighted in Black.

By default, when you log in to the platform, you will automatically be directed to the Analytics platform.

These are the actions you can perform in the different views:

• Floors: Place device entities (that represent physically installed sensor devices) on your floor plans, define the areas in which person detection and count will occur, and view real data floor data with a Live view.

• Management: Through 3 different tabs (Device Manager, Asset Manager & User manager), you will have the ability to monitor device statuses, link physical devices with their logical entities, and perform other maintenance activities (see Device Manager to learn more). In addition, create, edit and delete Site, Building and Floor assets (see Asset Manager to learn more). And finally, you will have the ability to create, edit and delete PointGrab™ Platform users (see User Manager to learn more).

• Analytics: PointGrab™ Analytics platform allows you to monitor, analyze and measure sites, buildings, floors, rooms, desks, traffic lines and more. The platform combines real data analysis as well as historical data overview to allow better understanding of the workspace environment, utilization and heatmaps. This view is available since the relaunch of the PointGrab™ Platform in June 2022 and was announced to be for free for a limited time only.

Floors

Using Display Controls in Floor Editor and Live Data Views

The Floor Editor and Live Data views have some common components for viewing floor plans and the related sensors, their configuration details and their telemetry data. This section describes these components.

Select a Floor to View or Edit

The Asset Picker at the top left of the screen displays all assets you can access with your log-in user.

Click on the desired floor asset you wish to view on the live map.

The image of the selected floor will be displayed in the live map section as view only.

Live Data - Device and Area Picker

The left pane displays the lists of devices and areas related to the selected floor. Devices and Areas are displayed with their names and link status values.

You can use the list search bar to search for a sensor or area, depending on the selected tab.

Select Display Layers

The Layer Selection pane at the top of the page, allows you to show or hide different layers related to the deployed PointGrab™ sensors. Selected layers are displayed and unselected layers are hidden

Layer	Description	Display
Location	This layer is only available in the Live Data view. It displays human icons where people are detected in real-time
Devices	Configured PointGrab™ sensor devices. Sensors are displayed as Sensor Icons, presented according to rotation. Sensor colors indicate the following states: Gray – unlinked Green – linked and connected Red – linked but disconnected Linked = configured to refer to a physical sensor device Connected = communicating with the PointGrab™ server
Detection Areas	Rectangular areas which a sensor is covering and in which it can detect human presence. Their size depends on the sensor’s height, and their location and direction depend on their placement and rotation. Displayed as dashed gray rectangles.
Count Areas/Traffic Lines	The areas that the system’s administrators or commissioners defined for the sensors. These must be fully covered by one or more of the sensors’ detections areas, and are defined as areas in which human presence should be reported. Areas have one of these types: Desk: the area contains a single desk. Meeting Room: the area is a public space, often occupied by multiple, seated people. Reception: the area covers a reception desk or other public area where people are usually standing, sometimes in a queue. Traffic Line: an area that covers an entry/exit point to a specific location.	Areas are displayed in the following colors: Blue: unoccupied valid area (fully covered by sensor detection areas) in the Floor Editor view Red: an invalid area (not fully covered by sensor detection areas or an area that is under a disconnected sensor) Green: occupied area in the Live Data view Traffic line / VLC are displayed in the following colors: Grey line with green and red arrows – a valid Traffic line (fully covered by sensor detection areas) in the Floor Editor view, green indicates “In” direction Red: an invalid Traffic line/VLC (Not covered by sensor detection areas
Grid	Selecting the grid layer displays a light-gray grid over the entire floor image. Each square in the grid represents an area of 1m x 1m. The grid helps you to place sensors and define areas.

Move and Zoom in/out of the Floor Image

• To zoom in or zoom out on the floor image:

  • You can use your mouse scroll, forward to zoom in or backward to zoom-out or

  • use the scale control on the floor area bottom right, click the [+] or [–] buttons to zoom in or out respectively

• To control the portion of the image visible in the main window: Click on the floor image and drag it to the desired direction.

Cursor Location Display

On the top-right of the floor plan, the cursor location is displayed dynamically.

As you move the cursor across the floor plan, the (X, Y) coordinates change to reflect the corresponding location in the real world.

The (X, Y) values are the distances along the X and Y axes of the location from the origin point (the topleft corner of the room).

Use the Floor Editor to Configure Devices and Areas

Two of the main activities that you’ll perform when setting up a new PointGrab™ format (or making changes to an existing one) is to configure sensor device locations and areas. These two actions determine the areas in which presence detection and people counting can occur.

If you have Admin or Commissioner permissions, you can add, edit and delete devices and areas in the Floor Editor view.

To view the devices and areas of a specific floor:

1. Click the Floor Editor tab on the top right of the page.

2. In the Asset pane at the top-left, click the floor where you want to add the device. The floor’s plan is displayed in the main window.

3. In the Layer Selection pane, check the Devices, Count Areas and Traffic Lines checkboxes. The device and area indicators are displayed on the floor plan, and they can now be edited and new ones added.

Deploy Sensor Devices

Before you decide on device locations, first determine the areas in your floor plan in which you want to count people. The number and placements of the sensors that you deploy should ensure that your areas are completely contained within the sensors’ detection areas. (see Prepare your sensor plan )

To deploy a sensor device, you will need to:

1. Physically install the device in the ceiling of the relevant space, in the correct direction for the required detection area. (see PointGrab installation)

2. Using the PointGrab™ Sensing Platform, define a logical device that corresponds to the physical device. This includes entering details about the physical location of the device.

3. Link the physical device to its logical representation (see Linking a Device to learn more).

Configuring Devices

Before adding a device entity, make sure that you know:

• The X and Y distances in meters (feet) of the device from the origin corner (top-left corner of the floor plan). See the image below for an illustration of how (X, Y) coordinates are determined using the floor plan and grid lines. Note that when you hover the cursor over a location in the Floor Editor view, the corresponding location in (X, Y) coordinates is displayed in the cursor location control on the top-right.

• The installed device’s height above the floor

• The device’s view direction (see below)

An installed device has a view direction, which is determined by the rotation of the device in relation to the room. There is a view direction marker on the back of the sensor and on the inside of the adapters (see image below). The view direction is the angle between the floor plan’s Y-axis and the device’s axis, as indicated by the view direction marker. In the Floor Editor and Live Data views, a sensor’s view direction is indicated by the small arrow in the sensor icon.

To add a device:

1. On the top right hand side of the page, click Edit Floor.

2. Click the Add Device button. The Add New Device dialog is displayed.

3. In the Device Name field, enter an informative name for the device.

4. In the X field, enter the X coordinate of the device in meters, relative to the origin.

5. In the Y field, enter the Y coordinate of the device in meters, relative to the origin.

6. In the Device Height field, enter the height of the device from the floor. NOTE: The device height must be between 2.15m and 4.5m (7ft and 14.8ft).

7. In the Rotation field, enter the device’s view direction in degrees (counter-clockwise from the floor’s Y-axis).

8. Click Save. The device is added and displayed both in the Search pane and as an icon in the floor plan.

Verify commissioning with Commissioning Assistant: verify sensor height, orientation, and tilt., see below

To edit device details:

1. Select a device either by clicking on the icon in the floor plan or the name in the search pane.

2. Open the Device Properties pane.

3. Update the data of the device.

4. Click Save to confirm your changes.

To delete a device:

1. Select a device either by clicking on the icon in the floor plan or the name in the search pane.

2. Open the Device Properties pane.

3. Select Delete.

4. Click Save to confirm your changes

Verify Sensor Placement with Commissioning Assistant

The Commissioning Assistant is a helpful tool that will allow you to verify if a sensor in your ceiling is positioned in full accordance with the PointGrab Platform. It will allow you to verify the sensor's orientation, rotation, height, tilt, and level. The commissioning assistant will compare the sensor’s placement within the PointGrab Platform to its actual placement in real life.
It also allows you to physically place several targets to determine if a certain area is contained within the detection area of the inquired sensor.

What will the commissioning help look like? It will create a high level top view of what the sensor sees

• Red (outer) frame: all that is visible here, is outside the Detection Area of the sensor

• Black (inner) frame: all that is visible here, is covered by the Detection Area of the sensor

• Red square in the middle of the frame represents the Count Area of this sensor

 Sensor not positioned correctly?

If the sensor isn’t positioned correctly on site, the commissioning assistant will provide feedback on how to adjust the sensor or adjust the device properties within the platform

You can then make the required changes and test the sensor placement again.

 Sensor is positioned correctly

If the sensor is placed correctly, the commissioning assistant will notify you as such.

You can always click on Show Details to view more information.

You can also establish what is included in the sensor’s detection area. Place a few targets around the acquired area.
Ensure that the main target is positioned in the correct position for the function to work. When you Click Verify, you will be able to see on the Platform which targets were detected in the sensor’s detection area.
This will allow you to verify what is being captured by the sensor’s detection coverage.

Areas

A device’s detection area is a rectangular area underneath the sensor, in which the device can count people. The size and location of this area are determined by the sensor’s (X, Y) coordinates, view direction and height. Check out Prepare your sensor plan for best practices on how to determine the Detection Area.

When you select the Detection Areas layer in the Floor Editor view, the devices’ detection areas are displayed on the floor plan image with dashed boarders.

Within detection areas, you can define the areas in which you want to count people. These areas must be entirely covered by the detection areas. Note that a detection area can contain several count areas, and an area might be covered by more than one detection area. Note that if you define an area that isn’t completely covered by detection areas, that area is considered invalid, and it’s displayed as a red-outlined rectangle.

The types of areas you can add are:

 Desk: an area that covers a single desk

You define a desk area when you want to detect a single person’s presence at a desk. A walled office usually doesn’t contain more than a few well-spaced desks, allowing you to define larger and better-spaced areas for each desk. When defining an area for a desk in an office: Center the area around the person’s expected location. Define an area whose dimensions are between [1.8m x 1.8m] and [2m x 2m]. The minimal area size is [1m x 1m]. If possible, maintain a distance of at least 20cm between edges of adjacent areas.

 Adjacent Workstation Areas: an area that covers multiple desks; for example an office landscape

Sometimes the desks for which you want to perform people counting are adjacent to each other, as in a row of workstations in an office landscape (see the example on the right). In this case, you may have to define areas whose width is smaller than the recommended minimum of 1.8m. The width you can define is dictated by the physical width of the workstations. When defining an area for a desk which is at one of several adjacent workstations: Center the area around the person’s expected location. Define a rectangular area whose dimensions are as close as possible to the recommended [1.8m x 1.8m]. For the desks at the ends of the adjacent rows, define an area width of 1.8m.

(Even if the Detection Area might be large enough to cover more than 10 work places, PointGrab™ Platform has a limit to max 10 areas per device: if you create more than 10 areas for 1 sensor in PointGrab™ Platform, the device will appear offline.)

 Meeting Room: an area that covers a meeting room or other public area where people are usually sitting in collaboration

Meeting room areas are different from desk areas in that they’re larger, and they often contain multiple people instead of just one person. Assuming a meeting room is rectangular, the simplest way to define its area is to define the area edges so that they coincide with the room’s walls.

 Areas Covered by Multiple Sensors (sensors stitched together to allow for 1 count area)

For a typical meeting room, usually one sensor is sufficient to cover the entire area. However, in some cases you may need to combine (“stitch”) two or more sensors’ detection areas to cover the required meeting room area. In addition, in some cases of open-space floor plans, you may need several overlapping detection areas to cover the required space. When defining an area that is covered by more than one sensor’s detection area, place the sensors such that adjacent detection areas have an overlap of at least 0.5m. In the example on the right, the meeting room has two sensors, with two overlapping detection areas (gray dashed rectangles). The area defined for people counting (the blue rectangle) overlaps with both of the detection areas.

 Traffic Line / Footfall Area: an area that covers an entry/exit point to a specific location

Traffic Line areas are intended to track traffic going in and coming out of a specific location (as opposed to all other area types, which monitor the current person count in the area). Traffic Line areas produce information such as “In the last update period, 5 people entered Floor X, and 9 people exited Floor X”. A Traffic Line area covers an entry/exit point to a specific location, such as a room or floor. For example, a Traffic Line area might be defined as a narrow strip adjacent to a doorway, as in the image on the right. Every time the sensor sends telemetry metrics (according to the Update Frequency configured for the area), it reports the number of people who entered or exited the area since the previous update. Traffic Line areas have a mandatory length of 0.5m, and their width must be at least 0.9m. Traffic Line areas must be contained within a single sensor’s detection area.

Traffic Line areas are displayed in the Floor Editor and Live Data views similarly to other types of areas. The only differences are that they have a direction indicator arrow, and that they show 2 metrics: ingoing traffic and outgoing traffic. The directions of the traffic that the Traffic Line tracks are determined by its rotation. Incoming traffic is defined as traffic going in the direction of the Traffic Line’s rotation arrow. Outgoing traffic is defined as traffic going in the opposite direction of the Traffic Line’s rotation arrow.

Traffic Line Areas

Desk, Meeting Room and Reception areas are intended for real-time people counting. They produce information such as “Desk A is now occupied” or “Meeting Room B now contains 7 people”.

On the other hand, Traffic Line areas are intended to track traffic going in and coming out of a specific location. They produce information such as “In the last update period, 5 people crossed the Traffic Line area”.

A Traffic Line area covers an entry/exit point to a specific location, such as a room or floor. For example, a Traffic Line area might be defined as a narrow strip adjacent to a doorway, as in the image below. Every time the sensor sends telemetry metrics (according to the Update Frequency configured for the area), it reports the number of people who entered or exited the area since the previous update.

Pointgrab claims a 95% accuracy for traffic sensing. Spacewell never quantified the accuracy of traffic as the perceived accuracy for a customer is a function over time for traffic data. From our point of view, setting up Traffic lines/ footfall numbers only deliver indicative numbers on how many people pass within a day.

The accuracy is influenced by the following 2 aspects:

1. The propagation of faults: at every moment in time the traffic line is 95% accurate. Each time the sensors misses a count, this person will get lost. This means that all the faults accumulate over time, leading to a larger fault. To combat this we’ve implemented a feature that resets the count at midnight. This way the fault gets reset once a day and we don’t end up with ghosts from previous days in our data.

2. The placement and direction bias of the traffic line: When placing the traffic line directly beneath a door opening, you’ll notice that there is a directional bias in the accuracy of the data. This is the result of how the sensor detects a in or out. The sensor will trace a person moving in its detection area, and will count the person as it crosses the line. When the traffic line is placed directly above a door opening the sensor will have one side where it can easily trace people and see them cross the line, and one side where people appear “out of nowhere”. The people appearing out of nowhere are more difficult to trace and therefore more prone to error.
   Fine tuning the placement (moving the traffic line more inwards) can help increase this accuracy, however it is always a trade off for people walking by and triggering false positives.

Traffic Line areas are displayed in the Floor Editor and Live Data views similarly to other types of areas. The only differences are that they have a direction indicator arrow, and that they show 2 metrics: in-going traffic and out-going traffic.

The directions of the traffic that the Traffic Line tracks are determined by its rotation:

• Incoming traffic is defined as traffic going in the direction of the Traffic Line’s arrows (Green for In, Red for Out).

• Outgoing traffic is defined as traffic going in the opposite direction of the Traffic Line’s rotation arrow.

Configure an Area

In general, when defining an area for people counting, you’ll want to make sure that the area:

• Is completely covered by the detection areas of one or more sensors

• Covers the entire space where people might stand or sit in the area

• Doesn’t overlap with other areas, and preferably has a minimal distance of 20cm from other areas

• Takes into account any special visibility conditions such as glass walls, doorways, occluding objects and reflective surfaces

When working in the Floor Editor view, activate the Grid layer to display the gray grid lines. Each square in the grid represents a [1m x 1m] area on the physical floor.

To add an area:

 Step 1. Go to "Edit Floors" to see the "Add Area button" appear

In the right hand corner, click Edit Floors. The Add Area button becomes enabled

 Step 2. Click the Add Area button. The Add Area dialog is displayed.

 Step 5. For optimal performance, in the Type field, select the type of the area you want to add.

The Type value is not only for descriptive purposes; the PointGrab™ software adjusts its behavior according to the area type.

 Step 6. Enter the X-Y coordinates

In the Center X field, enter the X coordinate in meters (feet) of the area’s center.

In the Center Y field, enter the Y coordinate in meters (feet) of the area’s center.

 Step 8. Optional: Select devices whose detection areas you want to cover the new area

Optionally, click in the Select Devices field, then select the check boxes of the devices whose detection areas you want to cover the new area.

This can be useful, for example, if you have some knowledge about occlusions in the sensors’ views, and you want to choose the optimal sensor/s for covering your new area. (see below topic “Handling visibility Conditions” for more information)

Alternatively it can be used to indicate which sensors should be stitched together, as in the example below, where on the floor plan, 3 devices' detection area come in to the meeting room, but logically only 2 sensors will gather information on utilization of that room.

To edit area details:

1. In the right hand corner, click Edit Floors.

2. On the left hand side of the page, choose the area in which you wish to edit.

3. In the Properties pane, edit the property values as required.

4. Click Apply, then Save.

To delete an area:

1. In the right hand corner, click Edit Floors.

2. On the left hand side of the page, choose the area in which you wish to delete.

3. Click the Delete Area button.

4. In the confirmation dialog, click Yes, then Save.

Good to know: Handling visibility Conditions, Device/Area import/export & Properties pane

Handling visibility Conditions

 Walls & Doorways

When a wall is opaque, you can define an area edge to coincide with the wall, or even to go slightly beyond the wall, on the outside of the room in which you’re defining the area. This is because the sensor can’t “see” beyond the wall, so it won’t identify people on the other side of it. However, if the wall is transparent, for instance if it’s made of glass, or if there’s a door or entryway in the wall, the sensor may be able to detect people outside of the room. In this case, it’s recommended to maintain a distance between the area edge and the transparent wall or doorway.

For example, let’s assume that in the above image the top, bottom and left-hand walls are transparent. Note that the area edges corresponding to these walls are about midway between the lines of chairs and the walls. This margin prevents people from being detected outside the room.

Import and Export Commissioning Data from a File

If you need to configure large numbers of devices and areas, it can be inconvenient to do this one-by one. In this case, you may prefer to import this information from a file.

Exporting Commissioning Data from a File

If you would like to save existing site commissioning details, it can be achieved by exporting site details into a CSV file. To export commissioning data from an existing floor:

1. Go to the Floor Editor page.

2. In the Asset, click on the floor whose devices/areas you want to configure. Click the “Export” button. The Export dialog is displayed.

3. Click the Yes button and save the commissioning file to a desired location on your device. The exported file can be used afterwards to recreate the floor using the Import function

Importing Commissioning Data from a File

You can import the following information from a CSV file:

• Devices to add

• Areas to add

• Physical and logical devices to link

Here is an example of a CSV file with commissioning data. See Configure Devices and Areas to learn more about the fields that must be added for devices and areas, and see Link a Device to learn more about the fields needed to link physical and logical devices.

To import commissioning data from a file:

1. Navigate to the Floor Editor page.

2. Click the “Import” button. The Commissioning from file dialog is displayed.

3. Click the Choose File button and browse to a CSV file containing valid PointGrab™ commissioning information.

4. Click Upload. A progress graphic is displayed while the information is imported.

5. If the import operation was successful, you will see a message stating so. However, if one or more import elements failed, an error message will appear. In both cases, you can click Download report to download a CSV file showing the import status for each line item, including indications of invalid field values.

Display and Hide the Properties Pane

To display the properties of a device or area:

1. In the Search pane, select Device or Area, depending on the element whose properties you want to display.

2. Click on the name of the device or area. The properties of that element are displayed in the Properties pane on the right.

To display the Properties pane: Click the button on the right of the page.

To hide the Properties pane: Click the button to the left of the pane.

Management

Device Manager

You can use the Device Manager view to control and update sensor devices.

Displaying and Searching for Devices in Device Manager

In the Device Manager view, you can display and search for devices according to their locations and names. Just like in Excel, you can filter and sort in the header of the overview. Alternatively, in the Search box, type a substring of the name, sensor, serial number or any other related information for which you want to search.

Restart a Device

You may want to restart a device. A device restart takes about a minute. To restart a device:

1. Use the search and paging options to find the device.

2. Check the checkbox to the left of the device you want to restart.

3. Click “Restart Devices”.

4. Click “Yes” in the pop-up to confirm the restart. The device has been restarted.

(Un)Link a Device

When you set up the system, or any time you want to install a new physical device, you’ll need to link the physical device to its corresponding logical device defined in the PointGrab™ Platform.

To link a device:

1. Use the search and paging options to find the device.

2. Click the “Link Device” symbol/buttonon the right hand side. The Link dialog is displayed.

3. In the Serial Number field, enter the serial number that is provided on the sticket on the PointGrab sensor. Serial numbers should be inserted using the following format: xxxxxxx-xxxx-xxxxxx-xxxx. Almost all sensors linked to Spacewell start with identifyer 4000023-1401-xxxxxx-xxxx.

4. Click Link and verify that the sensor’s Link Status icon in the table changes to the “linked” symbol.

You may want to unlink a device to correct a linking error, or when switching out a faulty device.

To unlink a device:

1. Use the search and paging options to find the device.

2. Click the “Unlink Device” symbol/button on the right. The Unlink dialog is displayed.

3. Click yes. The device is unlinked and its Link Status icon changes to the “unlinked” symbol.

Asset Manager

In the Asset Manager view, you can add, edit and delete assets.

The assets you can manage depend on your customer type. There are two types of customers: distributors, who manage other customers, and end customers, who don’t have the permissions to create Customer assets.

The PointGrab™ asset types are:

• Customer: the customer at whose site/s the PointGrab™ system is deployed; usually a company.

• Site: a customer site. This is a geographical location containing one or more of the customer’s buildings.

• Building: the geographical location and street address of a customer’s building.

• Floor: a floor of a customer’s building.

When setting up a new site, usually you’ll create the asset entities in the order in which they appear above. This is their hierarchical order, where each entity type may contain one or more of the following entity types. For example, a customer may have several sites, and a site may have several buildings.

To display the Asset Manager view, click the Asset Manager tab at the top of the screen. The assets are displayed as a hierarchical tree. When you select an asset, its arrow is highlighted in light blue, as can be seen in below screenshot

To display or hide the child assets of an asset (for example, building assets under a site asset): Click the arrow to the left of the asset.

Add a Customer

Customer assets represent PointGrab™ customers. As mentioned previously, only distributors can create Customer assets. When performing an initial setup, the first thing you will do is to create a Customer asset, in the Asset Manager view.

To add a Customer asset:

1. In the Asset Manager view, click on Add Customer.

2. The Customer Details dialog is displayed.

3. Enter the customer details.

   1. In the Parent field, “Spacewell Distributor” will be selected

   2. In the Type field, “End customer” will be selected

   3. In the Name field, enter the name of the customer’s company/organization. For the Pointgrab “customer” to be visible from within the relevant Workplace tenant, add the short tenant name between underscores. (max 32 characters in this field)

   4. The street address details should refer to the customer’s main office.

4. Click Save.

Add a Site

Site assets represent physical customer sites. A site is typically a single geographical location that contains one or more customer buildings. Each customer may have one or more sites.

To add a Site asset:

1. In the Asset Manager view, click Add Site.

2. The Site Details dialog is displayed.

3. For end users, all assets are created under their own customer asset and Customer field will not be available

4. Enter the site details. In the Name field, enter an informative name for the site

5. Click Save.

Add a Building

Building assets represent buildings in which the customer has offices. Before creating a Building asset, you must create the Site asset that the building belongs to.

To add a Building asset:

1. In the Asset Manager view, click Add Building.

2. The Building Details dialog is displayed.

3. Enter the building details. In the Name field, enter an informative name for the building. The time zone and working hours inputs can help improve your Analytics reports and will provide you with more accurate data.

4. Click Save.

Add a Floor

Floor assets represent floors in customer buildings, in which the PointGrab™ platform must operate. Before creating a Floor asset, you must create the Building asset that the floor belongs to.

When you create a Floor asset, you can upload a floor plan image that represents the floor. This image is then used in the Floor Editor view to help you plan sensor placement and areas, and in the Live Data view to display presence detection and count in real time. The top-left corner of the floor plan image is considered the origin point (0, 0). Sensor locations are then configured as (x, y) distances in meters from the origin point.

To add a Floor asset:

1. In the Asset Manager view, click Add Floor.

2. The Floor Details dialog is displayed.

3. Enter the floor details (see NOTES below), then click Save.

In the Reference points fields, you can optionally enter the locations and geo-locations of three points on the floor. This enables the PointGrab™ system to accurately derive the geo-locations of sensor devices. This information is sometimes needed by integrated 3rd-party applications.

Useful tip for the dimensions

Once you have the floorplan in PNG format (make sure that the PNG does not have any white spaces around the floorplan) and the dimensions of the plan:

Steps to get the right dimensions (use below excel Pointgrab Platform_Floorplan_Dimensions template for your convenience)

1. Take the largest dimensions of the plan and the pixels of the uploaded picture

   1. In the example 56.7 and 3230 px

2. Divide the dimension of the plan with the pixel dimension

   1. 56.7/3230

3. Multiply the result with the other pixel dimension

   1. (56.7/3230) * 1576

4. Result is the dimension you need to enter in pointgrab: largest dimension of the plan * the calculated dimension

   1. Switch width/height in PointGrab™ Platform if the first time doesn’t work

Editing and Deleting Assets

To edit an asset:

1. In the Asset Manager view, select the asset, then click Edit. The asset’s Details dialog is displayed.

2. Edit the details as required, then click Save.

To delete an asset: In the Asset Manager view, select the asset and press Edit. Then, click Delete. The Authorization dialog is displayed

User Manager

If your PointGrab™ Platform user has Admin permissions (role), in the User Manager view you can add, edit and delete PointGrab™ Platform users, even though we ask you to leave this task to the Spacewell Hardware Team.

User Types, Roles and Permissions

PointGrab™ Platform user entities have one of the following types:

• User: a person who uses the Management Platform UI.

• App: an application that calls the PointGrab™ API.

When you create a new user entity, you define it as belonging to one of these types. In addition, a user has a role. The following table describes the different roles that PointGrab™ Platform users can have:

When you define a new user, you can select the assets that the user is allowed to edit (see Add a User).

Displaying and Searching for Users

To display all users, click the User Manager tab. All users will be displayed.

To filter the displayed users: To filter users by Name, User Type or Role, in the edit box, type the string (or part of the string) you want to match, then click Search. Only users with the given substring in their Name, User Type or Role are displayed.

To sort the user list by a field value:, click the column header of the field by which you want to sort. The users are sorted in ascending order of the field value. Click the header again to sort in descending order

Analytics

PointGrab Analytics tab let’s you take advantage of the data and insights available within the various charts and graphs displayed.

Monitor Live Data

After deploying a new CogniPoint™ system, we recommend entering the Live Data view to verify that people counting is working correctly. You can also use this view at any time to monitor presence detection.
The Live Data view allows you to view the people counting results in real-time. The Live Data panes and controls are almost identical to the ones in the Floor Editor view, except for the following differences:

• Device Properties and Areas Properties panes are only displayed in the Floor Editor view.

• In the Live Data view, person icons are displayed when human presence is detected, and the total count of people in each area is displayed in the center of the area.

• More differences: in the live view we can see the counting results and the status of the sensor

After sensor installation: Verify Sensor Layout

Review all sensor devices, compare them to their definitions in the PointGrab™ Platform and verify that they’re installed in their planned locations, with the correct view direction.

In the PointGrab™ Platform, go to the Device Manager view make sure that all sensors’ Connection Status is green.

In the PointGrab™ Platform, go to the Live Data view and for each sensor, make sure that:

• The sensor Status is Linked (the sensor is displayed in green).

• The sensor’s Last Reported time is within the last minute (assuming you set a 1-minute reporting interval).

• When people are present in the area the sensor is covering, person icons and counts are displayed in the Live Data view.

Search