Class Class<D, S>

The class with functionality for the base graph type.

Type Parameters

D extends BaseGraph.Data = BaseGraph.Data
S extends BaseGraph.ScratchData = BaseGraph.ScratchData

Hierarchy (view full)

Class
- FlowGraph.Class

Index

Accessors

data

get data(): D
Use the data object for JSON serializable data. For temporary or non-serializable data, use BaseGraph.Class.scratchData.

Returns D
the data object associated with this graph.
- Defined in lara-flow/src/graph/BaseGraph.ts:48

edges

get edges(): EdgeCollection<BaseEdge.Class<BaseEdge.Data, BaseEdge.ScratchData>, BaseEdge.Data, BaseEdge.ScratchData>
Returns EdgeCollection<BaseEdge.Class<BaseEdge.Data, BaseEdge.ScratchData>, BaseEdge.Data, BaseEdge.ScratchData>
A collection of all edges in the graph.
- Defined in lara-flow/src/graph/BaseGraph.ts:332

nodes

get nodes(): NodeCollection<BaseNode.Class<BaseNode.Data, BaseNode.ScratchData>, BaseNode.Data, BaseNode.ScratchData>
Returns NodeCollection<BaseNode.Class<BaseNode.Data, BaseNode.ScratchData>, BaseNode.Data, BaseNode.ScratchData>
A collection of all nodes in the graph.
- Defined in lara-flow/src/graph/BaseGraph.ts:324

scratchData

get scratchData(): S
Use the scratch data object for temporary or non-serializable data. For JSON serializable data, use BaseGraph.Class.data.

The scratch data is stored under the @specs-feup/flow namespace.

Returns S
the scratch data object associated with this graph.
- Defined in lara-flow/src/graph/BaseGraph.ts:60

Methods

addEdge

addEdge(source, target, id?): BaseEdge.Class<BaseEdge.Data, BaseEdge.ScratchData>
Adds a new empty edge to the graph, connecting two existing nodes.
Parameters
- source: BaseNode.Class<BaseNode.Data, BaseNode.ScratchData>
  The source node of the edge.
- target: BaseNode.Class<BaseNode.Data, BaseNode.ScratchData>
  The target node of the edge.
- Optionalid: string
  The id of the edge to add. If not provided, a new id will be generated.
Returns BaseEdge.Class<BaseEdge.Data, BaseEdge.ScratchData>
the newly created edge.
- Defined in lara-flow/src/graph/BaseGraph.ts:276

addNode

addNode(id?, parent?): BaseNode.Class<BaseNode.Data, BaseNode.ScratchData>
Adds a new empty node to the graph.
Parameters
- Optionalid: string
  The id of the node to add. If not provided, a new id will be generated.
- Optionalparent: BaseNode.Class<BaseNode.Data, BaseNode.ScratchData>
  The parent node of the node to add. If not provided, the node will be orphan.
Returns BaseNode.Class<BaseNode.Data, BaseNode.ScratchData>
the newly created node.
- Defined in lara-flow/src/graph/BaseGraph.ts:257

apply

apply<G2>(transformation): G2
Applies a Graph.Transformation to the graph. May be chained.
Type Parameters
- G2 extends BaseGraph.Class<BaseGraph.Data, BaseGraph.ScratchData>
Parameters
- transformation: Transformation<BaseGraph.Class<D, S>, G2>
  The transformation to apply.
Returns G2
The graph after applying the transformation.
- Defined in lara-flow/src/graph/BaseGraph.ts:428

arrayCollection

arrayCollection<D, S, N>(NodeType, nodes): NodeCollection<N, D, S>
Creates a collection from an array of nodes. Given that the array may be empty, passing the NodeType is mandatory.
Type Parameters
- D extends BaseNode.Data
- S extends BaseNode.ScratchData
- N extends BaseNode.Class<D, S>
Parameters
- NodeType: Node<D, S, N>
  The type of node to create a collection for.
- nodes: N[]
  The nodes to create a collection from.
Returns NodeCollection<N, D, S>
A collection of the given type with the given nodes.
- Defined in lara-flow/src/graph/BaseGraph.ts:385
arrayCollection<D, S, E>(EdgeType, edges): EdgeCollection<E, D, S>
Creates a collection from an array of edges. Given that the array may be empty, passing the EdgeType is mandatory.
Type Parameters
- D extends BaseEdge.Data
- S extends BaseEdge.ScratchData
- E extends BaseEdge.Class<D, S>
Parameters
- EdgeType: Edge<D, S, E>
  The type of edge to create a collection for.
- edges: E[]
  The edges to create a collection from.
Returns EdgeCollection<E, D, S>
A collection of the given type with the given edges.
- Defined in lara-flow/src/graph/BaseGraph.ts:398

as

as<G>(GraphType): G
Changes the functionality class of the current graph. This is only possible if the data and scratch data are compatible with the new class. To assert that, use BaseGraph.Class.is.
Type Parameters
- G extends BaseGraph.Class<D, S>
Parameters
- GraphType: {
  Class: Graph.Class<D, S, G>;
  }
  The graph type to change the functionality class into.
  - Class: Graph.Class<D, S, G>
Returns G
The same graph, wrapped in the new functionality class.
- Defined in lara-flow/src/graph/BaseGraph.ts:124

emptyCollection

emptyCollection<N, D, S>(NodeType): NodeCollection<N, D, S>
Type Parameters
- N extends BaseNode.Class<D, S>
- D extends BaseNode.Data
- S extends BaseNode.ScratchData
Parameters
- NodeType: Node<D, S, N>
  The type of node to create an empty collection for.
Returns NodeCollection<N, D, S>
An empty collection of the given type.
- Defined in lara-flow/src/graph/BaseGraph.ts:341
emptyCollection<D, S, E>(EdgeType): EdgeCollection<E, D, S>
Type Parameters
- D extends BaseEdge.Data
- S extends BaseEdge.ScratchData
- E extends BaseEdge.Class<D, S>
Parameters
- EdgeType: Edge<D, S, E>
  The type of edge to create an empty collection for.
Returns EdgeCollection<E, D, S>
An empty collection of the given type.
- Defined in lara-flow/src/graph/BaseGraph.ts:350

expect

expect<D2, S2, G2>(GraphType, message?): G2
Changes the functionality class of the current graph. Should only be used when it is known (but not statically provable) that the graph is compatible with the new class. If not, an error will be thrown.

It is bad practice to try and catch the error thrown by this function. For such cases, combine BaseGraph.Class.is with BaseGraph.Class.as, or use BaseGraph.Class.switch instead.
Type Parameters
- D2 extends BaseGraph.Data
- S2 extends BaseGraph.ScratchData
- G2 extends BaseGraph.Class<D2, S2>
Parameters
- GraphType: Graph<D2, S2, G2>
  The graph type to change the functionality class into.
- Optionalmessage: string
  The message to throw if the graph is not compatible with the type.
Returns G2
The graph, wrapped in the new functionality class.

Throws
LaraFlowError if the graph is not compatible with the type. This error should be seen as a logic error and not catched.
- Defined in lara-flow/src/graph/BaseGraph.ts:147

getEdgeById

getEdgeById(id): undefined | BaseEdge.Class<BaseEdge.Data, BaseEdge.ScratchData>
Retrieve a specific edge from the graph by its id.
Parameters
- id: string
  The id of the edge to get.
Returns undefined | BaseEdge.Class<BaseEdge.Data, BaseEdge.ScratchData>
The edge with the given id, or undefined if no such edge exists.
- Defined in lara-flow/src/graph/BaseGraph.ts:312

getNodeById

getNodeById(id): undefined | BaseNode.Class<BaseNode.Data, BaseNode.ScratchData>
Retrieve a specific node from the graph by its id.
Parameters
- id: string
  The id of the node to get.
Returns undefined | BaseNode.Class<BaseNode.Data, BaseNode.ScratchData>
The node with the given id, or undefined if no such node exists.
- Defined in lara-flow/src/graph/BaseGraph.ts:297

init

init<D2, S2>(builder): BaseGraph.Class<D2, S2>
Initializes the graph with the information of a builder. This is effectively extends the type of the graph to include the data and scratch data of the builder.

The same graph may simultaneously be of multiple types, as long as the data and scratch data are compatible with the types. The builder methods may overwrite data and scratch data fields with names that collide with its type's fields.
Type Parameters
- D2 extends BaseGraph.Data
- S2 extends BaseGraph.ScratchData
Parameters
- builder: Graph.Builder<D2, S2, D, S>
  The builder to use to initialize the graph.
Returns BaseGraph.Class<D2, S2>
The same graph, with the data and scratch data of the builder. The graph is downcasted to BaseGraph.Class because the builder may overwrite the data and scratch data fields, invalidating the current type.
- Defined in lara-flow/src/graph/BaseGraph.ts:80

is

is<D2, S2, G2>(GraphType): this is BaseGraph.Class<D2, S2>
Checks if this graph's data and scratch data are compatible with a specific type. This is effectively a type guard function.
Type Parameters
- D2 extends BaseGraph.Data
- S2 extends BaseGraph.ScratchData
- G2 extends BaseGraph.Class<D2, S2>
Parameters
- GraphType: Graph<D2, S2, G2>
  The graph type to check compatibility with.
Returns this is BaseGraph.Class<D2, S2>
Whether the graph is compatible with the given type.
- Defined in lara-flow/src/graph/BaseGraph.ts:98

setEdgeIdGenerator

setEdgeIdGenerator(generator): this
Sets the id generator to be used when generating edge identifiers. This id generator is only used when creating an edge without specifying an id. In other words, if an id is explicitly provided when creating an edge, it will have precedence over calling the id generator.

When no id generator is set and no id is provided when creating an edge, the id generation will be delegated to cytoscape.
Parameters
- generator: undefined | Edge.IdGenerator
  The id generator to use, or undefined to delegate to cytoscape's default id generation.
Returns this
itself for chaining.
- Defined in lara-flow/src/graph/BaseGraph.ts:244

setNodeIdGenerator

setNodeIdGenerator(generator): this
Sets the id generator to be used when generating node identifiers. This id generator is only used when creating a node without specifying an id. In other words, if an id is explicitly provided when creating a node, it will have precedence over calling the id generator.

When no id generator is set and no id is provided when creating a node, the id generation will be delegated to cytoscape.
Parameters
- generator: undefined | Node.IdGenerator
  The id generator to use, or undefined to delegate to cytoscape's default id generation.
Returns this
itself for chaining.
- Defined in lara-flow/src/graph/BaseGraph.ts:226

switch

switch(...cases): void
Checks if the type of the graph is compatible with several types, calling a callback for the first match. See Graph.Case for the syntax of each case.

For a default case, match with BaseGraph, which will always be compatible with any graph type.
Parameters
- Rest...cases: _Case<BaseGraph.Data, BaseGraph.ScratchData, BaseGraph.Class<BaseGraph.Data, BaseGraph.ScratchData>>[]
  The cases to match against.
Returns void
- Defined in lara-flow/src/graph/BaseGraph.ts:204

toCy

toCy(): Core
Returns Core
the underlying cytoscape graph object.
- Defined in lara-flow/src/graph/BaseGraph.ts:459

toFile

toFile(formatter, filename): void
Converts the graph to a string using a Graph.Formatter and writes it to a file.
Parameters
- formatter: Formatter<BaseGraph.Class<D, S>>
  The formatter to use.
- filename: string
  The name of the file to write to.
Returns void
The file to where the contents where written.
- Defined in lara-flow/src/graph/BaseGraph.ts:452

toString

toString(formatter): string
Converts the graph to a string using a Graph.Formatter.
Parameters
- formatter: Formatter<BaseGraph.Class<D, S>>
  The formatter to use.
Returns string
The string representation of the graph.
- Defined in lara-flow/src/graph/BaseGraph.ts:440

tryAs

tryAs<D2, S2, G2>(GraphType): undefined | G2
Tries to change the functionality class of the current graph. If the graph is not compatible with the new class, undefined is returned.
Type Parameters
- D2 extends BaseGraph.Data
- S2 extends BaseGraph.ScratchData
- G2 extends BaseGraph.Class<D2, S2>
Parameters
- GraphType: Graph<D2, S2, G2>
  The graph type to change the functionality class into.
Returns undefined | G2
The graph, wrapped in the new functionality class, or undefined if the graph is not compatible with the type.
Example
```
if (graph === undefined || !graph.is(FlowGraph)) {
    return undefined;
}
return node.as(FlowGraph);
```
Can be simplified to:
```
return node?.tryAs(FlowGraph);
```
- Defined in lara-flow/src/graph/BaseGraph.ts:183

Class Class<D, S>

Type Parameters

Hierarchy (view full)

Index

Accessors

Methods

Accessors

data

Returns D

edges

Returns EdgeCollection<BaseEdge.Class<BaseEdge.Data, BaseEdge.ScratchData>, BaseEdge.Data, BaseEdge.ScratchData>

nodes

Returns NodeCollection<BaseNode.Class<BaseNode.Data, BaseNode.ScratchData>, BaseNode.Data, BaseNode.ScratchData>

scratchData

Returns S

Methods

addEdge

Parameters

Returns BaseEdge.Class<BaseEdge.Data, BaseEdge.ScratchData>

addNode

Parameters

Returns BaseNode.Class<BaseNode.Data, BaseNode.ScratchData>

apply

Type Parameters

Parameters

Returns G2

arrayCollection

Type Parameters

Parameters

Returns NodeCollection<N, D, S>

Type Parameters

Parameters

Returns EdgeCollection<E, D, S>

as

Type Parameters

Parameters

Class: Graph.Class<D, S, G>

Returns G

emptyCollection

Type Parameters

Parameters

Returns NodeCollection<N, D, S>

Type Parameters

Parameters

Returns EdgeCollection<E, D, S>

expect

Type Parameters

Parameters

Returns G2

Throws

getEdgeById

Parameters

Returns undefined | BaseEdge.Class<BaseEdge.Data, BaseEdge.ScratchData>

getNodeById

Parameters

Returns undefined | BaseNode.Class<BaseNode.Data, BaseNode.ScratchData>

init

Type Parameters

Parameters

Returns BaseGraph.Class<D2, S2>

is

Type Parameters

Parameters

Returns this is BaseGraph.Class<D2, S2>

setEdgeIdGenerator

Parameters

Returns this

setNodeIdGenerator

Parameters

Returns this

switch

Parameters

Returns void

toCy

Returns Core

toFile

Parameters

Returns void

toString

Parameters