Class Class<D, S>

The class with functionality for the base graph type.

Type Parameters

D extends FlowGraph.Data = FlowGraph.Data
S extends FlowGraph.ScratchData = FlowGraph.ScratchData

Hierarchy (view full)

BaseGraph.Class<D, S>
- Class

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.
Inherited from BaseGraph.Class.data
- 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.
Inherited from BaseGraph.Class.edges
- Defined in lara-flow/src/graph/BaseGraph.ts:332

functions

get functions(): NodeCollection<FunctionNode.Class<FunctionNode.Data, FunctionNode.ScratchData>, FunctionNode.Data, FunctionNode.ScratchData>
Retrieves all functions in the graph.

The functions must be in the map, the respective nodes must exist, and the nodes must be FunctionNode to be included in the collection.

Returns NodeCollection<FunctionNode.Class<FunctionNode.Data, FunctionNode.ScratchData>, FunctionNode.Data, FunctionNode.ScratchData>
A collection of all functions in the graph.
- Defined in lara-flow/src/flow/FlowGraph.ts:111

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.
Inherited from BaseGraph.Class.nodes
- 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.
Inherited from BaseGraph.Class.scratchData
- 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.
Inherited from Class.addEdge
- Defined in lara-flow/src/graph/BaseGraph.ts:276

addFunction

addFunction(name, node?): FunctionNode.Class<FunctionNode.Data, FunctionNode.ScratchData>
Adds a FunctionNode to the graph, updating the function map.
Parameters
- name: string
  The name of the function. This name must be unique in the graph, so it should be mangled if the use case permits overloading.
- Optionalnode: BaseNode.Class<BaseNode.Data, BaseNode.ScratchData>
  The node to initialize as the FunctionNode. If not provided, a new node will be created.
Returns FunctionNode.Class<FunctionNode.Data, FunctionNode.ScratchData>
The FunctionNode that was added.

Throws
LaraFlowError if the function name already exists in the graph. This should be seen as a logic error and should not catched. Instead, ensure that no existing function shares the same name by renaming or removing.
- Defined in lara-flow/src/flow/FlowGraph.ts:44

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.
Inherited from Class.addNode
- 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<FlowGraph.Class<D, S>, G2>
  The transformation to apply.
Returns G2
The graph after applying the transformation.
Inherited from Class.apply
- 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.
Inherited from Class.arrayCollection
- 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.
Inherited from Class.arrayCollection
- 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.
Inherited from Class.as
- 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.
Inherited from Class.emptyCollection
- 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.
Inherited from Class.emptyCollection
- 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.
Inherited from Class.expect
- 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.
Inherited from Class.getEdgeById
- Defined in lara-flow/src/graph/BaseGraph.ts:312

getFunction

getFunction(name): undefined | FunctionNode.Class<FunctionNode.Data, FunctionNode.ScratchData>
Retrieves a FunctionNode from the graph by the name of the function.

If the function is not in the map, the node does not exist, or the node is not a FunctionNode, undefined will be returned.
Parameters
- name: string
  The name of the function.
Returns undefined | FunctionNode.Class<FunctionNode.Data, FunctionNode.ScratchData>
The FunctionNode, or undefined if it does not exist.
- Defined in lara-flow/src/flow/FlowGraph.ts:66

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.
Inherited from Class.getNodeById
- Defined in lara-flow/src/graph/BaseGraph.ts:297

getOrAddFunction

getOrAddFunction(name): FunctionNode.Class<FunctionNode.Data, FunctionNode.ScratchData>
Retrieves a FunctionNode from the graph by the name of the function. If the function does not exist, a new node will be created, updating the function map.
Parameters
- name: string
  The name of the function.
Returns FunctionNode.Class<FunctionNode.Data, FunctionNode.ScratchData>
The FunctionNode that was retrieved or created.
- Defined in lara-flow/src/flow/FlowGraph.ts:80

hasFunction

hasFunction(name): boolean
Checks if the graph has a function with the given name.

The function must be in the map, the respective node must exist, and the node must be a FunctionNode for this method to return true.
Parameters
- name: string
  The name of the function.
Returns boolean
true if the graph has a function with the given name, false otherwise.
- Defined in lara-flow/src/flow/FlowGraph.ts:97

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.
Inherited from Class.init
- 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.
Inherited from Class.is
- 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.
Inherited from Class.setEdgeIdGenerator
- 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.
Inherited from Class.setNodeIdGenerator
- 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
Inherited from Class.switch
- Defined in lara-flow/src/graph/BaseGraph.ts:204

toCy

toCy(): Core
Returns Core
the underlying cytoscape graph object.
Inherited from Class.toCy
- 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<FlowGraph.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.
Inherited from Class.toFile
- 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<FlowGraph.Class<D, S>>
  The formatter to use.
Returns string
The string representation of the graph.
Inherited from Class.toString
- 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);
```
Inherited from Class.tryAs
- 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>

functions

Returns NodeCollection<FunctionNode.Class<FunctionNode.Data, FunctionNode.ScratchData>, FunctionNode.Data, FunctionNode.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>

addFunction

Parameters

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

Throws

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>

getFunction

Parameters

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

getNodeById

Parameters

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

getOrAddFunction

Parameters

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

hasFunction

Parameters

Returns boolean

init

Type Parameters

Parameters

Returns BaseGraph.Class<D2, S2>

is

Type Parameters

Parameters

Returns this is BaseGraph.Class<D2, S2>

setEdgeIdGenerator