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