Loads a graph from a file. Supports native .ilu files and CSV/TSV with edge definitions.

load <path> target=(tail, head, [type,] name) [delimiter="<char>"] [header=true|false] [attributes=[(source, type, name), ...]]

Attribute Types

float, int32, uint32, string, shared_string

Examples

// Load a native Illuminator file
load my_graph.ilu

// Load a CSV with edge definitions
load edges.csv target=(source, target, name)

// Load a TSV with a custom delimiter and edge attributes
load data.tsv target=(from, to, string, id) delimiter=tab attributes=[(weight, float, weight), (type, string, category)]

// No header row: columns 0 and 1 are endpoints, column 2 is an edge weight
load edges.csv header=false target=(0, 1, name) attributes=[(2, float, weight)]

Adds attributes to an already-loaded graph by joining a CSV/TSV file against an existing node attribute.

import <path> target=(graph_attr, csv_column) [delimiter="<char>"] [header=true|false] attributes=[(source, type, name), ...]

Examples

// Import score and label from a CSV, matching on the "name" attribute
import metadata.csv target=(name, node_id) attributes=[(score, float, score), (label, string, label)]

// No header: join on graph "name" to column 0, import column 1 as score
import scores.csv header=false target=(name, 0) attributes=[(1, float, score)]

Manipulates the current node selection. There are four variants for set operations:

Operations

Examples

select all
select invert
select none
select expand 3

// Select nodes where the "score" attribute is above 0.5
select where (score > 0.5)

// Add nodes with ID between 5 and 10 to the current selection
+select where (nodeID > 5 && nodeID < 10)

// Remove nodes matching a name
-select where (name == "Alice")

// Keep only nodes that are also high-scoring
^select where (score >= 0.9)

Applies a style change to the current selection.

set <target> <property> <value>

Node Properties

Edge Properties

Label Properties

Examples

set node size 20
set node colour 3fb950
set node shape 1
set node border_size 3
set node border_colour 000000

set edge width 2
set edge colour 58a6ff

set label content name
set label anchor center
set label size 12
set label colour ffffff

Interpolates a style property across the selection based on a numeric attribute. Values are linearly mapped from the attribute range [min, max] to the style range [value_a, value_b].

map <target> <property>[.channels] <attribute> <min> <max> <value_a> <value_b>

The optional .channels suffix lets you target specific colour channels: r, g, b, a, or combinations like rgb, rgba. Without a suffix, all channels are affected.

Mappable Node Properties

Mappable Edge Properties

Mappable Label Properties

Examples

// Map node size from score range [0, 1] to sizes [5, 40]
map node size score 0 1 5 40

// Map node colour from blue to red based on a "temperature" attribute (0-100)
map node colour temperature 0 100 0000ff ff0000

// Map only the red channel of node colour
map node colour.r intensity 0 255 000000 ff0000

// Map edge width based on a weight attribute
map edge width weight 0 10 1 8

// Map label size by importance
map label size importance 0 100 8 32

Creates new objects from the current selection.

create subset <name>

Creates a named subset from the currently selected nodes. Subsets can be recalled in the Subset window to quickly restore selections.

Example

select where (group == "cluster_a")
create subset cluster_a

Runs a script file containing one command per line.

execute <path>

Each line is processed as if typed into the console. Text after // is treated as a comment. Empty lines are skipped. If any line throws an error, execution stops and the error is reported with the line number.

Example

execute scripts/setup.txt

You can also run scripts from Script > Execute... in the menu bar, which opens a file picker. Recently run scripts appear in the Script menu for quick re-execution.

See Script Files for syntax details and a full example script.