Working with collections

The functionality within pSysmon is provided as collection nodes which can be combined in collections. Within a project the user can create several collections depending on the individual needs and add the desired collection nodes to the collection. The collections can be saved for later use. A collection acts as a kind of a container for several collection nodes. For example, one collection might hold all the nodes to handle the geometry of the seismic network, another collection holds the nodes to import the data in various formats, ….and so on.

A pSysmon collection is a container to hold a set of collection nodes. Depending on the nodes within the collection, a collection can be executed with a flow-like behaviour having one node passing the output to the next one, or it can simply be a container of standalone nodes that are ignored when executing the collection.

To create, load or edit collections, the context menu of the collection panel can be used. To access the context menu, click the right mouse button when the mouse pointer is inside the collection panel. The collection context menu is only available if a project is active.

 The context menu of the collection panel

A collection node is a python module or package that provides some functionality to the pSysmon user (e.g. import files, display trace data, …). The available nodes are organized in categories. The available collection nodes are listed in the searchable collection node repository panel.

To use a collection node, it has to be added to a collection. Depending on the type of the node (editabel, uneditable, standalone) the node provides several methods to acces its functionality. The different types of nodes and how to use them is explained in the next section Types of modules.

Collection node types

A pSysmon can be one of three types:

  • editable
  • uneditable
  • standalone

Depending on their type, each node shows a different behaviour within a pSysmon collection. The type of the collection node is listed in the table in the collection node repository table.

Editable collection node

Editable nodes provide a list of node parameters which can be set for each module before executing the collection. The node parameters can be set using the edit menu in the collection context menu. Using this edit menu, a GUI is shown providing the user an interface to set or change the parameters of the node. The appearance of the user interface depends on the collection node. The node parameters are used as an input when executing the node during the execution of the collection.

Uneditable collection node

Uneditable nodes don't have any parameters to be set before executing the collection.

Standalone collection node

Standalone nodes are ignored when executing the collection. They provide a user interface that can be accessed by using the edit menu in the collection context menu.

Adding collection nodes to a collection

To add a collection node to a collection, a collection has to be created or loaded first. Select the node in the collection node repository panel. You can sort the collection node repository table by clicking on the according table column header or you can search the collection node repository by typing the search term into the collection node repository search field. Every field in the collection node repository table is searched using the typed search term. Once you have selected a collection node by clicking on the collectino node row in the collection node repository table, select the add menu of the context menu (which is accessible by clicking the right mouse button). The selected collection node will appear in the collection panel.