SIWENOID v2 — Map

This page describes the map function in SIWENOID v2. Maps provide a graphical representation of a physical location — floor plans, building layouts, or site diagrams — with live datapoint status icons overlaid on the image. Operators can use maps to monitor the status of sensors, zones, and other datapoints based on their physical position at a glance, instead of navigating through the datapoint hierarchy tree.

In SIWENOID v2, maps are fully interactive. Datapoint icons on the map reflect status changes in real time — they change colour and flash when a datapoint enters a non-normal state. Engineers can send commands to datapoints directly from the map view without switching to the datapoint hierarchy screen.

Maps are created and configured by engineers. Once configured, they are available to all operators with the appropriate viewing permissions.

Prev ← SIWENOID v2 Intrusion Detection System Next → Creating Tasks

To create a new map, click the + button at the top of any workspace panel on the main screen. From the popup menu, select Map, then select New map.

The map editor opens in the workspace panel with a blank canvas.

Before adding a map image, switch the panel to edit mode by clicking the Edit button (pencil or wrench icon) in the toolbar. Edit mode must be active to make any changes to the map configuration.

Once in edit mode:

• In the field marked 1, enter a name for the map. Choose a name that clearly identifies the physical area this map represents (for example: “Ground Floor”, “Server Room”, “Parking Level B1”). The map name is visible to all operators and appears on the workspace tab.
• The white canvas area marked 2 is where the background map image will be placed. The size of the canvas can be adjusted by dragging its edges to match the aspect ratio of the image you intend to use.
• To set the background image, drag an image file (JPEG or PNG) from your file system and drop it onto the white canvas area. Once the image appears on the canvas, the background has been set correctly.

After setting the map name and background image, click the Save button (floppy disk icon) next to the map name to save the map. The map is now available to open in any workspace panel.

The map screen contains the following areas and controls:

1 — Map Name
The name of the currently open map, as set during map creation. The name is displayed at the top of the map panel.

2 — Map Canvas
The main display area showing the background image with overlaid datapoint icons. The map can be zoomed using the mouse scroll wheel — the zoom centres on the current cursor position. The map can be panned by clicking and dragging. If the map has been panned or zoomed out of view, use the Reset button (4) to restore the default view.

3 — Mini-Map
A small overview panel showing the full extent of the map image with a highlight indicating the currently visible area. The mini-map is useful for large maps that cannot be displayed in full at the current zoom level. Clicking anywhere on the mini-map jumps the main canvas to that position.

4 — Reset Button
Resets the map view to its default state: zoom level 100%, the top-left corner of the map image aligned to position 0,0 on the canvas. Use this to restore the view after accidental panning or excessive zooming.

5 — Datapoint Icon (Non-Normal State)
Datapoints placed on the map are represented by type-specific icons. When a datapoint's status changes from normal to any other state (alarm, fault, excluded, tamper, etc.), the icon is highlighted with the colour of its event category. If the event has not yet been acknowledged by an operator, the icon flashes continuously. The example screenshot shows an intrusion zone in alarm state with a highlighted, flashing icon.

6 — Datapoint Icon (Normal State)
When a datapoint is in its normal state, the icon is displayed without any colour highlight. This allows operators to immediately focus on highlighted icons that represent active events.

7 — Map Settings
With appropriate permissions, the map name and assigned category can be edited here. Click Save after any changes.

8 — Map Management Toolbar
Contains the main map management options, including the edit mode toggle, save, and print controls.

9 — Map Name Field
The editable field for changing the map name. Changes must be saved using the Save button (11).

10 — Map Group
Maps can be organised into named groups for easier navigation in systems with many maps. The current map's group can be selected here.

11 — Save Button
Saves all changes to the map configuration, including name, group, datapoint positions, and layer settings.

12 — Print Button
Prints the current map view, including all visible datapoint icons and their current status.

13 — Edit Mode Checkbox
When checked, the map is in edit mode and all editing tools are active. When unchecked, the map is in view-only mode. Always disable edit mode after completing configuration to prevent accidental changes during normal operation.

14 — Map Editor Tools
The editor toolbar contains tools for placing and configuring datapoints, drawing shapes, adding text labels, and managing layers on the map.

15 — Layers
Datapoints on a map can be organised into named layers. Each layer can be shown or hidden independently. This is useful on complex maps with many datapoints — for example, placing fire detectors and intrusion zones on separate layers so operators can focus on one system at a time.

16 — Popup Map
A datapoint icon on the map can be configured to open a second map in a popup window when clicked. This is used to create drill-down navigation — for example, clicking on a building outline on a site overview map opens the detailed floor plan of that building.

17 — Text Tool
Allows the engineer to place text labels directly on the map canvas. Used to label rooms, areas, doors, or other elements not represented by datapoints.

18 — Image Tool
Allows additional images or icons to be placed on the map canvas as static decorative or informational elements, independent of any datapoint.

19 — Shape Tool
Allows the engineer to draw geometric shapes (circles, rectangles, polygons) on the map canvas. Shapes can be used to highlight areas, draw zone boundaries, or annotate the map layout.

Two navigation methods are available on any map:

• Zoom — scroll the mouse wheel to zoom in or out. The zoom centres on the current cursor position.
• Pan — click and drag the map canvas with the mouse to move the view in any direction.

If the map view has been panned or zoomed to the point where the map is no longer visible, click the Reset button (4) to immediately return to the default full map view.

Datapoints are placed on the map by dragging them from the Datapoint Hierarchy screen onto the map canvas. To do this, both the map and the datapoint hierarchy must be open simultaneously in separate workspace panels.

To place datapoints on the map:

Step 1 — Open the map in edit mode

Open the target map in a workspace panel. Click the + button at the top of a second panel, select the Map option, then select the same map from the list.

Switch the map to edit mode by clicking the wrench/screwdriver icon and selecting the Edit option.

Step 2 — Open the Datapoint Hierarchy in the other panel

In the other panel, open the Datapoint Hierarchy tab and navigate to the desired datapoint.

Step 3 — Drag the datapoint onto the map

Click and hold the datapoint in the hierarchy tree, then drag it across to the map canvas and drop it at the correct physical location on the map image. The datapoint icon will appear on the map at the position where it was dropped.

Step 4 — Resize or convert the datapoint zone (optional)

By default, a placed datapoint appears as a small dot icon. For zones that cover a physical area (for example, a PIR sensor covering a room), the icon can be expanded into an Active Zone shape that visually represents the covered area.

To convert a datapoint icon to an active zone:

1. Right-click the datapoint icon on the map.
2. Select Layout Style, then select Active Zone.

The datapoint will change to a polygon shape. Resize and reshape the polygon using the following controls:

• Drag the circle handle on any corner of the polygon to move that corner and modify the shape.
• Hold Ctrl and click on any edge of the polygon to add a new vertex at that point, creating a more complex shape.
• Hold Ctrl and click on an existing vertex to remove it, simplifying the shape.

Step 5 — Save the map

Click the Save button, then disable edit mode.

A single datapoint can be placed on any number of maps simultaneously. There is no restriction on how many maps a datapoint icon can appear on, and placing a datapoint on additional maps does not affect its existing positions on other maps.

This is useful in many real-world situations:

• A smoke detector near a staircase sits on the boundary between two floor plans — it can appear on both the ground floor map and the first floor map, so any operator monitoring either map can see its status.
• A main entrance door contact is relevant on both the building overview map and the detailed ground floor plan — it can be placed on both.
• A shared plant room serves multiple tenants — the same HVAC fault output datapoint can appear on each tenant's own map as well as the engineer's system overview map.

To place a datapoint on an additional map, simply open that map in edit mode and drag the same datapoint from the Datapoint Hierarchy onto the canvas, following the same steps described above.

Important: Every instance of the same datapoint across all maps reflects the same live status. When the datapoint enters an alarm or fault state, the icon is highlighted and flashes on every map it appears on simultaneously. A command sent from any map is always transmitted to the same physical device — the command is not map-specific.

—

Prev ← SIWENOID v2 Intrusion Detection System Next → Creating Tasks