The Find Dialog

The Find dialog is a powerful tool for working with large graphs.
It enables the user to quickly find and/or select nodes, edges and bends.
This dialog is used by two slightly different mechanisms.

A find dialog will be shown, when the user activates the ‘Find’ option
in the ‘Edit’ menu. Using this approach, one can cycle through the matching
elements using ‘Edit -> Find Next’ and ‘Edit -> Find Previous’.
Alternatively a find dialog will be shown, when the user activates the
‘Selector’ Tool in the ‘Tools’ menu. In this mode all matching elements
will be selected at a single time when the user dismisses the dialog.

The Find dialog offers multiple tabs which can be configured to work together
or separately.

General Tab

Act on Current Selection Only

If set only the current selection will be used and/or modified
for the operation.

Select Inverse

If set the selection state will be inverted, i.e. hits will be treated
as misses and vice versa.

Clear Selection First

Controls, whether the existing selection should be cleared first.

Nodes Tab

Use these Criteria

Determines, whether this tab should be used for the operation.

Select

Selects, which type of search criterion should be used for nodes.

All: Selects all nodes.
Data Property: Selects nodes depending on custom property values.
This option will use the Data Property, Text, Match Text, Numeric
Value, Match Numeric Value, and Binary Value options to match
property values.
Label: Selects nodes depending on label text. This option will use
the Text and Match Text options to match label texts.
Fill Color: Selects nodes by their fill color. This option uses the color as defined in
the Fill Color section to match nodes.
Degree: Selects nodes by their degree, i.e. the number of the incoming and
outgoing edges.
This option uses the values of the minimal and maximal degree sections
to match a user specified range.
Indegree: Selects nodes by their indegree, i.e. the number of the incoming edges.
This option uses the values of the minimal and maximal degree sections
to match a user specified range.
Outdegree: Selects nodes by their outdegree, i.e. the number of the outgoing edges.
This option uses the values of the minimal and maximal degree sections
to match a user specified range.
Sources of Selected Edges: Selects nodes that have selected outgoing edges.
Targets of Selected Edges: Selects nodes that have selected ingoing edges.
Nodes of Selected Edges: Selects nodes that have selected ingoing or outgoing edges.
Neighbors of Selected Nodes: Selects nodes that are connected to other selected nodes.
Successors of Selected Nodes: Selects nodes that have an edge from a selected node.
Predecessors of Selected Nodes: Selects nodes that have an edge to a selected node.
Folder Nodes: Selects closed group nodes.
Group Nodes: Selects open group nodes.
Children of Selected Nodes: Selects child nodes of selected nodes.
Parents of Selected Nodes: Selects parent nodes of selected nodes.

Data Property

The data property whose value should be matched.

Text

The text (or regular expression) to search for.

Match Text

Determines the way text matches will be made.

Complete Match: Text will be matched, if the text is equal to given search term.
Suffix Match: Text will be matched, if the text ends with the given search term.
Prefix Match: Text will be matched, if the text starts with the given search term.
Infix Match: Text will be matched, if the text contains the given search term.
Regular Expression: Text will be matched, if the text conforms to the given regular expression.

Case Sensitive

Determines if text matches are case sensitive or not.

Minimal Degree

Determines the minimal number degree a node should have. This feature will
only be used for the Degree Criteria.

Maximal Degree

Determines the maximal number degree a node should have. This feature will
only be used for the Degree Criteria.

Fill Color

Determines the color to be used as the match color for the Fill Color criterion.

Maximal Path Distance

Determines the maximal number degree a node should have. This feature will
only be used for the Degree Criteria.

Numeric Value

The numeric value to match values of integer and decimal custom
properties.

Match Numeric Value

Determines the way numeric values will be matched.

Binary Value

The binary value (i.e. true/false) to match values of binary
custom properties.

Edges Tab

Use these Criteria

Determines, whether this tab should be used for the operation, i.e.
if edges should be selected.

Select

Selects, which type of search criterion should be used for edges.

All: Selects all edges.
Data Property: Selects edges depending on custom property values.
This option will use the Data Property, Text, Match Text, Numeric
Value, Match Numeric Value, and Binary Value options to match
property values.
Label: Selects edges depending on label text. This option will use
the Text and Match Text options to match label texts.
All Selfloops: Selects all self loops, i.e. edges, whose source and target node is
identical.
Selected Nodes Selfloops: Selects all self loops whose source node is selected.
Selected Nodes: Selects edges, whose source or target node is selected.
Selected Nodes Inedges: Selects edges, whose target node is selected.
Selected Nodes Outedges: Selects edges, whose source node is selected.
Selected Nodes Subgraph Edges: Selects edges, whose source and target node is selected.
Duplicate Edges: Selects duplicate edges, i.e. for each pair of nodes (a,b), which is
connected by more than one edge (a->b), all of these edges except for one
will be selected. This option will treat edges as directed ones, i.e.
(a->b) is not considered to be the same as (b->a)
Duplicate Undirected Edges: Selects duplicate edges, i.e. for each pair of nodes (a,b), which is
connected by more than one edge (a->b), all of these edges except for one
will be selected. This option will treat edges as undirected ones, i.e.
(a->b) is considered to be the same as (b->a)
Edges Pointing Downwards: Selects edges that point downwards. Edges whose source node lies above their target
node will be selected. If source and target node have the same y-coordinate, then
edges will be selected whose source node lies left of the target node. Note that the
center coordinates of nodes will be used when comparing these objects.
Transitive Reduction: Selects all edges that belong to the transitive reduction of the graph.
A transitive reduction of an acyclic graph does not contain any shortcut
edges between nodes. This criterion does only work for acyclic graphs.
Line Color: Selects edges by their color. This option uses the color as defined in
the Color section to match edges.

Data Property

The data property whose value should be matched.

Text

The text (or regular expression) to search for.

Match Text

Determines the way text matches will be made.

Complete Match: Text will be matched, if the text is equal to given search term.
Suffix Match: Text will be matched, if the text ends with the given search term.
Prefix Match: Text will be matched, if the text starts with the given search term.
Infix Match: Text will be matched, if the text contains the given search term.
Regular Expression: Text will be matched, if the text conforms to the given regular expression.

Case Sensitive

Determines if text matches are case sensitive or not.

Line Color

Determines the color to be used as the match color for the Line Color criterion.

Numeric Value

The numeric value to match values of integer and decimal custom
properties.

Match Numeric Value

Determines the way numeric values will be matched.

Binary Value

The binary value (i.e. true/false) to match values of binary
custom properties.

Bends Tab

Use these Criteria

Determines, whether this tab should be used for the operation, i.e.
if bends should be selected.

Select

Selects, which type of search criteria should be used for bends.

All: Selects all bends.
Selected Edges: Selects all bends that belong to currently selected edges.
Edges at Selected Nodes: Selects all bends that belong to edges connected to selected nodes.
Inedges at Selected Nodes: Selects all bends that belong to edges that end at selected nodes.
Outedges at Selected Nodes: Selects all bends that belong to edges that start at selected nodes.

Node Labels Tab

Use these Criteria

Determines, whether this tab should be used for the operation, i.e.
if node labels should be selected.

Select

Selects, which type of search criterion should be used for labels.

All: Selects all node labels.
Text: Selects labels depending on their text. This option will use
the Text and Match Text options to match label texts.
Index: Selects the first, second, third, … label of each node.
This option will use Index and Match Index options to determine which
labels to select.
Selected Nodes: Selects labels of selected nodes.

Text

The text (or regular expression) to search for.

Match Text

Determines the way text matches will be made.

Complete Match: Text will be matched, if the text is equal to given search term.
Suffix Match: Text will be matched, if the text ends with the given search term.
Prefix Match: Text will be matched, if the text starts with the given search term.
Infix Match: Text will be matched, if the text contains the given search term.
Regular Expression: Text will be matched, if the text conforms to the given regular expression.

Case Sensitive

Determines if text matches are case sensitive or not.

Index

The node label index to match.

Match Index

Determines the way indices will be matched.

Edge Labels Tab

Use these Criteria

Determines, whether this tab should be used for the operation, i.e.
if edge labels should be selected.

Select

Selects, which type of search criterion should be used for labels.

All: Selects all edge labels.
Text: Selects labels depending on their text. This option will use
the Text and Match Text options to match label texts.
Index: Selects the first, second, third, … label of each edge.
This option will use Index and Match Index options to determine which
labels to select.
Selected Edges: Selects labels of selected edges.

Text

The text (or regular expression) to search for.

Match Text

Determines the way text matches will be made.

Complete Match: Text will be matched, if the text is equal to given search term.
Suffix Match: Text will be matched, if the text ends with the given search term.
Prefix Match: Text will be matched, if the text starts with the given search term.
Infix Match: Text will be matched, if the text contains the given search term.
Regular Expression: Text will be matched, if the text conforms to the given regular expression.

Case Sensitive

Determines if text matches are case sensitive or not.

Index

The edge label index to match.

Match Index

Determines the way indices will be matched.