Lampyre User Guide

Introduction

Purpose and Main Functions of the Application

This document is a user manual for the Lampyre application (hereinafter the Application), which is designed for analytical processing of data obtained by way of investigative activities conducted in landline, mobile, wireless and radio communication networks.
The main functions of the Application are as follows:
  • Importing investigation data.

  • Making arbitrary queries to data allowing data to be received based on any defined parameters.

  • Visualizing query results in tables.

  • Visualizing query results on schemas (graphs).

  • Visualizing query results on GIS-maps.

  • Use of other analysis tools.

  • Ability to manually add data to be analyzed, etc.


Main Components of the Application

Data are represented in the system following a certain structure called ontology. The main components of data are:

  • An object - which is a system element allowing data to be allocated to a category with certain properties (attributes), for example (for billing data), a subscriber phone number or his/her name.

  • A link - which is an established relation between objects, for example (for billing data) a call made from one number to another.

  • An object or a link type - which is their category.

  • An instance - which is a specific object type or link type that refers to a particular data set. An instance is created on the basis of an object type or a link type.

  • An attribute - which is a description of certain properties pertaining to an object or a link. Each object and link has its own attributes. Every object can have one or several attributes. The same thing goes for every link type.

All data and operations performed on them are contained in the investigation. Queries are made and analytical processing is performed within investigations.

The Application provides three main tools for visualization: a table, a schema, and a GIS map.

Both preset and user defined analytical methods are used for the analytical processing of data. A custom analytical request is a module written in Python that implements API. The module allows the user to create custom analytical requests, describe custom object types, and link types.





1 Working with the Application

1.1 Signing into the Application

To sign into the Application, you must do the following:

  • Double click the Application icon on the PC desktop (Figure 1) or click the Application icon in the Quick Access toolbar (Figure 2).

Figure 1

Figure 1. Application desktop icon

Figure 2

Figure 2. Application Quick Access toolbar icon

  • In the window that appears, select the Application operating mode (Figure 3).

Figure 3

Figure 3. Selecting the Application operating mode

Note: In the offline mode, you cannot connect to the server and work with external data types and methods.

The Getting started window of the Application appears (Figure 4).




1.2 Getting started

To get started with the Application, you need to create a new or select an existing investigation. To do this, right click the corresponding item in the getting started window (Figure 4).

Figure 4

Figure 4. Getting started with the Application

Note: When you select Import file, the investigation is created automatically.
Section 2 of this manual describes how to work with investigations. Upon launching an investigation, the main window of the Application is opened (Figure 7).

Within an investigation, you perform one or more of the following actions:

  • running requests

  • importing files

  • filling instances with data

Any of the above actions loads data to be analyzed in the investigation.

Section 3.3 of this manual describes how to work with requests.
Section 3.1 of this manual describes how to import files.
Section 2.5 of this manual describes how to work with instances.



1.3 Exiting the Application

To exit the Application you must do the following:

  • To save data, select File → Save in the main menu of the Application (Figure 5). The data are saved.

Figure 5

Figure 5. Saving data

  • In the upper portion of the Application window, click the close button (Figure 6). The Application is shut down.

Figure 6

Figure 6. The Close button of the Application




1.4 Interface Description

1.4.1 Main window

Upon signing in, the main window appears. Figure 7 shows the main window of the Application.

Figure 7

Figure 7. The main window of the Application

The main window of the Application contains the following items:

  • Main menu - located across the top of the window;

  • quick access buttons on the Quick Access toolbar - located under the Main menu;

  • the current balance is displayed in the upper right portion of the window.

  • working area - located in the center of the window.

The Main menu is used to navigate to various windows displayed in the working area.
The quick access buttons and the Main menu are always available in the Application, regardless of the window you are currently using.
Sections 1.4.2-1.4.4 describe the most important items of the Application's main window.


1.4.3 Quick Access toolbar

Quick Access toolbar provides efficient access to the Application controls.
Quick Access toolbar is always available in the Application, regardless of the window you are currently using.
Quick Access toolbar is shown in figure 9.
Figure 9

Figure 9. Quick Access toolbar

The buttons of the Quick Access toolbar are described in Table 2.

Table 2. The buttons of the Quick Access toolbar

Item

Purpose

table2_img1

Creating a new investigation

table2_img2

To open a file on the user's PC

table2_img3

Saves changes

table2_img4

Opens the Requests window

table2_img5

Opens the Import window

table2_img6

Opens the Instances window

table2_img7

Opens the Explorer window

table2_img8

Opens the Pictures window

table2_img9

Opens the Content window

table2_img10

Opens the Tools window

table2_img11

Opens the Properties window

table2_img12

Opens the Scripts window

table2_img13

Opens the Search results window

table2_img14

Opens the Search setup window

table2_img15

Opens the Timeline window

table2_img16

Opens the List of requests window

table2_img17

Opens the Schema navigation window



1.4.4 Working area

The working area of the Application displays various windows. The appearance of these windows, their functions and control items depend on their purpose.
The Application has the following window types:
  • Service windows are windows that provide for data handling. For example, Requests, Import, Instances, Explorer, etc. The main menu is used to access the service windows of the Application.

  • Documents are windows that display the results of data processing. For example, schemas and tables created to display the Application output.




1.5 Hotkeys of the Application

Certain actions in the Application can be performed using hotkeys. See Table 3 for the hotkeys used in the Application.

Table 3. The hotkeys used in the Application

Hotkey

Purpose

F5

To requests

F12

Show in investigation

Delete

To delete active elements

Ctrl + Y

Opens the List of requests window

Ctrl + N

To copy selected items on a new schema

Ctrl + O

To open a file on the user's PC

Ctrl + S

Save

Ctrl + W

For the entire schema or map overview

Ctrl + E

To select the ends of a link

Ctrl + +

To scale the map up

Ctrl + -

To scale the map down

Ctrl + 0

Normal map scale

Right/left/up/down arrows (including those of the additional keyboard)

To navigate GIS maps

Ctrl + 1

To set the circular layout

Ctrl + 2

To set the tree-like layout

Ctrl + 3

To set the concentric layout

Ctrl + 4

To set the power layout

Ctrl + 5

To set the orthogonal layout

Ctrl + 6

To set the multilevel power layout

Ctrl + 7

To set the hierarchical layout

Ctrl + 8

To set the power Lin-Log layout

Ctrl + G

To add the selected vertices to a group

Ctrl + Shift + S

Save to file as

Ctrl + Shift + +

To increase the size of a vertex caption. You select a vertex and press the hotkey.

Ctrl + Shift + -

To decrease the size of a vertex caption. You select a vertex and press the hotkey.

Ctrl + Shift + selected vertex + mouse wheel

To move linked vertices closer or further from the selected vertex

Selected item + Alt + mouse wheel

To rotate a schema clockwise or counterclockwise in relation to the selected item

Hold down the left mouse button + Alt

To move a graph to an arbitrary spot in the working area

Hold down the left mouse button + Space

To move selected elements of a schema to an arbitrary spot in the working area without clicking them





2 Working with investigations

An investigation is a set of operations performed to tackle a certain task. An investigation may be made of the following parts: a request, a GIS map, a report, etc. All received and processed data are contained within a single investigation.

2.1 Creating a new investigation

To analyze data, a new investigation should be created or a previously created investigation should be opened. To create a new investigation, follow these steps:

  1. In the main menu of the Application (Figure 10), select File → New investigation. The New investigation window (Figure 11) appears.

Figure 10

Figure 10. Creating a new investigation

Figure 11

Figure 11. New investigation window

  1. Set the path for saving the new investigation. In the File name field specify the name of the investigation;
    Click Save. A new investigation is created. The investigation file is saved in the selected folder. The name of the investigation is displayed in the upper portion of the application window in the following format: Name-Lampyre build version (Figure 12).
Figure 12

Figure 12. Displaying the investigation name




2.2 Saving a copy of an investigation under a new name

To continue working with an existing investigation, so that its previous results are remained unchanged, you can save a copy of this investigation under a new name. To save a copy of the investigation in a file under a new name, follow these steps:

  1. In the main menu, select File → Save to file as. The Save window opens (Figure 13).

  2. Specify the path for saving, modify the investigation name and click Save. A copy of the investigation is saved under a new name.

Figure 13

Figure 13. Window for saving investigations




2.3 Opening of a previously created investigation

To open a previously created investigation, you must do the following:

  1. In the Main menu, select FileOpenFile. A file choice window on the user's PC will open.

  2. Right click the name of the investigation file you want to open. The investigation is opened, all its data are loaded into the Application.




2.4 Closing an investigation

To close the investigation, select File → Close investigation in the Main menu. The investigation is closed.




2.5 Working with instances

2.5.1 Basic concept overview

Any work that involves specific system data is executed using instances. An instance is a specific object type or link type that refers to a particular data set. An instance is created on the basis of an object type or a link type. Each object and link has its own attributes. Every object can have one or several attributes. Same thing goes for every link type.

The object types and link types are divided up into two categories:

  • common types that are pre-installed in the Application

  • custom types that are created by the user

An object is an instance of a link type, a graph vertex, a graph link, a GIS map object, etc.
The same instance can be present on different schemas and GIS maps.
If you delete an object type or a link type through the Instances window, then it is deleted from the Application.
An instance can be created manually or automatically. For more info on how to create an instance manually see sections 2.5.3-2.5.4. For more info on how to create an instance automatically see section 2.5.5.
Instances are processed in the Instances window. The Instances window is described in section 2.5.2.
The operations that you can execute in the Instances window are described in section 2.5.6.


2.5.2 The Instances window

The Instances window contains a list of all the object types and link types that are defined in the Application.
To start working with the Instances window, follow these steps:
  1. Open an existing investigation or create a new one. Operations with investigations are described in sections 2.1-2.4.

  2. In the Main menu, select Windows → Instances. The Instances window appears (Figure 14).

Figure 14

Figure 14. Instances window

The Instances window items are described in table 4.

Table 4. Instances window items

Item

Purpose

Menu items

table4_img1

Create subfolder

table4_img2

Edit selected item's caption

table4_img3

Delete selected items

table4_img4

Drop-down list for selecting a search criteria

table4_img5

Drop-down list for selecting an item arrangement way

Other window items

table4_img6

Object search bar

table4_img7

To move folder, object type, or link type

table4_img8

To move folder, object type, or link type down



2.5.3 Creating an object instance

Object instances are created via the Instances window.
To create an object instance, follow these steps:
  1. Open the Instances window. For more info on how the window opens see section 2.5.2.

  2. In the Instances window right-click the icon or the object type name for which you want to create an instance. The context menu opens (Figure 15).

Figure 15

Figure 15. Creating a new object instance

  1. Select the Create Instance operation from the context menu. The Button 3 icon appears to the left of the selected object type. Attributes specified for this instance type by default are assigned to the created instance.

  2. Click the Button 3 icon that appears after the new instance is created. To open the drop-down list for the created instance. By default a new instance has no name and empty attribute parameters.

  3. To add attributes of the selected type, right click the required object attribute type and select Add value in the menu that appears. Attribute of the selected type is added.

  4. To set the parameters for an instance click on the relevant attribute icon and then either click the Button 4 button or press F2. An editable string appears to the right of the selected attribute icon.



2.5.5 Automatic creation of instances

Representation links the table columns to the instances displayed.
When a schema is built using a table, the table is first converted into instances, then the graph is created in accordance with those instances. When representation is applied, then instances, vertices, and edges are built.
To convert a table into instances through representation follow these steps:
  1. In the Main menu, select Windows → Requests. The Requests window opens.

  2. Double-click on the request string or click on the Table button in the Requests window menu. A table with data about the request opens (Figure 19).

Figure 19

Figure 19. Request results table

  1. In the Requests window menu select Schema. Next select the parameters for the schema you want to create from the drop-down list (Figure 20). For example, Schema → Complete → All types. A schema will be built.

Figure 20

Figure 20. Choosing a schema formation template

  1. In the Main menu, select Windows → Instances. The Instances window opens. All of the instances created for objects will be displayed in the Instances window. Each instance is filled in with data in accordance with the specified representation. On the basis of the instances a graph is built where each table row is transformed into a link between two objects (Figure 21).

Figure 21

Figure 21. Schema instances



2.5.6 Operations with an instance

The operations with an object instance or a link instance are executed the same way.
Operations with instances are performed through the context menu by right-clicking on the instance with which an action is to be performed (Figure 22). Operations with instances in the Instances window are described in sections 2.5.6.1 - 2.5.6.5.
Figure 22

Figure 22. Instance context menu


2.5.6.1 Viewing an instance in an investigation

To view an instance in an investigation, follow these steps:

  1. In the instance list, right-click an instance. Context menu opens (Figure 22).

  2. In the context menu, select the Show in Investigation operation. The selected instance will be highlighted in all the visual analysis tools of the investigation: on a schema, a GIS map, etc.


2.5.6.2 Combining instances

To combine instances, follow these steps:

  1. Select two instances by left-clicking on them while holding down the Ctrl key. Right-click on any of the selected instances. A context menu opens with the Combine operation to choose (Figure 23).

Figure 23

Figure 23. Combining instances

  1. Click Combine. The selected instances will be combined. To set the sorting parameters for the combined attributes, click the Button 7 button and select the desired sequence.


2.5.6.3 Creating a copy of an instance

To duplicate an instance, follow these steps:

  1. In the instance list, right-click an instance. Context menu opens (Figure 22).

  2. In the shortcut menu, select the Create Double operation. A duplicate of the selected instance is created.


2.5.6.5 Changing instance properties

To change the instance parameters, follow these steps:

  1. Select the instance by right-clicking on it. Context menu opens (Figure 22).

  2. In the context menu, click Properties. The Properties window opens (Figure 24).

  3. In the General and Graph Vertex tabs of the window, change the attributes. Adjustable attributes are listed in Table 5.4

Figure 24

Figure 24. Properties window

  1. To apply changes to an existing graph, it is necessary to click on the instance with changed properties, or to switch to another tab.

The instance attributes are described in Table 5.

Table 5. Instance attributes

Attribute group

Attributes in a group

Note

General tab

General

Picture

Changing/selecting the attribute icon. Click the table5_img1 button

Text color

Drop-down list for selecting a text color. Click the table5_img2 button to select color parameters.

Font

Drop-down list for selecting a font type. Click the table5_img2 button to select font parameters.

Line color

Source

Click the table5_img2 button to select a source

Custom

Drop-down list for selecting a line color. Click table5_img2 to select color parameters.

Fill color

Source

Click the table5_img2 button to select a source.

Custom

Drop-down list for selecting fill colors. Click table5_img2 to select color parameters.

Graph-Vertex tab

View

Representation

Click the table5_img2 button to select a representation.

Line type

Click the table5_img2 button to select a line type.

Line thickness

Editable

Framing

Click the table5_img2 button to select a framing.

Other

Hide

Click table5_img2 to select a parameter.

Lock

Click table5_img2 to select a parameter.

Tree root

Click table5_img2 to select a parameter.

General

Show note

Click table5_img2 to select a parameter.

Text

Show text

Click the table5_img2 button to select a parameter.

Background color

Drop-down list for selecting a background color. Click table5_img2 to select color parameters.

Show frame

Click the table5_img2 button to select a parameter.

Frame color

Drop-down list for selecting a frame color. Click table5_img2 to select color parameters.

Show line before text

Click the table5_img2 button to select a parameter.

Depth

Editable

Accuracy

Editable

  1. Click Close. The Properties windows is closed.



2.5.7 Creating a new object type

New object instances are created via the Instances window.
To create a new object type, follow these steps:
  1. In the Instances window, right-click on the Objects string. Context menu opens (Figure 25).

Figure 25

Figure 25. Adding a new object type

  1. In the opened context menu, select the Add New Object Type operation. The Object Type Settings window opens (Figure 26).

Figure 26

Figure 26. Object type settings window

  1. In the Object Type Settings window, fill in the Name field.

  2. In the Attributes tab, in the Attribute Collection column, click on the attribute that you want to assign to the object being created. The attribute will be highlighted.

  3. In the Attribute Collection column menu, click the Button 6 button. The selected attribute will be added to the Type Attributes column. Repeat this step for all the required attributes.

Note. An object type cannot exist without attributes.

  1. In the Type Attributes column, check the identifying attribute.

Note - The identifying attribute specifies how different instances are combined when building and also specifies which values will govern the data in the investigation. When represented on a schema, the identifying attribute will be unique. Non-identifying data is combined into arrays.

  1. If necessary, in the General tab of the Object Type Settings window, modify the basic parameters.

  2. In the Object Type Settings window, click the Graph Vertex tab. Change the parameters, if necessary.

  3. Click OK. A new object type will be created and displayed in the Objects list in the Instances window (Figure 27).

Figure 27

Figure 27. Creating an object type

  1. In the Instances window, right-click on the created object type. Context menu opens (Figure 28).

Figure 28

Figure 28. Creating an object type instance

  1. In the context menu, select the Create Instance operation. An instance is created for the selected object type.

  2. Fill in the instance with data. An example of filling in is shown in Figure 29.

Figure 29

Figure 29. Object type instance

The Object Type Settings window items are described in tables 6-7.

Table 6. Object Type Settings window items. Attributes tab

Item

Purpose

Menu items

table6_img1

Specifying the created object name

Attributes tab

table6_img2

Creating a new attribute

table6_img3

Deleting an attribute

table6_img4

Adding an attribute to the Type Attributes column

table6_img5

Moving an attribute in the Type Attributes column one string up

table6_img6

Moving an attribute in the Type Attributes column one string down

Table 7. Object Type Settings window items. The General and Graph-Vertex tabs

Attribute group

Group Attribute

Purpose

General tab

General

Picture

Changing/selecting the attribute icon. Click the table7_img1 button

Text color

Drop-down list for selecting a text color. Click table7_img2 to select color parameters.

Font

Drop-down list for selecting a font type. Click table7_img2 to select font parameters.

Line color

Source

Click the table7_img2 button to select a source.

Custom

Drop-down list for selecting a line color. Click table7_img2 to select color parameters.

Fill color

Source

Click the table7_img2 button to select a source.

Custom

Drop-down list for selecting fill colors. Click table7_img2 to select color parameters.

Graph-Vertex tab

View

Framing

Click table7_img2 to select a parameter.

Representation

Click the table7_img2 button to select a representation.

Line type

Click the table7_img2 button to select a line type.

Line thickness

Editable

General

Show note

Click table7_img2 to select a parameter.

Size

Height

Editable

Depth

Editable

Width

Editable

Text

Depth

Editable

Show line before text

Click the table7_img2 button to select a parameter.

Show frame

Click the table7_img2 button to select a parameter.

Show text

Click the table7_img2 button to select a parameter.

Accuracy

Editable

Frame color

Drop-down list for selecting a frame color. Click table7_img2 to select color parameters.

Background color

Drop-down list for selecting a background color. Click table7_img2 to select color parameters.


2.5.7.1 Creating a new object attribute

If the needed attribute is not in the Attribute Collection column, follow these steps:

  1. In the Attribute Collection column (Figure 26), click the Button 8 button. The Attribute Configuration window opens (Figure 30).

Figure 30

Figure 30. Attribute Configuration window

  1. In the Attribute Configuration window, specify the following parameters:

    • Attribute name

    • Attribute type

    • Select the common settings for displaying the attribute.

  2. Click OK. The new attribute is displayed in the Attribute Collection column.


2.5.7.2 Deleting an object attribute
An object attribute must have at least one value. If it has multiple values, they may be deleted.
To delete an object attribute, follow these steps:
  1. In the Attribute Collection column (Figure 26), click on the user-created attribute that you want to delete. The attribute will be highlighted.

  2. Click Button 9. The attribute is removed from the Attribute Collection column.



3 Data handling

3.1 Importing files

3.1.1 Description of Imported files

Files are imported in order to bring new data sets and new analytical requests into the Application. Files to be imported into the Application should have tabular structure with a separator placed between columns. The Application supports uploading of files in the following formats:

  • TXT

  • CSV

  • EXCEL

3.1.2 Import window

The Import window allows you to upload files:

  • Into the repository. Files are stored in a database separately from investigations. These files can be shared between investigations. When an investigation containing a link to a file stored in the repository is moved to another PC, the imported files are not moved along with it.

  • Into an investigation. The file is uploaded into the database inside the investigation. When such an investigation is moved to another PC, the imported files are moved along with it.

To start working with the Import window, follow these steps:

  1. Open an investigation. The operations with investigations are described in section 2.

  2. In the Main menu select Windows → Import. Import window opens (Figure 33).

Figure 33

Figure 33. Import window

The Import window items are described in table 10.

Table 10. Import window items

Item

Purpose

Menu items

table10_img1

Visualization of the imported file data as a table

table10_img2

Visualization of the imported file data as a schema

table10_img3

Visualization of the imported file data as a GIS map

table10_img4

A drop-down menu used to select operations to view data in a document

table10_img5

Importing files:

  • Into the repository

  • Into an investigation

Other window items

table10_img6

Data search bar

table10_img7

Attribute selection drop-down menu

table10_img8

Edit mapping drop-down menu

table10_img9

Adding Creation Templates

table10_img10

Edit creation template



3.1.3 Items in the imported file context menu

To view the imported file context menu, follow these steps:

  1. Open the Import window.

  2. Import a file into the Application. For details on how to import files into the Application, see section 3.1.4.

  3. Right click the name of the imported file. The file context click menu with the following operations appears (Figure 34):

    • Export. It allows you to export the file into the following formats: TXT, CSV, HTML, XLSX.

    • Parsing. It lets you to view the statistics of the imported file (Figure 35).

    • Header. It allows you to view types of the data stored in the uploaded file's columns.

    • Details. It lets you display the information about the file contents.

    • Delete. It allows you to delete the file.

Figure 34

Figure 34. Context menu of the imported file

Figure 35

Figure 35. Information of the uploaded file



3.1.4 Importing a data file into the Application

Similar operations are used to import files into both the repository and investigation. Let us discuss how to import a file into an investigation.
To import a file into the Application, follow these steps:
  1. In the Main menu select Windows → Import. Import window opens (Figure 33).

  2. In the Import window menu select Button 10. A list used to select a location to import the file opens (Figure 36).

Figure 36

Figure 36. Selecting a location to import the file

  1. For example, select Upload to investigation. A file selection window on the user's PC appears (Figure 37).

Figure 37

Figure 37. Selecting a file on the user's PC

  1. Select a file on PC and click Open. The file is uploaded into the currently opened investigation.

See Table 11 for a description of items in the Open window displayed when uploading a file from the user's PC.

Table 11. Open window items

Item

Purpose

table11_img1

Add a tag to the imported file

table11_img2

Combining files with the similar structure if multiple files are selected on the user's PC. When combining files with different structures, the structure of the first selected file has the highest priority. Data of files with another structure is not uploaded

table11_img3

It allows you to take the column name from the first row. When this checkbox is deselected, the table columns are named as follows: Column1, Column2, etc.

table11_img4

It allows you to set the separator character. If you know the separator character of the file to be uploaded, specify it in this setting to upload the file faster

Settings

table11_img5

It allows you to discard duplicate rows when uploading into the database

table11_img6

It allows you to upload a file forming a table that subsequently can be modified from the investigation



3.1.5 Combining imported files

Only files with the same structure can be combined. When combining files with different structures, the highest priority belongs to the structure of the first file in the list sorted alphabetically by name. Data of files with another structure is not uploaded.
To combine files when importing them into the System, follow these steps:
  1. In the Main menu select Windows → Import. Import window opens (Figure 33).

  2. In the Import window menu select Button 10. A list used to select a location to import the file opens (Figure 36).

  3. For example, select Upload to investigation. The Open window opens to choose a file on the user’s PC (Figure 37).

  4. In the Open window check Join. Press and hold Ctrl then select two files with the same structure (data format and type) and click Open. The files are uploaded into the investigation currently opened in the Application (Figure 38). Names of the uploaded files are displayed in a single file. To view results of uploading and combining, double click the name of the uploaded file.

Figure 38

Figure 38. Import window with combined files




3.2 Handling custom requests

3.2.1 Custom request description

A custom analytical request is a module written in Python that implements API. The module allows the user to create custom analytical requests, describe custom object types, and link types.
Custom requests are divided into the following categories:
  • User ontologies. User ontologies are files that describe object and link types, but do not describe custom tasks.

  • Custom requests. Custom requests should contain custom scripts implemented programmatically via the provided API.

Custom request files may contain user ontology.
A request includes its name and the category in which it is displayed when loaded into the List of requests.


3.2.2 Macros

In a custom request, the user may add the ability to automatically fill in the input parameters using the data on a GIS map or graph as well as to execute analytical requests and receive results automatically.
A macro allows you to perform the following actions with a single click:
  • Fill in the input parameters of a request.

  • Execute the request.

  • Receive the results onto the initial tab.

When working with a schema or GIS map, to launch a macro, use the instance context menu.



3.2.3 Scripts window

The Requests window is used to perform initial operations with custom requests.
To start working with the Scripts window, follow these steps:
  • In the Main menu select Windows → Scripts. The Scripts window opens (Figure 39).

Figure 39

Figure 39. Scripts window

The Scripts window items are described in table 12.

Table 12. Scripts window items

Item

Purpose

Menu items

table12_img1

Loading scripts from files

table12_img2

Loading scripts from a folder

table12_img3

Deleting scripts

table12_img4

Displaying information about loading scripts

table12_img5

Search bar



3.2.4 Uploading scripts

To upload a script, follow these steps:

  1. Open the Scripts window. This step is described in section 3.2.3.

  2. To upload a script from files in the Scripts window, click Button 11. To upload a script from a folder, in the Scripts window, click Button 12. The Open window is opened where you can select a script (or a folder containing scripts) on the user's PC.

  3. In the Open window, click a script to select it. The script is highlighted.

  4. In the Open window click Open. The selected scripts are displayed in the Scripts window (Figure 40). When uploaded, these scripts are available for execution in the List of requests window.

Figure 40

Figure 40. Uploaded scripts

Note. If the file you import contains only an ontology, it is displayed in the Data box of the Scripts window when uploading is complete. If the imported file contains ontology and custom requests, this file is displayed in the Tasks box of the Scripts window.




3.3 Working with requests

3.3.1 Description of requests

Requests are used to analyze data in the Application. A request is based on a custom analytical request that was uploaded into the Application in advance. The script determines the object types that can be mapped to the input parameters of the request. Executed requests may be represented in the following forms:

  • A table is a tabular representation of the data obtained by executing a request. Distribution of data into columns is used to analyze data in a table. A table may be generated for any request.
    A schema is a graphical representation of request execution results. It allows the data to be analyzed and interpreted using a set of special tools. A schema can be generated when an icon is displayed in the request string Button 13. When this icon is missing, you can build a schema based on the generated table manually using the tools in the Create template window.
  • A GIS map is representation of request results bound to geographical location of the data.
    A GIS map can be generated when Button 14 icon is displayed in the request string. When this icon is missing, you can build a GIS map based on the generated table manually using the tools in the Create template window.

The List of requests window is shown in Figure 41.

Figure 41

Figure 41. List of requests window

All executed requests are displayed in the Requests window. To open the Requests window, select Windows → Requests in the Main menu. The Requests window opens (Figure 42).

Figure 42

Figure 42. Requests window

To modify a request name, you need to click the request in question and press F2 on the keyboard. The request name text becomes editable. When all the changes are made, press Enter.



3.3.2 Tools for working with requests

The Requests window items are described in table 13.

Table 13. Requests window items

Item

Purpose

Window menu

Menu item table13_img1

Visualizing the data of executed request in a table

Menu item table13_img2

A drop-down menu used to select operations to view request data on a schema

Menu item table13_img3

A drop-down menu used to select operations to view request data on a GIS-map

Menu item table13_img4

A drop-down menu used to select operations to view request data in a document

Window submenu

table13_img5

Managing request tabs. The following actions are available:

  • Open all tabs of the request

  • Close all tabs of the request

table13_img6

Viewing input parameters of the request

table13_img7

Viewing the request execution log

table13_img8

Viewing the request information

table13_img9

Word wrap

table13_img10

Hide the additional menu

Other window items

table13_img11

Get filtered results

table13_img12

Get results to the active tab

table13_img13

Hide the window automatically

table13_img14

Close the window

table13_img15

Drop-down list of mappings to be added

table13_img16

Drop-down list of mappings to be edited

table13_img17

Adding Creation Templates

table13_img18

Drop-down list of created templates



3.3.3 Request status

In the Requests window, the request status precedes the request name. Table 14 shows possible request statuses.

Table 14. Request statuses

Status icon

Request state

table14_img1

Request start

table14_img2

Request execution process

table14_img3

Executed request

table14_img4

A request sent for execution with unsaved results

table14_img5

Request execution canceled

table14_img6

Error executing a request



3.3.4 Request execution

To start a request, follow these steps:

  1. In the Main menu select Windows → List of requests. The List of requests window opens (Figure 43).

  2. In the left area of the window that appeared check the string of a request you need to execute. For example, in the Cyber Security section check Email harvester. The input parameters of the request are displayed in the right portion of the List of requests window (Figure 44). You can select one or more requests at a time.

  3. In the right-hand area of the Parameters window, modify the required parameters by clicking the drop-down list button for each parameter string (Figure 44). Parameters may be set both manually, by placing a special separator character in the corresponding field, and uploaded from a text file. By default, the Interval start parameter is set to the current date. If necessary, it can also be modified.

  4. Click Execute at the bottom of the List of requests window. The request is executed.

Note. If any parameter is omitted or set incorrectly, when you click Execute, a message window opens. Click OK and modify the parameter specified in the message.

Figure 43

Figure 43. List of requests window

Figure 44

Figure 44. Viewing the input parameters of the selected request

The List of requests window (Figure 43) items are described in table 15.

Table 15. Items of the List of requests window

Item

Purpose

table15_img1

Search requests by name

table15_img2

Add prefix to the name of a selected request

table15_img3

Selecting all requests

table15_img4

Deselecting all requests

table15_img5

Navigating to the standard list of requests

table15_img6

Resetting the filter criteria set for the list of requests

table15_img7

Closes investigation

table15_img8

Execute a request

table15_img9

Show all requests



3.3.5 Searching for request script

A request script can be searched by both its name and the criteria of its operation.
To search for a request script by name, follow these steps:
  1. In the Main menu select Windows → List of requests. The List of requests window opens (Figure 43).

  2. In the Search field, type the full or partial name of the request script you need to find (Figure 45).

Figure 45

Figure 45. Searching for a request by name

  1. A list of corresponding request scripts is displayed under the search field. The words that match the search string are highlighted (Figure 45).

To search for a request script by the criteria of its operation, follow these steps:

  1. In the Main menu select Windows → List of requests. The List of requests window opens (Figure 43).

  2. In the Criteria area, check the names of the required criteria of the request script operation (Figure 45).

Figure 46

Figure 46. Searching for a request by criteria

  1. The list of request scripts that meet the defined criteria is displayed under the search field.



3.3.6 Request operations

3.3.6.1 Request marking

Requests are marked in the List of requests window. For information of starting requests, see section 3.3.4.

To mark a request, follow these steps:

  1. In the Main menu select Windows → List of requests. The List of requests window opens (Figure 43).

  2. In the list of requests, check one or more requests.

  3. Specify the prefix in the Your marking field.

  4. Click Run. In the list of requests, the specified prefix is displayed at the beginning of the selected request name (Figure 47).

Figure 47

Figure 47. Adding a prefix to a request name


3.3.6.2 Exporting request

Executed requests can be exported into files of the following formats:

  • txt

  • csv

  • html

  • xlsx

To export a request, follow these steps:

  1. In the Main menu, select Windows → Requests. The Requests window with the list of requests appears.

  2. In the Requests window select a request you want to export.

  3. Click the selected request. Context menu opens (Figure 48).

Figure 48

Figure 48. Exporting an executed request

  1. Select a format for exporting the request. A window for selecting file storage location on the user's PC.

  2. Specify the location to store the file. Click Save. The executed request is saves on the user's PC.


3.3.6.3 Restarting requests
Request restart operation allows you to create a request copy. The previously specified input parameters are preserved for the request.
To restart a request, follow these steps:
  1. In the Main menu, select Windows → Requests. The Requests window with the list of requests appears.

  2. In the Requests window select a request you want to restart.

  3. Click the selected request. Context menu opens (Figure 49).

Figure 49

Figure 49. Restarting a request

  1. Select the Restart operation. The request is sent for execution with the same input parameters you specified in the selected request. A sequential number is added to the name of the created request.


3.3.6.4 Restarting a request with changes
By restarting a request with changes you can create the request copy with modified input parameters.
To restart a request with changes, follow these steps:
  1. In the Main menu, select Windows → Requests. The Requests window with the list of requests appears.

  2. In the Requests window, select the request you want to restart with modified parameters.

  3. Click the selected request. Context menu opens (Figure 50).

Figure 50

Figure 50. Restarting a request with changes

  1. Select Restart with changes. The List of requests window opens.

  2. Check the required request. The input parameters of the selected request appear (Figure 51).

Figure 51

Figure 51. Changing the input parameters of a request

  1. Modify the input parameters of the request.

  2. Click Run. The request is executed with the modified parameters. Use the Requests window to view the executed request.


3.3.6.5 Canceling request execution
A request can be canceled only during the process of its execution.
To cancel a request, follow these steps:
  1. In the Requests window, select a request that is being executed.

  2. Click the selected request. Context menu opens (Figure 52).

Figure 52

Figure 52. Canceling a request during its execution

  1. Select Cancel. Request execution is canceled. The request status is changed to Button 15.


3.3.6.6 Deleting a request

To delete a request, follow these steps:

  1. In the Main menu, select Windows → Requests. The Requests window with the list of executed requests appears.

  2. In the Requests window select a request you want to delete.

  3. Click the selected request. Context menu opens (Figure 53).

Figure 53

Figure 53. Deleting a request

  1. In the context menu, select Delete. The request is deleted from the Application.





4 Request result visualization tools

4.1 Working with the Explorer window

All investigation visualizations are listed in the Explorer window.
The Explorer window allows you to navigate the entire set of investigation data (Figure 54).
Figure 54

Figure 54. Explorer window

To open any object of an investigation (for example, a table, map, schema, etc.), double click it in the Explorer window.
To show items of a schema or map, in the Explorer window, check the required item (for example, a point on a map, instance on a schema, etc. (Figure 55)).
Figure 55

Figure 55. Displaying an item

The Explorer window items are described in Table 16.

Table 16. The Explorer window items

Item

Purpose

Menu items

table16_img1

Create subfolder

table16_img2

Edit selected item's caption

table16_img3

Delete selected items

table16_img4

Drop-down list for selecting a search criteria

table16_img5

Drop-down list for selecting an item arrangement way

table16_img6

Drop-down list visualization options (schemas/GIS maps/documents) based on the data of the selected item (it is only available for schemas, GIS maps and tables with the required matched defined)

Other window items

table16_img7

Search bar

table16_img8

Move a folder or object up

table16_img9

Move a folder or object down




4.2 Working with tables

4.2.1 Description of tables

A table is a set of data to be analyzed.
Each table has its own structure. The used request contains information of the table structure. Besides, this information represent input parameters. Data of tables cannot be edited.
You can use the following methods to obtain a table with data:
  • Import structured data into the Application. For details on how to import files, see section 3.1.

  • Create a table by executing an analytical request using a script. For information about executing requests, see 3.3.4.



4.2.2 Tools for working with tables

Tools for working with tables are available when a table is opened.

4.2.2.1 Items of the Table window menu
When the window for tabular representation of data is opened, the Table item becomes active in the Main menu.
Items of the Table main menu partially duplicate the tools in the sidebar of the request table window (Figure 56).
Figure 56

Figure 56. The items of the table sidebar and the main menu of the Table tab

See Table 17 for a description of the Table main menu items.

Table 17. The buttons of the Table tab’s main menu

Button

Purpose

table17_img1

Drop-down menu for selecting operations used to generate a schema

table17_img2

Drop-down menu for selecting operations used to generate a GIS map

table17_img3

Show in investigation. To use this button, first select strings in a table, then open a window displaying the list of instances (for example, the Instances window). In this case, instances are highlighted for all the highlighted strings of the table.

table17_img4

Select columns. It allows you to group columns. The selected columns should be moved into the Select columns window. To move a column from the Select columns window back into the table, double click the name of the required column.

table17_img5

Hide empty columns

table17_img6

Width selection

table17_img7

Expand groups. Shows the contents of object groups

table17_img8

Collapse groups

table17_img9

Ungroup

table17_img10

Clear sorting

table17_img11

Clear filter

table17_img12

Clear selection

table17_img13

Drop-down menu for selecting table export format. Possible export formats: txt, csv, html, xlsx

table17_img14

Adding a mapping. Attribute selection drop-down menu

table17_img15

A drop-down menu for editing mappings

table17_img16

Adding Creation Templates

table17_img17

Edit creation template


4.2.2.2 Applying a filter to table data
Data stored in a table may be filtered by any column of this table:
To filter the data in a table, follow these steps:
  1. Open a data table.

  2. Click the drop-down list button by any table column name. A filter window opens that contains the list of unique values of this column (Figure 57).

  3. Search for a specific value using the search bar or use the scroll bar on the Values tab.

  4. Check one or more values.

  5. On the Values tab of the filter window click OK. The table data is displayed based on the applied filter.

  6. To search for text values, go to the Text filters tab. Enter the search criteria and search string.

  7. On the Text filters tab of the filter window, click OK. The table data is displayed based on the applied filter.

Note. Once you have applied a filter by one column, you can filter by another column. In this case, only the data displayed according to the first filter is filtered again. This way you can filter by column data several times. When you filter by different columns the logical AND is always used.

Figure 57

Figure 57. Filtering table data

Note. When creating a graph based on filtered table data, only the filtered data is displayed on this graph.

Row count – specifies the quantity of rows that meets the filter criteria and will be displayed on the graph.

Rows selected – specifies the quantity of selected rows to be displayed on the graph (Figure 58)

Figure 58

Figure 58. Viewing the quantity of selected rows


4.2.2.3 Setting up table columns

To set up a table, follow these steps:

  1. Open a data table.

  2. Right click any table column header. Table column setting panel appears (Figure 59).

Figure 59

Figure 59. Table column setting panel

See Table 18 for description of table column settings.

Table 18. Table column settings

Setting

Purpose

Select cells

It allows you to select all the data of a column with filter panel opened

Copy unique values

It allows you to copy all the unique values of a column with filter panel opened

Lock left

It allows you to lock the selected column in the table to the left hand side

Lock right

It allows you to lock the selected column in the table to the right hand side

Unlock

It allows you to unlock the selected column

Sort ascending

It allows you to sort the data of a column with filter panel opened in ascending order

Sort descending

It allows you to sort the data of a column with filter panel opened in descending order

Clear sorting

It allows you to clear the selected sorting

Clear all sorting

It allows you to clear all sorting

Group by this column

It allows you to group by the column with filter panel opened. When grouping, each unique value of the column represents a group. Double grouping is possible. The quantity of groups cannot exceed 10,000 strings.

Show grouping area

This setting opens a panel in the upper portion of a table. Using this panel you can transfer columns to be used for grouping

Hide column

It allows you to hide columns

Select columns

Select columns you need to display. When this filter condition is selected, the Select columns window opens with the list of currently hidden columns

Width selection

Automatic width selection by column data

Width selection (all columns)

Automatic width selection by table data

Clear filter

It allows you to reset the defined filter parameters

Filter editor

A more complex filter by columns. See section 4.2.2.4 for description of the Filter editor

Show search panel

It allows you to perform full-text data search. See section 7.2 for description of table data search.

Note. All empty columns are hidden by default.

  1. Select column setting condition.


4.2.2.4 Using the Filter editor

Using the Filter editor, you can define more complex filters for table columns applying logical AND and OR.

To filter table data using the Filter editor, follow these steps:

  1. Open a data table.

  2. Right click any table column header. Table column setting panel appears (Figure 59).

  3. Select Filter Editor. The Filter Editor window opens (Figure 60).

Figure 60

Figure 60. Filter Editor window

Example 1 for using the Filter Editor.

  1. For example, in the Filter Editor window we click Button 16, strings for setting conditions will be added.

  2. We click Button 17 in the Filter Editor window. Context menu opens (Figure 61).

Figure 61

Figure 61. Context menu for selecting an action to create a filter

  1. In the context menu, we select Add group. A group is added where you can create filter conditions (Figure 62).

Figure 62

Figure 62. Filter condition group

  1. We click Country in the filter string. Context menu for selecting a table column is displayed (Figure 63).

Figure 63

Figure 63. Selecting a table column for setting the filter condition by this column

  1. In the context menu, we can select a table column to be used for setting the filter condition. Here, for example, the Country column is selected.

  2. You can add other filtering conditions. For example, click Does not equal in a filter string. Context menu for selecting column filter condition opens (Figure 64).

Figure 64

Figure 64. Selecting a filter condition

  1. Click the Does not equal condition and choose Is greater than in the drop-down list. The filter condition is displayed in the filter string. Type in a value that should be less than the value of the column data (Figure 65). According to this filter condition, all table strings where the value of the Facebook id column is greater than value 4 will be displayed.

Figure 65

Figure 65. Setting the filter conditions for a table column

  1. Repeat steps 5 to 10 to specify conditions for all columns to be used for filtering. The logical AND is used in this process.

  2. Click Apply. The table data is displayed according to the defined filter conditions.

Example 2 for using the Filter Editor.

To use the logical OR, follow these steps:

  1. At the tree root click the logical AND and select the logical OR (Figure 66)

Figure 66

Figure 66. Applying the logical OR

  1. Type in the values of two table column and the data that these columns should contain (Figure 67). According to this condition, all table rows, where the Facebook id column value is not equal to 4 or the School column value begins with 1, will be displayed.

Figure 67

Figure 67. OR condition

  1. Click Apply. The table data is displayed according to the defined filter conditions.



4.2.3 Adding creation templates

A creation template is required for setting up type attributes in the context of table data. This allows creating complex schemas, graphs, GIS maps or documents containing an unlimited number of elements based on the table data.

4.2.3.1 Preparing a schema creation template

To create a schema using a Creation template, follow these steps:

  1. Open a data table.

  2. Click Add creation template Button 18 in the table sidebar or in the Main menu. The Creation template window opens (Figure 68).

Figure 68

Figure 68. Creation template window

  1. In the Creation template window, click Add object. The object is added to the working area of the window (Figure 69).

Figure 69

Figure 69. Object and object type definition

  1. In the Type area, click the drop-down list button and select a type for the object. For example, select Phone. In the Attributes area, all the attributes of the selected object are displayed since the selected type is defined in the Application (Figure 70).

Note: The following parameters are applied to attributes:

  1. The Attributes area. A column with Button 19 icon. Checking this column defines the identifying (key) attribute. One or more attributes may be defined as identifying ones.

  2. The Attributes area. A column with Button 20 icon. Checking this column defines the attributes to be represented in the caption when the object is shown on a schema.

  3. Working area. One of the object's attributes is marked with asterisk (*). The attribute marked with asterisk is identifying one.

Figure 70

Figure 70. Displaying the selected type

  1. To set links between attributes and table columns, click the buttons in the Table area and drag the required columns on the respective attributes of the object. Attributes are populated with the selected values of the table. The selected types are also added to the Attributes area (Figure 71).

Figure 71

Figure 71. Selected object attributes

  1. Add the second object into the working area repeating the steps 3 to 6. The second object is added.

  2. To remove an object or a link, select this item and click Delete.

  3. In the working area of the Creation template press and hold Ctrl then select the created objects.

  4. In the Creation template window, click Add link. A link is established between the created objects. To set a link type (if the required type is defined in the Application), in the Type area click the drop-down list button and select a type. When you need to set a link type that is not defined in the Application, define an attribute for the link by dragging the data from the Table area on to the link arrow (Figure 72).

Figure 72

Figure 72. Adding a link between objects

  1. To change the direction of the link, in the Creation template window click Invert direction.

Note. Unlimited quantity of objects and links between them may be added into a template.

  1. In the Creation template window, type in the template name in the field located in the upper portion of the window.

  2. Click OK. The template is created.


4.2.3.2 Applying a schema creation template

To apply a creation template, follow these steps:

  1. Open a data table.

  2. Select the table strings to be used for creating a schema. If no table string is highlighted, by default, the schema is created using the entire table data.

  3. Click Schema Button 21 in the sidebar. A drop-down list appears (Figure 73).

Figure 73

Figure 73. Creating a schema using a template

  1. Select the prepared creation template in the drop-down list that appeared. A schema window with graphs built using the template appears.

Note. The quantity of vertices created on the schema depends on the selected identifying attribute. Identical data of a table column is transformed into a single instance.


4.2.3.3 Modifying a schema creation template

To modify a creation template, follow these steps:

  1. Open a data table.

  2. Click Button 22 in the sidebar of the table window. The creation template editing drop-down list appears (Figure 74).

Figure 74

Figure 74. Modifying a creation template

  1. In the drop-down list, select a template → Edit. The Creation template window opens with the selected template displayed.

  2. Edit the template in the Creation template window. Working with the Creation template window is described in section 4.2.3.1.

  3. In the Creation template window, click OK. The creation template is modified.


4.2.3.4 Deleting a schema creation template

To delete a creation template, follow these steps:

  1. Open a data table.

  2. Click Button 22 in the sidebar of the table window. The drop-down list appears (Figure 75).

Figure 75

Figure 75. Deleting a creation template

  1. In the drop-down list, select a template → Delete. The creation template is deleted.


4.2.3.5 Creating new object types automatically

To create new object types automatically, follow these steps:

  1. Open a data table.

  2. Click Button 18 in the table sidebar or in the Main menu. The Creation template window opens (Figure 68).

  3. In the Creation template window, click Add object. The object is added into the working area of the window.

  4. In the Creation template window, in the Attributes area, click an empty string in the Name column. A drop-down list for selecting attributes appears (Figure 76).

Figure 76

Figure 76. Selecting an attribute

  1. Select the required attribute in the attribute selection drop-down list.

  2. Repeat steps 4 to 5 to select the required set of attributes.

  3. In the Attributes area check an identifying attribute.

  4. In the Type area specify the object name (Figure 77).

Figure 77

Figure 77. Selecting attributes for an object

  1. In the Table area, drag the table columns on to the corresponding attributes in the Attributes area to link the attributes with these table columns (Figure 78).

Figure 78

Figure 78. Linking attributes with table columns



4.2.4 Setting mappings

Setting type attributes mappings to table data is required to enable creating a graph based on the table data.

4.2.4.1 Viewing the mappings set for a table

To view mappings set to the data of a certain table, open the table in question and follow these steps:

  1. In the Main menu, select Windows → Requests. The Requests window opens.

  2. Click Edit mapping Button 23 in the sidebar of the table or in the Main menu. The list of mappings to the opened table appears (Figure 79). The list of mappings contains:

    • Mappings to objects

    • Link mappings

Figure 79

Figure 79. List of mappings to the opened table


4.2.4.2 Configuring data table mappings
Table data mappings (mapping of the table column to type attributes) should be configured in order to automatically create instances based on the table data.
To configure table data mappings, follow these steps:
  1. Open a data table.

  2. Click Add representation Button 24 in the sidebar of the table or in the Main menu. The list of objects and links appears (Figure 80).

Figure 80

Figure 80. Drop-down list of objects and links

  1. Click an object. For example, select Call. Select Edit from the context menu. The Mapping configuration window opens (Figure 81).

Figure 81

Figure 81. Mapping configuration window

  1. In the drop-down lists of Column, select the table columns that will be mapped to the respective type attribute (Figure 81).

  2. In the Mapping configuration window, click OK. The mapping is added.

Also, you can configure tools for working with tables. The respective actions are described in section 5.3.6.

Note.

  1. When generating a table using a request based on a selected script, this script may contain defined mappings between table columns and type attributes.

  2. When importing a file with a new structure, you need to configure mapping between table columns and attributes.

  3. When uploading a file with a structure that is identical to the structure of a file previously uploaded into the Application, the mapping for the uploaded file structure is saved in the Application. In this case, there is no need to configure the mapping.




4.3 Working with a schema

4.3.1 Description of a schema

A schema is a visualization area where graphs and graphic primitives can be visualized.
Graph is a method for visualizing data on a schema and analyzing this data. Basic items of a graph:
  • Vertices. A vertex is an instance mapped to a graph.

  • Links.

  • Vertex captions. Vertex captions can be relocated to any point on a schema.

  • Link captions. Can be relocated only along the link line.

  • Link control points. Control points allows you to bend link lines.

The user adds link control points manually or automatically (for some kinds of placements). For example, for orthogonal placements control points are added automatically. A control point is required to bend a link line.
The user adds graphic primitives on a schema manually. These are shapes like rectangle or rectangle with text required to add graph annotation.
A graph on a schema is circumscribed by a rectangle (Figure 82). This rectangle shows the graph items and represents the graph border.
Figure 82

Figure 82. Graph rectangle

Multiple graphs can be built on a single graph.
The second graph on a schema is built using the Main menu Graph → New graph. Two graphs created to the same schema will not be connected with each other in any way (Figure 83). But same instances can be visualized on different graphs.
Figure 83

Figure 83. Two graphs on the same schema

Note. It is not recommended to implement multiple graphs on a single graph.

The following items of the Main menu are used to work with schemas:

  • Schema

  • Graph



4.3.2 Schema tools

Tools for working with schemas are available when a schema is opened.

4.3.2.1 Items of the Schema window menu

Some items of the Schema main menu and buttons in the Schema window sidebar perform the same operations (Figure 84).

Figure 84

Figure 84. Items of the schema sidebar and the Schema main menu

See Table 19 for a description of the schema sidebar buttons.

Table 19. Buttons of the schema sidebar

Item

Purpose

Buttons of the schema window sidebar

table19_img1

Create a schema

table19_img2

Creating a GIS Map

table19_img3

Drop-down menu for adding a value

table19_img4

Drop-down menu for removing a value

table19_img5

It shows items highlighted on a graph in the Instances or Explorer window and other windows containing items that are highlighted on a graph

table19_img6

Show text

table19_img7

Hide text

table19_img8

Entire schema overview

table19_img9

Remove active items

table19_img10

Remove inactive items

table19_img11

Remove isolated vertices

table19_img12

Add a link. The type of the added link depends on the type of the vertices connected by this link. A single click of this button draws a single link. A double click of this button turns on the drawing mode that allows you to draw multiple links

table19_img13

Add a node to a link. A single click of this button adds a single node. A double click of this button turns on the drawing mode that allows you to add multiple nodes

table19_img14

Cluster search. This button opens the Cluster search window where you can set the search parameters

table19_img15

Drop-down list of attributes that can be used for sorting. This list of attributes depends on the data table

table19_img16

Drop-down list for selecting the layout type. Layout types:

  • Tree-like

  • Circular

  • Orthogonal

  • Hierarchical

  • Concentric

  • Power

  • Multitier power

  • Forced Lin-Log

table19_img17

Drop-down list of items that can be selected The following items can be selected:

  • Vertices

  • Links

  • Groups

  • Invert selection

table19_img18

Display all vertices as theme line

table19_img19

Return the standard view of the schema representation

table19_img20

Measure the size and color of vertices in proportion to the quantity of neighbors

table19_img21

Drop-down list for selecting automatic grouping. You can select one of the following options:

  • Add all leaves to groups.

  • Group by common adjacent vertices

See Table 20 for description of the Schema main menu items not repeated in the schema sidebar.

Table 20. Schema main menu items not repeated in the schema sidebar

Item

Purpose

table20_img1

Select the schema scale

table20_img2

Trim excessive space

table20_img3

Select page parameters

table20_img4

Preview

table20_img5

Print the schema It is available only when the Page breaks parameter is set in Page parameters

table20_img6

Legend caption. Drop-down list for selecting legend parameters. Click Show legend to view the legend. Click Legend parameters to set user defined representation parameters. To view the correct data in the legend after making any changes to the schema (for example, when you have combined some vertices), click Update legend

table20_img7

Add a rectangle

table20_img8

Add text

table20_img9

Create a binding

table20_img10

Delete a binding

table20_img11

Drop-down list for selecting items being saved

table20_img12

Drop-down list for selecting the resolution

table20_img13

Save image

table20_img14

Select scale

table20_img15

Save a metafile


4.3.2.2 Graph menu items

See Table 21 for a description of the Graph Main menu items.

Table 21. Graph Main menu items

Item

Purpose

table21_img1

Create new graph

table21_img2

Add link

table21_img3

Add node

table21_img4

Add dummy vertex

table21_img5

Drop-down list for selecting data that can be added

table21_img6

Cluster search

table21_img7

Drop-down list for selecting the layout type.

table21_img8

Drop-down list of objects that can be selected

table21_img9

Update links to binary data

table21_img10

Drop-down list for selecting automatic grouping

table21_img11

Remove isolated vertices


4.3.2.3 Schema context menu items

To view the schema context menu, follow these steps:

  1. Open a schema.

  2. Right click any free space of the schema. The schema context menu with the following operations appears (Figure 85):

    • Scale up.

    • Scale down.

    • Normal scale.

    • Trim excessive space.

    • Entire schema overview.

Figure 85

Figure 85. Schema context menu


4.3.2.4 Graph context menu items

To view the graph context menu, follow these steps:

  1. Open a schema.

  2. Right click free space of a graph. The graph context menu with the following operations appears (Figure 86):

    • Sorting. It allows you to sort the selected items by attribute.

    • Layout. It allows you to sort the selected items. The following layout types are available:

      • Tree-like

      • Circular

      • Orthogonal

      • Hierarchical

      • Concentric

      • Power

      • Multilevel power

      • Power Lin-Log

    • Place connected components. It allows you to select connectivity components and locate them side by side without selecting a layout.

    • Select. It allows you to select the following graph items:

      • All

      • Vertices

      • Links

      • Tree

      • Groups

    • Hide text. Allows you to hide text of the following graph items:

      • All

      • For vertices

      • For links

    • Show text. Allows you to show text of the following graph items:

      • All

      • For vertices

      • For links

    • Set default text.

    • Link representation. You can select one of the following representations:

      • Combine into one

      • Split

      • Group by direction

      • Random

Figure 86

Figure 86. Graph context menu


4.3.2.5 Vertex context menu items

To view the vertex context menu, follow these steps:

  1. Open a schema.

  2. Right-click on a vertex. The vertex context menu with the following operations appears (Figure 87):

    • Copy onto new schema. It allows you to copy an item onto a new schema.

    • Show in investigation. It allows you to select a vertex in any opened window that contains this vertex (for example, in the Explorer or Instances window).

    • Select ends. Selecting the vertices located at the ends of the selected link.

    • Select links. It allows you to select:

      • All links.

      • Incoming links.

      • Outgoing links.

    • Keep selected. Selecting vertices or links that should remain selected.

    • Invert selection. It allows you to select everything else except the items that are currently selected. The currently selected items get deselected.

    • Add to group. It allows you to add an item into an existing group. This operation is performed in the Select groups window. It is impossible to perform this action if there is not group in the Application.

    • Add to new group. You can create a new group of items.

    • Create group with leaves. It allows you to combine a vertex and its child items.

    • Select neighbors, This operation is applicable to the first circle of items. You can select neighbors.

    • Select neighbors by depth level. You can select adjacent vertices based on the ring depth by selecting one of the following values:

      • First.

      • Second.

    • Select connected component. It allows you to select a component.

    • Select the shortest paths. It allows you to select the shortest paths. The operation can be performed when two or more vertices are selected.

    • Color levels of connectivity. Depending on the distance from the initial vertex, the color of links and vertices as well as the color of vertex frames is changing from warm to cold color. The closer a link or vertex to the initial vertex, the warmer their color. The more remote they are, the colder their color.

    • Place highlighted automatically It allows you to sort the selected items. The following layout types are available:

      • Tree-like

      • Circular

      • Orthogonal

      • Hierarchical

      • Concentric

      • Power

      • Multilevel power

      • Power Lin-Log

    • Sort selected. It allows you to sort the selected items by attribute.

    • Combine vertices. It allows you to stick together any two instances.

    • Copy vertex. Using this operation, you can copy the selected vertex.

    • Attach binary data. It allows you to add binary data from the user's PC.

    • Attach existing binary data. It allows you to add binary data from investigations.

    • Move to requests. You can go to requests. Input parameters of a request are specified.

    • Properties. You can edit values of instance attributes and change visual parameters of a vertex. The Properties window is used for editing.

Figure 87

Figure 87. Vertex context menu


4.3.2.7 Caption context menu items

To view the caption context menu, follow these steps:

  1. Open a schema.

  2. Right-click on a caption. A context menu with the following operations appears (Figure 89):

    • Edit. It opens the Caption editor window, where you can edit the vertex captions. The procedure for editing a caption is described in section 4.3.7.4.

    • Select vertex. It allows you to select a vertex.

Figure 89

Figure 89. Text context menu



4.3.3 Properties window

Each visualization item has certain properties. The Properties window is used to configure the visual parameters for an instance.
Edits made in the Properties window do not change the instance itself.
You can modify properties for either a single object or for all of the objects selected at the same time (in this case, only common properties for the selected objects are available to be edited).
To open the Properties window, select Windows → Properties. The Properties window opens (Figure 90).
Figure 90

Figure 90. Properties window


4.3.3.1 Configurable visual parameters for a schema
Initially, a schema is just a white background on which graphs and other objects are built.
See Table 22 for the configurable visual parameters for a schema that are available in the Properties window.

Table 22. Configurable visual parameters for a schema

Parameter group

Parameter

Purpose

Activity

Active color

Drop-down list of parameters allowing you to set the color for the active items. Click the table22_img1 button to configure the parameters.

Inactive are black and white

All inactive items become black and white. Click table22_img1 to select a parameter.

Inactive are transparent

All inactive items become transparent. Click table22_img1 to select a parameter.

General

Title

A field for entering the schema name

Background color

Drop-down list of parameters allowing you to set the color for the schema background. Click the table22_img1 button to configure the parameters.

Opacity

Click table22_img1 to configure the parameter. This allows you to define the transparency of the items. This setting is only available when Inactive are transparent is set to Yes

Temporary axis mode

Click table22_img1 to select a parameter.

Show graphic primitives

Click table22_img1 to select a parameter.

Show legend

Click table22_img1 to select a parameter.

Print

Print page borders

Click table22_img1 to select a parameter.

Grid

Use grid

Click table22_img1 to select a parameter.

Grid step

Grid step is measured in pixels. Editable


4.3.3.2 Configurable visual parameters for a graph

See Table 23 for the configurable visual parameters for a graph available in the Properties window.

Table 23. Configurable visual parameters for a graph

Parameter group

Parameter

Purpose

Layout

Current settings:

Drop-down list of graph layout settings. These settings provide different ways for creating vertices on a schema

Concentric

Drop-down list for selecting the distance between concentric rings. Editable

Circular

Drop-down list for selecting the parameters:

  • Calculate radius automatically. Click on table23_img1 to configure the parameter.

  • Radius. Editable

Hierarchical

Drop-down list for selecting the distance between levels. Editable

Power

Drop-down list for selecting the parameters:

  • Max depth. Editable

  • Maximum number of iterations. Editable

  • Relative force. Editable

  • Distance between adjacent vertices. Editable

Power Lin-Log

Drop-down list for selecting the parameters:

  • Autoplace into the mass center. Auto placing of the selected items. When this setting is defined, the center of mass

(i.e., the geometric center of all the items) is calculated. Click on table23_img1 to configure the parameter. - Minimum distance between vertices. This allows you to set the distance between the graph vertices. Editable - Distance between connected components. Distance between independent graphs. Editable - Bundle links. Bundling all the links that cannot be contained in the hierarchical structure where, by default, a vertex with the largest quantity of neighbors is the root of this hierarchical structure. Click table23_img1 to select a parameter. - Place text. Placing a vertex text to avoid intersections. Click table23_img1 to select a parameter.

Multilevel power

Setting the distance between vertices (edge length). Editable

Visual change of items

Colorize items

Click table23_img1 to select a parameter.

Change size

Click table23_img1 to select a parameter.

Tree selection

Select tree

A vertex with the largest quantity of neighbors is the root vertex, provided that the root vertex is not defined. The opacity for all the links that lie outside the selected tree can be modified, thereby changing the color of the items outside the selected tree. Click the button table23_img1 to select a parameter.

Bundle links

Bundling all the links that cannot be contained in the hierarchical structure where, by default, a vertex with the largest quantity of neighbors is the root of this hierarchical structure. Click table23_img1 to select a parameter.

Other

Max link thickness

Defining the link line thickness. This value is editable, but maximum allowed value exists

Frame visualization

Configuring the graph frame visualization. Click table23_img1 to select a parameter.

Show vertex borders

Configuring the visualization of vertex borders. Click table23_img1 to select a parameter.

Show nodes

Configuring the visualization of nodes. Click table23_img1 to select a parameter.

Sort lines by date

Sorting link lines by date. Click table23_img1 to select a parameter.

Search parameters

Consider direction

This allows you to take the link direction into account when searching. Click table23_img1 to select a parameter.

Min search depth

Selecting the adjacent vertices based on the depth defined in the graph settings. Click table23_img1 to select a parameter.

Max search depth

Selecting the adjacent vertices based on the depth defined in the graph settings. Editable

Sorting

Automatic size calculation

Automatic definition of how many elements are displayed in a single row. Click table23_img1 to select a parameter.

Number of vertices in a row

Sorting always forms a rectangle. This parameter allows you to set the number of vertices in a row. Editable

Row orientation

This allows you to set the row orientation. Click table23_img1 to select a parameter.

Split by type

This allows you to sort by type when sorting vertices of different types. Click table23_img1 to select a parameter.

Text

Show line before text

This allows you to set the visualization for the line before the text. Click table23_img1 to select a parameter.

Show frame

This allows you to set the frame visualization. Click table23_img1 to select a parameter.

Show text

This allows you to set the visualization for the text. Click table23_img1 to select a parameter.

Link color

Use gradient paint for links

Click table23_img1 to select a parameter.

Link ending color

Drop-down list of parameters allowing you to set the link ending color. Click the table23_img1 button to configure the parameters.

Link beginning color

Drop-down list of parameters allowing you to set the link beginning color. Click the table23_img1 button to configure the parameters.


4.3.3.3 Configurable visual parameters for a vertex

When necessary, the Application allows you to configure visual parameters for the following kinds of vertices:

  • Dummy vertices. See Table 22 for the configurable visual parameters of a dummy vertex available in the Properties window.

  • Vertices based on instances. See Table 25.for the configurable visual parameters for a Instance vertex available in the Properties window.

  • Vertices based on binary data. See Table 24 for the configurable visual parameters for a binary data vertex available in the Properties window.

  • Group vertex. See Table 26 for the configurable visual parameters for a group vertex available in the Properties window.

Table 24. Configurable visual parameters for a dummy vertex

Parameter group

Parameter

Purpose

View

Image

Selecting a picture to represent a graph vertex on a schema. Click table24_img1 to configure the parameter. See section 4.3.7.3 for a description of the image editing

Line type

Selecting the framing line type. This parameter modifies the line type if the picture framing is defined. Click table24_img1 to select a parameter.

Line thickness

Selecting the framing line thickness. This parameter modifies the line thickness if the picture framing is defined. Click table24_img1 to select a parameter.

Representation

The way to visualize a vertex and its caption. Click the button to select a parameter. Possible representations:

  • Ring. The vertex caption in a circle becomes a part of a vertex.

  • Event. It allows you to display event data.

  • Frame. This representation visualizes the text without a picture.

  • Theme line. It allows you to display a linear sequence of events that represents a timeline of those events

Framing

This allows you to set a picture frame. Click table24_img1 to select a parameter.

Shape

This allows you to set the shape for framing. Drop-down list for setting the vertex coordinates. Editables

Time axis

Locked on axis

Click table24_img1 to select a parameter.

Date and time

This visualizes the representation of an event. By default, the value for the first-time object attribute is used. The value is selected from the calendar. Click table24_img1 to select a parameter.

Other

Tree root

This parameter allows you to change the layout from the tree root when any vertex is set to be this tree root. Click table24_img1 to select a parameter.

Lock

Click table24_img1 to select a parameter.

Hide

Click table24_img1 to select a parameter.

Text

Show text

This allows you to show or hide text. Click table24_img1 to select a parameter.

Font

Drop-down list for setting the font for the vertex caption. Click table24_img1 to select font parameters.

Text color

Drop-down list for setting the color for the vertex caption text. Click table24_img1 to select color parameters.

Background color

Drop-down list for setting the background color for the vertex caption. For vertices in the form of a frame or event, the color of the vertex itself is modified. Click on table24_img1 to select background color parameters.

Show frame

Click table24_img1 to select a parameter.

Frame color

Drop-down list for setting the frame color. Click table24_img1 to select color parameters.

Show line before text

Displaying a line from the vertex to the text. Click table24_img1 to select a parameter.

Fill color

Source

Background color for a group type vertex. Click table24_img1 to select a parameter.

Custom

Drop-down list for setting the color. Click table24_img1 to select color parameters.

Random

Drop-down list for setting the color. Click table24_img1 to select color parameters.

Current

Drop-down list for setting the color. Click table24_img1 to select color parameters.

Line color

Source

The line color can be seen only if the framing is drawn for a vertex. Click table24_img1 to select a parameter.

Custom

Drop-down list for setting the color. Click table24_img1 to select color parameters.

Random

Drop-down list for setting the color. Click table24_img1 to select color parameters.

Current

Drop-down list for setting the color. Click table24_img1 to select color parameters.

The configurable visual parameters for an instance vertex include all the parameters for a dummy vertex (Table 24). Instance vertices have additional visual parameters specified in Table 25.

Table 25. Additional configurable visual parameters for the instance vertex

Parameter group

Parameter

Purpose

Other

Own visual parameters

Click table25_img1 to select a parameter.

Configurable visual parameters of a binary data vertex include all the parameters of a dummy vertex (Table 24).
Configurable visual parameters for a group vertex include all the parameters of a dummy vertex (Table 24). Group vertices have additional visual parameters specified in Table 26.

Table 26. Additional configurable visual parameters for the group vertex

Parameter group

Parameter

Purpose

View

Representation

The way to visualize a vertex and its caption. Click the table26_img1 button to select a parameter. Additional representations:

  • Polygon. It visualizes a vertex as a circumscribing rectangle of its component items.

  • Rectangle. Circumscribing a rectangle with a caption.

Other

Group

When grouping is performed, the item links lead to the group as a whole, rather than to the items contained in it. Click table26_img1 to select a parameter.

Text visualization mode

The following modes are accessible:

  • Default. Show text.

  • Quantity. This shows the text and the quantity of items in a group.

  • Combination. It shows text and values of all attributes of the group's child vertices.

Click table26_img1 to select a parameter.

Fill color

Source

By default, a random color is used for the fill for the group vertex. Click table26_img1 to select a parameter.


4.3.3.4 Configurable visual parameters for graphic primitives

See Table 27 for the configurable visual parameters of the graphic primitives that can be accessed in the Properties window.

Table 27. Configurable visual parameters for graphic primitives

Parameter group

Parameter

Purpose

Coordinates

X coordinate

Editable. This allows you to accurately define the location of a graphic primitive on a schema relative to the X axis

Y coordinate

Editable. This allows you to accurately define the location of a graphic primitive on a schema relative to the Y axis

Z coordinate

Editable. This allows you to accurately define the location of a graphic primitive on a schema relative to the Z axis

Settings

Displayed parts

Drop-down list of parameters that allow defining what parts of a graphic primitive are visualized. List of graphic primitive parts:

  • Border

  • Background

  • Text

  • Aura

  • Glow

  • Profile

Click the table27_img1 button to configure the parameters.

Border

Drop-down list of parameters allowing you to configure the following visualization:

  • Thickness. Editable.

  • Style. Click on table27_img1 to configure the parameter.

When the Solid style is selected:

  • Color. Drop-down list of parameters allowing you to set the border color. Click the table27_img1 button to configure the parameters.

When the Gradient style is selected:

  • Color. Two similar drop-down lists of parameters that allow you to set the border colors. Click the table27_img1 button to configure the parameters.

  • Gradient direction. Drop-down list for selecting the gradient direction. Click on to make the selection.

Background

Drop-down list of parameters allowing you to set the background color. Click the table27_img1 button to configure the parameters.

Text

Drop-down list of parameters allowing you to configure the following text visualization:

  • Font. Click table27_img1 to configure the parameter.

  • Alignment. Click table27_img1 to configure the parameter.

  • Margins. Drop-down list of margins. Editable fields.

  • Color. Drop-down list of parameters allowing you to set the text color. Click the table27_img1 button to configure the parameters.

Sizes

Width

Editable

Height

Editable

Depth

Editable


4.3.3.6 Configurable visual parameters for nodes

Table 29. Configurable visual parameters for nodes

Parameter group

Parameter

Purpose

Coordinates

X coordinate

The ability to set the X axis coordinate

Y coordinate

The ability to set the Y axis coordinate

Z coordinate

The ability to set the Z axis coordinate



4.3.4 Creating a data-based schema

To create a data-based schema, follow these steps:

  1. Open a data table.

Note.

  1. The operation to create a schema can be accessed when the function to enable a graph on a schema is enabled for the table data.

  2. If the function to enable a graph on a schema is disabled for the table data, then configure the visualization for the table data on the schema. See sections 4.2.3-4.2.4 for how to configure the visualization of table data on a schema.

  1. In the Main menu, select Table → Schema. The (creation or visualization) template selection context menu appears.

  2. In the context menu, select a schema visualization template and click on its name. A graph is built on the schema based on the table data (Figure 91). Use the mouse wheel to zoom in toward (or out away from) the graph. To move the graph, press and hold the right mouse button and then drag the graph to the required location.

Figure 91

Figure 91. Graph built using the table data

Note. A graph may be based on the data for the entire table or on selected or filtered strings in the table.



4.3.5 Creating a schema manually

To create a schema manually, follow these steps:

  1. In the Main menu, select File → New schema. An empty schema is opened.

  2. Next, add three vertices, for example. See section 4.3.6 (Figure 92) for a description of the vertices that can be added on a schema.

Figure 92

Figure 92. Vertices added to the schema

  1. In the Properties window, select vertex representation (for example, Event) for all the three vertices.

  2. In the sidebar in the schema window, click Button 5. Draw links between the three vertices (Figure 93)

Figure 93

Figure 93. Creating a link between vertices

Note. You can manually create a graph with any quantity of vertices. Also, you can create links between vertices, as well as modify the properties of vertices and links.



4.3.6 Creating a vertex on a schema

The following kinds of vertices can be used on a schema:

  • Vertices based on instances.

  • Dummy vertices not tied to instances.

  • Vertices based on binary data.

4.3.6.1 Creating a dummy vertex

To create a dummy vertex, follow these steps:

  1. Open a schema.

  2. In the main menu, select Graph → Add dummy vertex. A dummy vertex is added to the schema (Figure 94).

Figure 94

Figure 94. A dummy vertex on a schema

Note.

  1. Dummy vertices are not displayed in the Instances window.

  2. If you create a link from a dummy vertex to an instance vertex, or from an instance vertex to a dummy vertex, this link would be a dummy one.

  3. A dummy vertex can be copied on a schema an unlimited quantity of times.


4.3.6.2 Creating a vertex based on an instance

To create a vertex based on binary data, follow these steps:

  1. Open a schema.

  2. Open the Instances window.

  3. In the Instances window, click on one of the instances and drag it onto the schema. An instance vertex is created.

Note. Each object type instance can be visualized on a single schema only once. However, the same instance can be visualized on unlimited quantity of schemas.


4.3.6.3 Creating a vertex using binary data

To create a vertex based on binary data, follow these steps:

  1. Open a schema.

  2. Create an instance based vertex in the schema. See section 4.3.6.2 for the procedure on creating a vertex based on an instance.

  3. Right-click on the instance vertex. Context menu opens.

  4. In the context menu, select Attach binary data. A file choice window on the user's PC will open.

  5. Select a file on the user's PC. Click Open. A vertex with binary data is created (Figure 95). Also, a dummy link from the binary vertex to the instance vertex is created.

Figure 95

Figure 95. Vertex with binary data

Note.

  1. Binary data to be attached may be in any format.

  2. The added file becomes a part of the investigation.

  3. Binary vertices can be attached to instance vertices only.


4.3.6.4 Creating a group vertex

To create a group vertex, follow these steps:

  1. Open a schema.

  2. Create an instance based vertex in the schema. See section 4.3.6.2 for the procedure on creating a vertex based on an instance.

  3. Right-click on the instance vertex. Context menu opens.

  4. In the context menu, select Add to new group. A new group is created (Figure 96).

Figure 96

Figure 96. Group vertex

To add an instance vertex to an existing group, follow these steps:

  1. Perform steps 1-3.

  2. In the context menu, select Add to group. The Select groups window opens (Figure 97).

Figure 97

Figure 97. Selecting a group for adding an instance vertex

  1. In the Select groups window, select a group and click OK. The selected instance vertex is added to the group.



4.3.7 Viewing and editing schema properties

4.3.7.1 Using the Properties window to define the visual parameters for an instance
By setting the visual parameters for an instance via the Properties window, you can define how it is visualized on a schema. Edits made in the Properties window do not change the instance itself.
To change the visualization of an instance, follow these steps:
  1. In the Main menu, select Windows → Properties. The Properties window opens

  2. Open a schema. For the description of how to work with a schema, see section 4.3.

  3. In the schema window, click on an instance. The instance is selected. The Properties window shows the parameters for the selected instance type (Figure 98).

Figure 98

Figure 98. Configurable instance parameters

Note. Each instance type has its own set of editable parameters.

  1. Modify the required parameters. For example:

    1. In the Properties window, in the Image field, click on Button 25. The Pictures window is opened (Figure 99).

    Figure 99

    Figure 99. Selecting an image for an instance

    1. In the Picture window, open any tab. For example, select the Flags tab. Next, click on any flag.

    2. In the Picture window, click OK. The visualization of the selected instance is changed (Figure 100).

    Figure 100

    Figure 100. Changed visualization of the instance on the schema

    1. Follow the same procedure to modify any other parameters for an instance visualization.


4.3.7.2 Using the Instance window to define visual parameters of an instance
By setting the visual parameters of an instance via the Properties window, you can define how it is visualized on a schema. When you change an instance via the Instances window, you set the default values used to define the appearance of a vertex on new schemas.
To change the visualization of an instance via the Instances window, follow these steps:
  1. In the Main menu, select Windows → Instances. The Instances window opens.

  2. Open a schema. For the description of how to work with a schema, see section 4.3.

  3. In the Instances window, right-click on an instance. The context menu opens (Figure 101).

Figure 101

Figure 101. Changing instance properties

  1. In the context menu, select Properties. The Properties window opens (Figure 102).

Figure 102

Figure 102. Properties window

  1. Configure the visualization of the instance on the schema. See Table 30 for the configurable parameters for an instance that can be accessed in the Properties window.

  2. When you have changed the visualization parameters in the Properties window, click on Close. In the Instances window, the instance with the modified parameters is displayed (Figure 103). When moved to a schema, the instance is displayed with the changes you made.

Figure 103

Figure 103. Instance with modified visualization parameters

See Table 30 for the configurable visual parameters for instances that can be accessed in the Instances window.

Table 30. Configurable visual parameters of instances in the Instances window

Parameter group

Parameter

Purpose

General tab

General

Picture

Selecting instance visualization on a schema. Click table30_img1 to select a picture.

Text color

Drop-down list of parameters that allow you to set the instance caption text color. Click the table30_img2 button to configure the parameters.

Font

Defining the instance caption font

Line color

Source

Click table30_img2 to select a parameter.

Custom

The setting is a drop-down list of parameters that allow you to configure the color for an instance. Click the table30_img2 button to configure the parameters.

Item color

Source

Click table30_img2 to select a parameter.

Custom

The setting is a drop-down list of parameters that allow you to configure the color for an item. Click the table30_img2 button to configure the parameters.

Graph-Vertex

View

Representation

Drop-down list for selecting how an instance is represented on a schema

Line type

Click on table30_img2 to select a line type.

Line thickness

Editable

Framing

Click the table30_img2 button to select a framing.

Other

Hide

Click table30_img2 to select a parameter.

Lock

Click table30_img2 to select a parameter.

Tree root

Click table30_img2 to select a parameter.

Text

Show text

Displaying the instance caption text. Click table30_img2 to select a parameter.

Background color

Drop-down list of parameters that allows you to set the instance for the background color. Click the table30_img2 button to configure the parameters.

Show frame

Click table30_img2 to select a parameter.

Frame color

Drop-down list of parameters that allow you to set the instance for the frame color. Click the table30_img2 button to configure the parameters.

Show line before text

Click table30_img2 to select a parameter.

Depth

Editable

Accuracy

Editable


4.3.7.3 Editing the graph vertex image

Option 1. Changing the image using the Properties window.

To edit a graph vertex image, follow these steps:

  1. Open a schema with a graph.

  2. Open the Properties window.

  3. Right-click on a vertex. The vertex is selected.

  4. In the Properties window, in the View group of parameters, select the Image parameter and click Button 26 (Figure 104). The Picture window is opened (Figure 105).

Figure 104

Figure 104. Changing a graph vertex image

Figure 105

Figure 105. List of icons

  1. Select an image for the graph vertex:

    1. To select an image on the user's PC, in the Picture window, open the Custom tab and click on Button 27. A file choice window on the user's PC will open. Select a file and in the Picture window click OK.

    2. To select an image in the Picture window, open one of the following tabs: Attributes, Objects, Links, Decoration, Content, Flags, then click on one of the pictures. The picture is selected. Next, in the Picture window click OK.

Option 2. Changing the image using the Pictures window.

To edit a graph vertex image, follow these steps:

  1. Open a schema with a graph.

  2. In the Windows tab, open the Pictures (Figure 106).

Figure 106

Figure 106. Pictures window

  1. In the Pictures window, use the scroll bar to view all possible pictures, select the one you needed, click it, and drag it onto the graph vertex. The picture of the graph vertex changes to the one you selected (Figure 107).

Figure 107

Figure 107. Changing a graph vertex image


4.3.7.4 Editing the graph vertex caption

To edit a graph vertex caption, follow these steps:

Option 1. Simple text editing.

  1. Open a schema with a graph.

  2. Right-click a vertex. The vertex is selected.

  3. Press F2. The vertex caption text becomes editable.

Option 2. Advanced text editing.

  1. Open a schema with a graph.

  2. Select and then right-click the caption of a vertex or a group of vertices. Context menu opens.

  3. In the context menu, select Edit. The Caption editor window opens, providing you with three options for editing text (Figure 108):

    • Simplified. In this mode you can type in text.

    • Default. This mode allows you to configure the visualization for each caption line individually. Each line in a caption is an attribute for an item.

Figure 108

Figure 108. Caption editor window, Default mode

  1. In the Caption editor window, set the required values and click on Create. The changes are saved. Click OK. The caption text is modified.

Option 3. Editing text using the Caption window.

  1. Open a schema with a graph.

  2. Right-click a vertex. The vertex is selected.

  3. In the Caption window context menu, define the required text parameters (Figure 109). See section 6.1 for a description of the Caption window menu items.

Figure 109

Figure 109. The Caption window

  1. The caption text is modified.



4.3.8 Removing data from a schema

Note. If you remove an instance with defined incoming and outgoing links, these links are removed together with the instance.

4.3.8.1 Removing data from a schema
When you remove data from a schema, the objects and links are deleted from this schema.
To remove data from a schema, follow these steps:
  1. Open a schema. For the description of how to work with a schema, see section 4.3.

  2. Click on a schema object. The object is selected. To select multiple objects, press and hold the left mouse button, then select multiple objects and/or links on the schema (Figure 110).

Figure 110

Figure 110. Selecting objects on a schema

  1. Press Delete. The selected objects and/or links are removed.


4.3.8.2 Removing an Instance from an Investigation
When you delete an instance via the Instances window, it is removed from all the schemas created within this investigation.
To delete instances, follow these steps:
  1. Open a schema. For the description of how to work with a schema, see section 4.3.

  2. In the Main menu, select Windows → Instances. The Instances window opens.

  3. To see the vertex a particular instance belongs to, click the Show in investigation button Button 28 in the sidebar of the schema window or the Main menu (Figure 111).

Figure 111

Figure 111. Mapping between an instance and a vertex

  1. In the Instances window, select one or more instances and click Button 9 in the Instances window menu. The instances selected are removed from the investigation.


4.3.9 Operations with graphic primitives

4.3.9.1 Adding graphic primitives

To add a graphic primitive to a schema, follow these steps:

  1. In the Main menu, select File → New schema or select a schema with a built graph. A schema is opened.

  2. In the Main menu, select Schema → Add rectangle or Add text (Figure 113).

    1. If you selected Add rectangle, a rectangle appears on the schema.

    2. If you selected Add text, the text entry window opens (Figure 114).

    3. Type text in the text entry window and click anywhere within the schema. The selected graphic primitive with the added text appears on the schema (Figure 115).

Figure 113

Figure 113. Selecting a graphic primitive via the Main menu

Figure 114

Figure 114. Text entry window

Figure 115

Figure 115. Add text graphic primitive


4.3.9.2 Editing graphic primitive text

To edit the text of a graphic primitive, follow these steps:

  1. Open a schema that contains a graphic primitive.

  2. Right-click on the graphic primitive. Context menu opens (Figure 116).

Figure 116

Figure 116. Context menu for a graphic primitive

  1. In the context menu that appears, click Properties. The Properties window opens (Figure 117).

Figure 117

Figure 117. Editing graphic primitive text

  1. Edit the text and modify settings for displaying the text on the schema.

  2. Click Close. The text of the graphic primitive is modified.


4.3.9.3 Binding a graphic primitive to graph items

To bind a graphic primitive to graph items, follow these steps:

  1. Open a schema with a graph.

  2. Add a graphic primitive to the schema. See section 4.3.9.1 for the procedure on adding graphic primitives to a schema.

  3. Press and hold Ctrl, then click a graphic primitive and a graph item. The graph item and graphic primitive are selected.

  4. In the Main menu select Schema → Create binding. When the graph item is moved, the graphic primitive moves together with it. However, you can also move the graphic primitive itself in relation to the graph Item.


4.3.9.4 Removing the binding between a graphic primitive and a graph item

To remove binding between a graphic primitive and a graph item, follow these steps:

  1. Open a schema that contains a graphic primitive bound to a graph item.

  2. Press and hold Ctrl, then click a graphic primitive and a graph item. The graph item and graphic primitive are selected.

  3. In the Main menu, select Schema → Delete binding. The binding is deleted.




4.4 Working with GIS maps

4.4.1 Description of GIS maps

A GIS map is a geographical information map that allows you to analyze data by displaying the locations of objects and their movements.
Basic items of a GIS map:
  • Object.

  • Path.

  • Point. Heatmap item.

A GIS map can be created using data in a table, provided it contains at least one of the following geo attributes:

  • GeoJSON (a point, polyline or polygon).

  • Coordinates (longitude, latitude).

The following layer types can be viewed on a GIS map:

  • GIS objects. This layer contains objects that have one of any kind of geo-attribute, and there is nothing preventing placing this object onto this layer type.

  • Heatmap. This layer contains objects that have the Point item and there is nothing preventing placing this object onto this layer type.

  • Path. A path is a sequence of object movements. This layer contains objects that have the Point attribute as well as the grouping and sorting attribute.

  • Shapes. The system layer. The user cannot edit this layer.



4.4.2 Tools for working with GIS maps

4.4.2.1 GIS menu items

Items of the map window sidebar are the same as the items of the GIS main menu (Figure 118).

Figure 118

Figure 118. Items in the map sidebar and GIS main menu

The map items are described in Table 31.

Table 31. Items of the map window sidebar

Item

Purpose

Buttons for the map window sidebar

table31_img1

Create a schema

table31_img2

Creating a GIS Map

table31_img3

Drop-down menu for adding a value

table31_img4

Drop-down menu for removing a value

table31_img5

Show in investigation

table31_img6

Scale down

table31_img7

Scale up

table31_img8

Reviewing all the objects present on the map

table31_img9

Add tag to map

table31_img10

Save

table31_img11

Delete active objects from map

table31_img12

Delete inactive objects from map

table31_img13

Object selection mode.

table31_img14

Ruler tool. It is used to measure distances between objects

table31_img15

Ring tool. This allows you to draw rings

table31_img16

Rectangle tool. This allows you to draw rectangles

table31_img17

Polygon tool. This allows you to draw arbitrary shapes

table31_img18

Go to layer. To access this operation, you need to create a layer first. Objects that are contained on the selected layer are displayed

table31_img19

Load shapes. Loads a shape of arbitrary form from a .kmz or .kml file

table31_img20

Save shapes. Saves a shape of arbitrary form into a .kmz or .kml file or into an investigation (the shape is added as a layer)

table31_img21

Create an aggregate layer. Creates a layer with instances on a map

table31_img22

Create a table based aggregate layer. Creates a layer with table data containing geo attributes on a map

table31_img23

Subrequests to selected objects bound to subject area. The list of operations changes depending on the subject area. For example, you can perform the following operations:

  • Show neighboring objects

  • Hide neighboring objects

  • Group objects by distance

  • Show coverage

  • Show coverage looking to the North

  • Show coverage looking to the East

  • Show coverage looking to the South

  • Show coverage looking to the West

  • Hide coverage

  • Hide coverage looking to the North

  • Hide coverage looking to the East

  • Hide coverage looking to the South

  • Hide coverage looking to the West


4.4.2.2 Map context menu items

To open the object context menu, follow these steps:

  1. Open GIS map.

  2. Right-click anywhere on a map. The map context click menu with the following operations appears (Figure 120):

    • Scale down. This allows you to scale down the map.

    • Normalize scale. This allows you to normalize the map scale.

    • Scale up. This allows you to scale up the map.

    • Show all objects. This allows you to show all objects of the map.

    • Base stations.

    • In rectangle (in radius/in polygon).

    • Closest to point.

    • Looking on point.

    • Move to requests.

Figure 119

Figure 119. Map context menu


4.4.2.3 Object context menu items

To open the object context menu, follow these steps:

  1. Open GIS map.

  2. Check the GIS objects for the layer.

  3. Right-click on the object. The object context menu with the following operations appears (Figure 120):

    • Show in investigation. This allows you to select an object in any opened window that contains this object (for example, in the Explorer window).

    • Show captions. This allows you to show object captions.

    • Hide captions. This allows you to hide object captions.

    • Group. It allows you to group objects.

    • Move to requests. You can go to requests.

Figure 120

Figure 120. Object context menu



4.4.3 Properties window

4.4.3.1 Customizable visual map parameters

Open GIS map. If there are no highlighted objects on the map, the map parameters are displayed in the Properties window.

Customizable visual map parameters in Properties window are shown in table 32.

Table 32. Customizable visual schema parameters

Parameter group

Parameter

Purpose

View

Tile source

Click the table32_img1 button to select a parameter.

Combine shapes

Choose shape clustering mode. Click the table32_img1 button to select a parameter.

Scale

Changes the map scale.

Center

Sets the map center coordinates. Editable

Show center

Click the table32_img1 button to select a parameter.

Color mode

Changes the color mode of the map. Click table32_img1 to select a parameter.

General

Title

File name

Action parameters

Maximum distance between adjacent elements (in m)

Editable

Show/hide objects in distance, m

Editable

Maximum period between adjacent elements (time)

Editable


4.4.3.2 Customizable visual object parameters

Customizable visual object parameters in the Properties window are shown in table 33.

Table 33. Configurable visual parameters for an object

Parameter group

Parameter

Purpose

View

Point representation

Select point representation. You may choose one of the following representations:

  • Ring

  • Square

  • Double square

  • Triangle

  • Diamond

  • Picture

Click table33_img1 to select a parameter.

Picture

Select and set the size for a picture of the object visualized on the map. Click table33_img1 to select a picture. The picture size (width and height) are editable values

Max picture size

Sets the maximum size of a picture. Editable (width, height)

Representation

Show point

Click table33_img1 to select a parameter.

Show caption

Click table33_img1 to select a parameter.

Show floating picture

Click table33_img1 to select a parameter.


4.4.3.3 Customizable visual path parameters

Open GIS map with set object paths. Customizable visual path parameters in Properties window are shown in Table 34.

Table 34. Customizable visual path parameters

Parameter group

Parameter

Purpose

View

Animate

Option to animate object path. Click table34_img1 to select a parameter.

Step length

Arline length Measured in minutes. Editables

Opacity

Allows setting layer opacity. Click table34_img1 to select a parameter.

Combination deviation

Editables

Show

Hide or show layer. Click table34_img1 to select a parameter.

Show adjacent lines

Representation of lines with or without arlines. Click table34_img1 to select a parameter.

Distance between adjacent lines

Distance between arlines having start and end in the same points. Editables

Color

Drop-down list for selecting color parameters. Click table34_img1 to adjust color components (opacity, red, green, and blue)

Subpaths

Hides or shows subpaths. Click table34_img1 to select a parameter.

Distance between subpaths

Editables

Time interval between subpaths

Editable

General

Layer name

Layer name. Editable

Layer type

Layer type. Non-editable

Filter

Click table34_img1 to select a parameter.


4.4.3.4 Customizable visual point parameters

To customize the point parameters, create a GIS heatmap. Customizable visual point parameters in Properties window are shown in Table 34.

Table 35. Customizable visual point parameters

Parameter group

Parameter

Purpose

View

Opacity

Click table35_img1 to select a parameter.

Show

Click table35_img1 to select a parameter.

Radius

Allows increasing the point combining radius. Editables

Color

Drop-down list for selecting a color. Click on the table35_img1 button to select a parameter.

General

Layer name

Layer name. Non-editable

Layer type

Layer type. Non-editable

Filter

Click table35_img1 to select a parameter.



4.4.4 Creating a GIS map

GIS map is created based on data that have geo-attributes.
To create a GIS map based on the data, follow these steps:
  1. Open a data table.

Note.

  1. If GIS map visualization is set for the table data, you can create a map.

  2. If GIS map visualization is not set for the table data, first you have to set it. Setting the Table data visualization is outlined in sections 4.2.3-4.2.4.

  1. In the Main menu, select Table → GIS Map. A context menu with visualization templates will open.

  2. In this menu, select a GIS map visualization template and click it. A GIS map will be built based on the table data (Figure 121).

Figure 121

Figure 121. GIS map

Note. GIS map may be built based on the whole table data, as well as selected or filtered table strings.



4.4.5 Selecting a visualization layer on a GIS map

To select a visualization layer on a GIS map, follow these steps:

  1. Open GIS map. Creation of GIS maps is outlined in section 4.4.3.4.

  2. In the Main menu, select GIS → GIS Map → Select the type of layer you want to display (Figure 122). You may display the following types of layers:

  • Path.

  • Heatmap.

  • GIS objects.

  • All layers.

Layer visualization examples are shown in Figures 123-126.

Figure 122

Figure 122. Layer types

Figure 123

Figure 123. Heatmap

Figure 124

Figure 124. GIS objects

Figure 126

Figure 125. Path

Figure 126

Figure 126. All layers



4.4.6 Adding a tag to a map

To add a tag to a map, follow these steps:

  1. Open GIS map. Creation of GIS maps is outlined in section 4.4.3.4.

  2. In the map sidebar, click Button 29, then click where you want to place a tag. The tag is added (Figure 127).

Figure 127

Figure 127. Tag on the Map

  1. To change the tag text, click the text and press F2. The text will become available for editing. Change the text as appropriate.

Note. You may move the tag to any location on the map. Additionally, you can change the location of text in relation to the tag itself.





5 Analysis tools

5.1 Overview of analysis tools

The following analysis tools are implemented in the Application:

  • Visual analysis tools:

    • Content window. Content window is a visual analysis tool that allows you working with a schema or a GIS map.

    • Timeline window. Timeline window is a visual analysis tool. It displays the instances of the schema arranged by Date and Time attribute.

    • Cross-modularity.

  • Tools for working with imported files:

    • Filtering. Filtering tool allows linking data in the schema with any of the user’s files.

    • Interpretation. Interpretation tool allows enriching a schema with the data from an imported file.

    • Decoration. Decoration tool allows changing visual parameters of schema items.

    • Expansion. Expansion tool allows adding additional data to the schema in the form of vertices and linking them.




5.2 Visual analysis tools

5.2.1 Viewing and analyzing schema or map contents

5.2.1.1 Content window
Content window is a visual analysis tool that allows you working with a schema or a GIS map.
To start working with Content window, follow these steps:
  1. Open a schema or a GIS map. Operations with schemas are described in section 4.3. Operations with GIS maps are described in section 4.4.

  2. In the Main menu, select Windows → Content. The Content window opens (Figure 128).

Figure 128

Figure 128. Content window


5.2.1.2 Data analysis in the Content window

Content window allows viewing aggregation of instances in schema or GIS map according to any attributes. Content window is built based on the schema or GIS map and contains the data displayed in them.

If no items are highlighted in the schema or GIS map, Content window will display all data. If there are highlighted items in the schema or GIS map, Content window will display all the information on these items. If you select items in Content window, these items will also be selected in the schema or GIS map.

The attributes displayed in Content window depend on the data in the schema or GIS map. For blocks displaying aggregating data, the scale is displayed in blue color. For blocks displaying statistical data, the scale is displayed in green (Figure 129).

Figure 129

Figure 129. Data scale

Actions with data available in Content window are shown in table 36.

Table 36. Actions with data in Content window

Actions

Purpose

Click table36_img1

Opens the item list

Click table36_img2

Closes the item list

Click table36_img3

Sorts the values from higher to lower

Click table36_img4

Sorts the values from lower to higher

Specify the value in table36_img5 field

Customizable parameter for certain attributes. Allows setting the length of a displayed value or its interval

Double-click the left mouse button on the attribute string

All attributes of that string will be highlighted in the schema

Click the left mouse button on multiple attributes while holding Shift on your keyboard.

A quantity of attributes will be highlighted in Content window. These attributes will be highlighted in the schema

Click the group indicator table36_img6 (the number in the center of the indicator specifies the number of groups this object belongs to)

All attributes of the specified group will be displayed on the schema

table36_img7

Setting up the attribute value quantity representation:

  • The numbers show how many attribute values will be displayed of the total quantity.

  • More. Shows a few more strings of attribute values.

  • Less. Hides a few strings of attribute values.

  • Expand. Expands all strings with attribute values.

  • Collapse. Hides the strings with attribute values.


5.2.1.3 Attribute context menu in Content window
The context menu of an attribute may vary based on data for which the context menu is applied.
To open the context menu, follow these steps:
  1. Open a schema.

  2. Open the Content window.

  3. Click the right mouse button on a string with any data of Content window. An attribute context menu will open (Figure 130). The context menu operations may vary depending on the chosen attribute. For example, if you choose a region, the context menu allows the following operations:

    • Show. Highlights all the items in the schema that are selected in Content window.

    • Refine. Filters data, which contains the chosen attribute(s).

    • Show with links. Highlights all the items in the schema with their links for the selected region.

    • Create single group. Groups into one group.

    • Create multiple groups. Groups into a quantity of groups.

    • Create multiple groups by common adjacent vertices. Creates groups by common adjacent vertices.

    • Copy vertices to clipboard. Copies the highlighted vertices to clipboard.

    • Delete. Deletes all the items in the schema that are highlighted in Content window.

Figure 130

Figure 130. Attribute context menu


5.2.1.4 Linking Content and Timeline windows

To analyze the information via both Content and Timeline windows, follow these steps:

  1. Open a schema. Operations with schemas are described in section 4.3.

  2. Open Timeline window. Operations with Timeline window are described in section 5.2.2.1.

  3. Open the Content window. Operations with Content window are described in section 5.2.1.1.

Content Window Actions

Double-click an attribute value in Content window. For example, select an IMEI attribute, value. Timeline window will be rebuilt based on the values highlighted in Content window. Items with values selected in Content window will also be highlighted in the schema (Figure 131).

Figure 131

Figure 131. Linking items of Content and Timeline windows (example 1)

Timeline Window Actions

In Timeline window, select a time interval, Content window will be rebuilt based on data selected in Timeline window. These items will be highlighted in the schema (Figure 132).

Figure 132

Figure 132. Linking items of Content and Timeline windows (example 2)



5.2.2 Timeline analysis

5.2.2.1 Timeline window
Timeline window is a visual analysis tool. It displays the instances of the schema arranged by Date and Time attribute.
To start working with Timeline window, follow these steps:
  1. Open a schema. Operations with schemas are described in section 4.3.

  2. In the Main menu, select Windows → Timeline. Timeline window will open (Figure 133).

Figure 133

Figure 133. Timeline Window

Timeline window items are described in Table 37.

Table 37. Timeline Window Items

Item

Purpose

table37_img1

Shows the schema items highlighted in Timeline window.

table37_img2

Clears the filter. The whole schema is displayed in Timeline window


5.2.2.2 Data analysis in Timeline window

Timeline window allows viewing aggregation for a specified time interval. The links visualized in the schema have the Date and Time attribute. Timeline window displays the timeline of schema links. The user is able to view the time intervals and the quantity of links set in these intervals.

Timed data distribution is shown in the bottom part of the window. Detailed information about the data in the interval highlighted in the bottom part of the window is displayed in the top part of the window.

If no links are selected in the schema, Timeline window will display all links. If there are highlighted links in the schema, Timeline window shows the information on these links.

The axes steps are determined automatically and cannot be adjusted. For example, if the step is determined as day in the bottom part, it will be determined as hour in the top part, and hourly distribution within each day highlighted in the lower axis will be displayed (Figure 134). If the step is determined as year in the bottom part, it will be determined as day in the top part, and daily distribution within each year highlighted in the lower axis will be displayed.

Figure 135

Figure 134. Data representation on the axes of the Timeline window

If you select an interval in the Timeline window and click Button 30, the items falling into this interval will be selected in the schema (Figure 135).

Figure 135

Figure 135. Highlighting schema items according to the set interval



5.2.3 Cross-modularity

Cross-modularity is an interaction between visualization modules by selecting dependent objects.
Visualization modules, such as graph, GIS map, table, any analytical module, for example, Content window, Timeline window, etc., support cross-modularity, which ensures their interaction by selecting objects.

For example, if an object on a graph is selected, data are rebuilt in all opened windows providing visualization (Figure 136).

Figure 136

Figure 136. Application of cross-modularity

Note. If not all items according to the user condition fall into group link, it is drawn in dull red color. If all items according to the user condition fall into group link, it is drawn in red color.




5.3 Tools for working with imported files

5.3.1 Tools window

Tools for working with imported files are available in Tools window. Tools window shows the tools according to the data visualized in the schema. For example, if the schema is empty, all the tools in Tools window are disabled.
To start working with Tools window, follow these steps:
  1. Open a schema. Operations with schemas are described in section 4.3.

  2. In the Main menu, select Windows → Tools. Tools window will open (Figure 137).

Figure 137

Figure 137. Tools window

Tools window contains:

  • Search field to search the data in the window.

  • Filtering tool. The tool description is given in section 5.3.2.

  • Interpretation tool. The tool description is given in section 5.3.3.

  • Decoration tool. The tool description is given in section 5.3.4.

  • Expansion tool. The tool description is given in section 5.3.5.



5.3.2 Filtering

The filtering tool allows data in the GIS map (schema) to be linked with any of the user’s files. The tool performs search in the column of a file added to Application by the user.
To apply Filtering tool, follow these steps:
  1. Import a data file into the Application (Figure 138). The imported file will be displayed in the Import window. Import description is given in section 3.1.

Figure 138

Figure 138. Imported file

  1. Setup the mapping by specifying how the columns of the imported file are linked with the data. Setting up mapping for filter creation is described in section 5.3.6.1.

  2. Open the GIS map (schema).

  3. Open Tools window.

  4. In Tools window, right-click the created filter that was created in step 2. Context menu opens (Figure 139).

Figure 139

Figure 139. Filter context menu. Applying the filter data

  1. Select Show operation in the filter context menu. The items of the file, on the basis of which the filter was created, will be highlighted on the schema.



5.3.3 Interpretation

Interpretation tool allows enriching a schema with the data from an imported file.
To add data from an imported file, follow these steps:
  1. Import a data file into the Application (Figure 138). The imported file will be displayed in the Import window. Import description is given in section 3.1.

  2. Setup the mapping by specifying how the columns of the imported file are linked with the data. Setting up mapping for combining data is described in section 5.3.6.2.

  3. Open a schema.

  4. Open Tools window.

  5. In Tools window, right-click the created filter that was created in step 2. Context menu opens (Figure 140).

Figure 140

Figure 140. Filter context menu

  1. Select Interpret option in the filter context menu. Duration attribute will be added in the schema of the items specified in the table (Figure 141).

Figure 141

Figure 141. Displaying the added attribute



5.3.4 Decoration

Decoration tool allows changing visual parameters of schema items.
To Decoration schema items, follow these steps:
  1. Import a data file into the Application (Figure 138). The imported file will be displayed in the Import window. Import description is given in section 3.1.

  2. Setup the mapping by specifying how the columns of the imported file are linked with the data and selecting decoration. Setting up mapping for decoration is described in sections 5.3.6.3-5.3.6.4.

  3. Open a schema.

  4. Open Tools window.

  5. In Tools window, right-click the created filter that was created in step 2. Context menu opens (Figure 142).

Figure 142

Figure 142. Filter context menu

  1. Select Decorate operation in the filter context menu. The items specified in the table will be decorated in the schema (Figure 143).

Figure 143

Figure 143. Visualizing a decorated object



5.3.5 Expansion

Expansion tool allows adding additional data to the schema in the form of vertices and linking them.
To add new vertices to the schema, follow these steps:
  1. Import a file, (Figure 138) the data of which is required to be displayed in the form of vertices in the schema, to the Application. The imported file will be displayed in the Import window. The import process is described in section 3.1.

  2. Double-click the imported file to view it (Figure 144).

Figure 144

Figure 144. Viewing imported file data

  1. Setup the mapping for the type of link that is supposed to appear in the schema. Setting up mapping for links is described in section 5.3.6.5.

  2. Open a schema.

  3. Open Tools window.

  4. In Tools window, right-click the created filter that was created in step 3. Context menu opens (Figure 145).

Figure 145

Figure 145. Filter context menu

  1. Select Expansion operation in the filter context menu. Graph vertices with links will be created in the schema (Figure 146).

Figure 146

Figure 146. Graph vertices and links were created



5.3.6 Setting up tools for imported files

5.3.6.1 Setting up mapping for filtering
Setting up mapping is done via Mapping configuration window.
To set up the mapping for filtering, follow these steps:
  1. Import a data file into the Application (Figure 138). The imported file will be displayed in the Import window. The import process is described in section 3.1.

  2. Click the added file. The file will be selected.

  3. In the Import window, click Button 24. A context menu with an attribute list will open (Figure 147).

Figure 147

Figure 147. Add Mapping button context menu

  1. Choose the variant by which the data are displayed in the current schema. For example, select Phone object. Mapping configuration window will open.

  2. In the Mapping configuration window, link the attributes of the Phone object with the columns of the imported file (Figure 148).

    • In the Phone number string, choose the Number column.

    • In the Phone number string, choose the Key type.

    • In the Name field, type the name of the created mapping.

Figure 148

Figure 148. Mapping configuration window

Note. To create a filter, you must specify a key attribute. You may specify two key attributes for data search in the schema by two attributes.

  1. In the Mapping configuration window, click OK. The mapping will be created.

  2. Open a schema and the Tools window. In the Tools window, the Phone filter will appear (Figure 149) specifying the imported file based on which this filter works. The created filter allows searching data in the schema based on data in the loaded file.

Figure 149

Figure 149. Viewing a created filter


5.3.6.2 Mapping configuration to enrich the current schema with new data
Setting up mapping is done via Mapping configuration window.
To set up mapping for enriching the current schema with new data, follow these steps:
  1. Import a data file into the Application (Figure 138). The imported file will be displayed in the Import window. Import description is given in section 3.1.

  2. Click the added file. The file will be selected.

  3. In Import window, click Button 24. A context menu with an attribute list will open (Figure 147).

  4. Choose the object, data of which are displayed in the current schema. For example, select Phone object. Mapping configuration window will open.

  5. In the Mapping configuration window, link Phone object attributes with the schema data (Figure 150).

    • In the Phone number string, choose the Number column.

    • In the Phone number string, choose the Key type.

    • In the Duration string, choose the Duration.

    • In the Duration string, choose the Extractable type. This means that the Duration attribute will be extracted from the table.

    • In the Name field, type the name of the created mapping.

Figure 150

Figure 150. Mapping configuration

Note.

  1. The attribute based on which table search will be conducted is considered key.

  2. The attribute based on which data will be extracted from the table is considered extractable.

  1. In the Mapping configuration window, click OK. The mapping will be created.

  2. Open a schema and Tools window. In Tools window, the Call event filter will appear (Figure 151) specifying the imported file based on which this filter works. The created filter allows:

    • applying filter to a schema;

    • enriching the current schema with data from the imported file.

Figure 151

Figure 151. Created filter


5.3.6.3 Mapping configuration for manual decoration of schema items
Mapping configuration for manual decorating is done via Mapping configuration window. In case of manual decorating, the same picture is set for all vertices.
To set up the mapping for manual decoration of schema items, follow these steps:
  1. Import a data file into the Application (Figure 138). The imported file will be displayed in the Import window. Import description is given in section 3.1.

  2. Click the added file. The file will be selected.

  3. In the Import window, click Button 24. A context menu with an attribute list will open (Figure 147).

  4. Choose the object, data of which are displayed in the current schema. For example, select Phone object. Mapping configuration window will open.

  5. In the Mapping configuration window, link the Phone object attributes with the schema data (Figure 150).

    • In Number string, specify Number A column.

    • In Number string, specify Key type.

    • In Decoration field, select Manual.

    • In the Name field, type the name of the created mapping.

    Additional area for decoration parameter choice will appear (Figure 153).

  6. Click the white square The Open window opens to choose a file on the user’s PC (Figure 152).

Figure 152

Figure 152. Selecting image for decoration

  1. In the Open window, click the required image. The image will be selected.

  2. In the Open window click Open. The image will be displayed in the Mapping configuration window.

  3. In the Mapping configuration window, click the color selection button and select the required color (Figure 153).

Figure 153

Figure 153. Decoration parameters filled

  1. Type in the required text in the text field.

  2. In the Mapping configuration window, click OK. The created decoration will be displayed in the Tools window.


5.3.6.4 Mapping configuration for decoration of schema items based on data file
Mapping configuration for decoration of schema items based on data file is performed via the Mapping configuration window. When decorating based on file, different pictures may be set for all vertices.
You can set the following when decorating:
  • Change the picture of a graph vertex.

  • Change the color of a graph vertex.

  • Add a graph vertex caption.

Depending on the file data, based on which decorating is done, you may apply one, two, or all three actions to a schema.
To set up the mapping for decoration of schema items based on file, follow these steps:
  1. Import a decoration data file into the Application (Figure 154). The imported file will be displayed in the Import window. Import description is given in section 3.1.

Figure 154

Figure 154. Decoration data file

  1. Click the added file. The file will be selected.

  2. In the Import window, click Button 24. A context menu with an attribute list will open (Figure 147).

  3. Choose the object, data of which are displayed in the current schema. For example, select Phone object. Mapping configuration window will open.

  4. In the Mapping configuration window, link Phone object attributes with the schema data (Figure 150).

    • In Number string, specify Number A column.

    • In Number string, specify Key type.

    • In Decoration field, select Table.

    • In the Name field, type the name of the created mapping.

    An additional area for setting decoration parameters will appear (Figure 155), where you need to specify a table column with the corresponding visual representation.

Figure 155

Figure 155. Decoration parameters

  1. In Picture field, select Picture path.

  2. In the Mapping configuration window, click OK. The decoration created based on the file will be displayed in the Tools window.


5.3.6.6 Adding a filtering tool
The user can add a file, based on which data filtering will be performed, provided that the structure of the added file is fully consistent with the structure of the previously added file.
To add a file and a new filter, follow these steps:
  • In Import window, load a file with the structure consistent with the structure of the previously loaded file (Figure 157). The new filter that may be applied to the schema will be displayed in the Tools window.

Figure 157

Figure 157. Adding a new filter


5.3.6.7 Changing the filtering tool settings

To change the filtering tool, follow these steps:

  1. In the Import window, click the name of the file, for which the mapping is set. The file will be selected.

  2. In the Import window, click Button 23. A context menu will open, where the list of created mappings will be shown (Figure 158).

Figure 158

Figure 158. Editing mapping configurations

  1. In the context menu of the mapping you need to change, click Edit. Mapping configuration window will open.

  2. In the Mapping configuration window, make all the required changes and click Ok. The Filtering tool will be changed.


5.3.6.8 Deleting a filtering tool
To delete a filtering, you need to delete the corresponding mapping.
To delete a Filtering tool, follow these steps:
  1. In the Import window, click the name of the file, for which the mapping is set. The file will be selected.

  2. In the Import window, click Button 24. A context menu will open, where the list of created mappings will be shown (Figure 159).

Figure 159

Figure 159. Deleting a mapping

  1. In the context menu of the mapping you need to delete, click Delete. The filtering tools made based on the deleted mapping will be deleted from the Tools window.





6 Working with the Caption window

6.1 Caption window menu items

The Caption window items are described in Table 40.

Table 38. Caption window items

Item

Purpose

table38_img1

Setting the caption format

table38_img2

Selecting the caption font

table38_img3

Setting the font size

table38_img4

Setting the font style

table38_img5

Drop-down menu for selecting a text color





8 Additional features

8.1 Add binary data

8.1.1 Add binary data to an instance

To add binary data to an instance, follow these steps:

  1. In the Main menu, select Windows → Instances. The Instances window opens.

  2. In the instance list, right-click on an instance. Context menu opens (Figure 181).

Figure 181

Figure 181. Instance context menu

  1. In the context menu, select Attach binary data. The binary data selection window will open (Figure 182).

Figure 182

Figure 182. Binary data selection

  1. Choose the data from the list of available data by checking the box next to the data items, or perform a preliminary data search in the search bar.

  2. Click OK. The selected data will be added to the instance and displayed in the Instances window under its attribute list.



8.1.2 Add binary data to a graph vertex

You may add binary data to a graph vertex that has already been uploaded into the Application and the binary data located on the user's PC.
To add binary data to a graph vertex, follow these steps:
  1. Open a schema. For the description of how to work with a schema, see section 4.3.

  2. Right-click on a graph vertex. Context menu opens (Figure 183).

Figure 183

Figure 183. Graph vertex context menu

  1. In the context menu, choose one of the operations:

    • Attach binary data. The binary data selection window on user’s PC will open (Figure 184). Select a file by clicking on it and clicking on Open. The file will be added to the graph vertex

    Figure 184

    Figure 184. Selecting a binary data file on the PC

    • Attach existing binary data. The binary data selection window appears (Figure 182).

      1. Check the box in the string for the data you need to attach to the graph vertex.

      2. Click OK. The selected binary data will be added to the graph vertex.

Note. After attaching the data selected on the user’s PC to the graph vertex, these data will be automatically displayed in the Binary data selection window.




8.2 Interface customization

Users may define the alignment of all visible windows at their own discretion.
To change the window position, it is necessary to drag the window’s title. An example of window alignment is given in Figure 185.
Figure 185

Figure 185. An example of window alignment

To define the positions of the windows, right click the window title bar. The action selection context menu appears (see Figure 186).

Figure 186

Figure 186. Context menu for selecting an action over the window position

Actions over windows are described in Table 43.

Table 43. Actions over the window position

Action

Description

table43_img1

Close the selected window

table43_img2

Close all windows but the selected one

table43_img3

Undock the window. The window is moved to a separate area

table43_img4

Dock the window. The window is moved to the beginning of the window list

table43_img5

Create a group of horizontal windows. The selected window is moved into a new row of windows

table43_img6

Create a group of vertical windows. The selected window is moved into a new column of windows

After you align the windows in accordance with your requirements, the alignment will be saved after you close the Application and reopen it again.



8.2.1 Setting the parameter values

Parameter values can be set as default ones for the Application. Every new item created in the Application will conform to the settings defined in the Settings window.

To tweak the settings, follow these steps:

  1. In the Main menu, select Investigation → Settings. The Settings window will open (Figure 187).

Figure 187

Figure 187. Settings window

  1. In the Settings window, click on the setting parameter that you need to change. The setting parameters will be displayed (Figure 188).

Figure 188

Figure 188. Setting parameters

  1. In the parameter representation block, make the required changes and click OK. Click Cancel to cancel all the changes you've done to the settings.

A description of settings that can be changed in the Settings window is given in Table 44.

Table 44. Settings

Setting

Parameter

Purpose

Search

General:

  • Show search panel

Template search:

  • Show conditions panel

Drop-down list for selecting the possibility of displaying the search panel and panel with conditions. Click on the table44_img1 button to select a parameter.

Search for doubles

Search by attributes

Template search:

Fuzzy search

Search for series

Search for cliques

Schema

Graph layout settings

Graph settings

A description of changeable graph parameters is given in section 4.3.3.2

Schema settings

A description of changeable schema settings is given in section 4.3.3.1

Table

Table limitations

Changeable parameters:

  • Selected rows

  • Selected cells

Editables

Table settings

Changeable parameters:

  • Background color

  • Text color

  • Highlight color

  • Highlight secondary color

Click on the table44_img1 button to select a parameter.

General

Investigation

Setting the following items:

  • Default name

  • Default directory

  • Number of recent files





List of abbreviations

Abbreviation

Interpretation

API

Application Programming Interface

IMEI

International Mobile Equipment Identifier

IMSI

International Mobile Subscriber Identifier

JSON

JavaScript Object Notation

H&S

Hardware&Software Complex

GIS

Geographic Information System

PC

Personal Computer

CU

Control Unit





List of terms

Term

Interpretation

Application programming interface

A set of ready-made classes, procedures, functions, and constants provided by an application (library, service) or an operations system to use in third-party software products

GeoJSON

An open format for storing geographical data structures that is based on JSON. This format can also store types of primitives for descriptions of geographical objects like points (addresses and locations), lines (streets, highways, borders), and polygons (countries, states, land plots). In addition, they can store so-called multitypes, which are groups of multiple types of primitives

JSON

Text data exchange format based on JavaScript

Attributes

Parameters based on which a file differs from a set of other files

Geographic Information System

A system for the collection, storage, analysis and graphical visualization of spatial (geographical) data and associated information about the required objects

Identifying attribute

An attribute that defines how different instances are combined during the compilation process

Page

A vertex with one neighbor

Ontology

Common object and link types for data analysis

Repository

A database, location for storing and maintaining any data

Instance

A particular object from a set of objects in its class