Package org.bigraphs.framework.core.alg.generators

Class BigridGenerator

java.lang.Object

org.bigraphs.framework.core.alg.generators.BigridGenerator

public class BigridGenerator
extends Object

A class to generate bigrids as described in the dissertation.

The bigrid is constructed via a composition-based approach using only elementary bigraphs instead of using the bigraph builder (e.g., PureBigraphBuilder).

The elementary bigraphs are collected within the inner class BigridGenerator.DiscreteIons and are accessible via its methods, e.g., BigridGenerator.DiscreteIons.bottomLeft() for the bottom-left corner bigrid node.

Author:

Dominik Grzelak

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	BigridGenerator.DiscreteIons	Inner class that provides the basic building blocks for constructing the bigrid.

Field Summary

Fields

Modifier and Type	Field	Description
protected final DefaultDynamicSignature	signature

Constructor Summary

Constructors

Constructor	Description
BigridGenerator(DefaultDynamicSignature signature)	Default constructor for a bigrid.

Method Summary

Modifier and Type	Method	Description
protected void	assertDimensionsAreCorrect(int n, int m)	Checks some initial conditions before a bigrid can be created.
PureBigraph	generate(int numOfRows, int numOfCols)
Linkings<DefaultDynamicSignature>	getLinkings()
Placings<DefaultDynamicSignature>	getPlacings()
DefaultDynamicSignature	getSignature()	Returns the (probably merged) signature of the bigrid.
DefaultDynamicSignature	signature()	Get the bigrids original signature that is used to build the grid structure.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

signature

protected final DefaultDynamicSignature signature

Constructor Details

BigridGenerator

public BigridGenerator(DefaultDynamicSignature signature)

Default constructor for a bigrid.

Another signature can be provided that is merged with the internal bigrid's signature. This is not to be confused with the signature that should be provided in order that the concrete bigrid nodes can be created.

This might be necessary in some cases, e.g., when the bigrid itself is only one part of a larger model.

If the signature is null, the internal bigrid signature is used, see signature().

Parameters:

signature - another signature to be merged with the internal bigrid signature

See Also:

• signature()

Method Details

getLinkings

public Linkings<DefaultDynamicSignature> getLinkings()

getPlacings

public Placings<DefaultDynamicSignature> getPlacings()

generate

public PureBigraph generate(int numOfRows,
 int numOfCols)
                     throws InvalidConnectionException,
TypeNotExistsException,
IncompatibleSignatureException,
IncompatibleInterfaceException

Throws:

InvalidConnectionException

TypeNotExistsException

IncompatibleSignatureException

IncompatibleInterfaceException

getSignature

public DefaultDynamicSignature getSignature()

Returns the (probably merged) signature of the bigrid.

Returns:

the signature of the current bigrid

assertDimensionsAreCorrect

protected void assertDimensionsAreCorrect(int n,
 int m)

Checks some initial conditions before a bigrid can be created.

Parameters:

n - row count

m - column count

signature

public DefaultDynamicSignature signature()

Get the bigrids original signature that is used to build the grid structure.

Returns:

the original signature of the bigrid