13. Network Annotations

Annotations in the form of shapes, images or text can be added to the network canvas.

The network canvas is made up of three transparent layers:

  • Foreground Layer
  • Network Layer
  • Background Layer

The middle Network Layer contains nodes, edges and charts. The Foreground and Background layers contain annotations.

_images/layers.png

13.1. Types of Annotations

There are five types of annotations available:

  1. Images (loaded from image files)

  2. Shapes (rectangles, triangles, etc…)

    _images/type_shape.png

  3. Text

    _images/type_text.png

  4. Bounded Text (combines text with a surrounding shape)

    _images/type_bounded_text.png

  5. Arrows (connects other annotations or nodes)

    _images/type_arrow.png

13.2. The Annotation Panel

The Annotation panel shows the annotations that are currently present on the foreground and background layers. The panel allows you to create and delete annotations, select annotations, move annotations up and down, move annotations between layers, and group annotations.

_images/annotations_panel.png

13.3. Creating Annotations

At the top of the Annotation panel there are five buttons for creating each type of annotation. Start by clicking the button for the type of annotation you would like to add.

_images/annotations_panel_buttons.png

Alternatively, right click on the network canvas and select the annotation type under the Add menu.

_images/add_menu.png

Shape, Bounded Text, Image, Text

  1. Click the button for shape, bounded text or image annotation. For image annotations, a file chooser will appear where you can select an image file.
  2. Click the general location on the network canvas where the annotation should be placed. The annotation will appear on the canvas.
  3. The annotation properties can be edited in the Appearance tab in the Annotations panel. The properties can be edited again after the annotation is created by selecting the annotation.
  4. To resize the annotation, click on one of the resize handles and move the mouse cursor to resize the annotation. The annotation can be resized again later.
  5. Click the mouse again to stop resizing.

Arrow

Creating an arrow annotation requires there to be at least one other annotation on the network canvas.

  1. Click the button for arrow annotation.
  2. Click on an existing annotation on the canvas; this will be the source annotation.
  3. Click on another annotation on the canvas or a node; this will be the destination.
  4. An arrow annotation appears connecting the source and destination.
  5. The arrow properties can be edited in the Appearance tab in the Annotations panel to select start and end arrow head, color etc.

13.4. Selecting Annotations

One or more annotations can be selected in the Annotations panel by clicking on them.

To be able to select annotations in the network canvas Toggle Annotation Selection must be enabled. Toggle the _images/button_annotation_selection.png button at the bottom of the network view to enable/disable annotation selection mode.

_images/annotation_selection_mode.png

When an annotation is selected, 8 resize handles are visible. The annotation can be moved by clicking on it with the mouse and dragging. The annotation can be resized by clicking and dragging one of the handles.

_images/selected.png

It is possible to select multiple annotations at the same time. Hold Ctrl on Windows, or Command on Mac, while clicking on each of the annotations you would like to select. This works both in the Annotations panel and on the network canvas. When multiple annotations are selected they can be moved and resized at the same time.

13.5. Moving Annotations Backwards and Forwards

_images/annotations_panel_selected.png

The Annotation panel displays a list of annotations on the foreground layer and a list of annotations on the background layer.

Annotations that are towards the top of a list are drawn above annotations lower in the list. To move an annotation within a layer select it and click the _images/button_up.png button to move it forward or the _images/button_down.png button to move it backward. To move an annotation between layers select it and click the _images/button_up_2.png to move it to the foreground layer or the _images/button_down_2.png button to move it to the background layer.

13.6. Renaming Annotations

Each annotation has a name that is displayed in the Annotation Panel. These names are primarily for organizational purposes and do not affect how the annotation is displayed on the canvas. To rename an annotation double-click the annotation in the Annotation panel and enter the new name.

13.7. Editing Annotations

To modify the properties of an annotation (eg, color, text) select the annotation in the Annotation panel or in the network, then click the Appearance tab. Alternatively, right-click on the annotation in the network and select Modify Annotation….

_images/modify_annotation.png

The annotation can now be resized in the network view window. Other aspects of the annotation, like color, font, shape, opacity and rotation, can be edited in the Appearance tab.

The below example describes annotations with edited rotation and opacity.

_images/rotation_opacity.png

13.8. Deleting Annotations

To delete annotations, select one or more annotations in the Annotation panel and click the _images/button_trash.png button, or select the annotation in the network and click delete on the keyboard or right-click an annotation and select Edit → Cut..

13.9. Grouping Annotations

Two or more annotations can be combined into a group. When grouped the annotations move and resize as if they were a single annotation. Groups may be nested (a group may contain other groups).

_images/legend.png

To create a group select two or more annotations and click the _images/button_group.png button. The group will be given a default name that can be changed after the group is created. To un-group annotations select the group and click the _images/button_ungroup.png button.

A group may contain annotations from the foreground and background canvases. The group will show up in both the foreground and background layers in the annotations panel.

_images/group_layers.png

Note: Deleting a group will delete all the annotations contained within the group.