Object Inserter

Inserts nodes and edges from a data table into the network. The table can contain the nodes per edge in one row separated by the defined separator or the nodes of one edge in several rows. An example table that would use the node id and second node id column would look as follows (typical edge table):

Node1IdNode2Id
node1node2
node2node4
node3node4
This table would also use the row id as the edge id.

An example table that would use only the node id column and the edge id column would look as follows:
EdgeIdNodeId
edge1node1
edge1node2
edge1node3
edge2node1
edge2node3
An example table that would use the in column separator ";" (Advanced Options tab) with one node id column and the row id as edge id would look as follows:
NodeId
node1; node2
node3; node2
node3; node4
This table would create an edge for each row with the two nodes separated by the semicolon. Notice: Loops are represented as edges that contain only the node that is connected by the link.

Options

Node id column
The column that contains the unique node id.
Node label column
The column that contains the optional node label.
Second node id column
The optional column that contains the second node id. This option is useful for tables that contain two node columns per edge.
Second node label column
The optional column that contains the optional label of the second node.
Edge id column
The column name that contains the unique edge id.
Edge label
The optional column that contains the label of the edge.
Weight settings
The getWeight method returns 1 per default for all not set edge weights. Select the none method if you have no weight or all edges should have the weight 1. Select default if all edges should have a default weight unequal to 1. Enter the desired default weight in the default weight field. Select column if the input table contains a weight column that contains the weight for each edge.
Weight column
The column that contains the edge weight.
Default weight
The weight that should be used for all edges.
All nodes have same weight
Tick this option if the weight should be attached to the edge instead of the end objects. If ticked all nodes of an edge must have the same weight. This is most likely if you have no hyperedges and both node id columns are selected.

Advanced Options

Node partition column
The optional column that contains the node partition name.
Node partition name
This field is only enabled if no node partition column is selected. If neither a column nor a name is provided the default node partition with name "nodes" is used.
Assign partition to existing nodes
Select this option if the selected partition should be also assigned to existing nodes that have already a partition assigned.
In column separator
A regular expression that is used to split the cell content of the id and optional label column. This can be used if a column contains more than one node id separated by special characters.
Skip value pattern
All cells that apply to the given regular expression are skipped.
Edge partition column
The optional column that contains the edge partition name.
Edge partition name
This field is only enabled if no edge partition column is selected. If neither a column nor a name is provided the default edge partition with name "edges" is used.
Assign partition to existing edges
Select this option if the selected partition should be also assigned to existing edges that have already a partition assigned.
Create unique edge id
A unique edge id is generated by concatenating the row id and the edge id prefix.
Edge id prefix
The prefix is concatenated with the row id to generate a unique edge id.
Create edge id using node ids
A edge id is generated by concatenating node ids in alphabetical order separated by the given separator.
Node id separator
The separator is used in the edge id if the create edge id using node ids is ticked.
Create directed edges
Adds the is_target feature to the last node of each edge. This option is preferred to use with two defined node columns where the second node gets the is_target feature assigned.
Link nodes direct
Creates no edge nodes and links the first and second node directly.
Trim object ids
Removes leading and trailing whitespaces from the node and edge ids.

Input Ports

Icon
Existing Network (optional) the node creates a new network if not connected
Icon
Data table with the objects to insert into the network

Output Ports

Icon
Updated Network

Views

This node has no views

Workflows

Links

Developers

You want to see the source code for this node? Click the following button and we’ll use our super-powers to find it for you.