Class VonNeumannGeometry

Object

AbstractGeometry

AbstractLattice

SquareGeometry

VonNeumannGeometry

public class VonNeumannGeometry
extends SquareGeometry

Square lattice with von Neumann neighbourhood (four nearest neighbours).

Field Summary

Fields inherited from class AbstractLattice

fixedBoundary

Fields inherited from class AbstractGeometry

cli, connectivity, derivedId, EMPTY_LINKS, engine, features, geometryId, in, isInterspecies, isRegular, isRewired, isSingle, isUndirected, isValid, kin, kout, logger, name, network2D, network3D, out, pAddwire, pRewire, size, specs, type

Constructor Summary

Constructors

Constructor	Description
VonNeumannGeometry(EvoLudo engine)	Create a von Neumann square lattice geometry tied to the given engine.

Method Summary

Modifier and Type	Method	Description
private static void	adjustBoundaries(AbstractGeometry geometry, int side, int fullside, int offset, boolean interspecies)	Adjust von Neumann neighbourhoods when fixed boundaries are requested.
protected boolean	checkSettings()	Hook for subclasses to implement geometry specific checks.
void	init()	Generates square regular lattices with arbitrary neighbourhood sizes.
static void	initHierarchicalVonNeumann(AbstractGeometry geometry, int popSize, int demeSize, int startIndex, boolean fixedBoundary)	Initialize one hierarchical von Neumann square deme using population and deme sizes.
static void	initVonNeumann(AbstractGeometry geometry, int side, int fullside, int offset, boolean fixedBoundary)	Initialize a von Neumann square lattice.
boolean	parse(String arg)	Parse geometry-specific CLI options.

Methods inherited from class SquareGeometry

initHierarchicalSquare, initSquare, initSquareSelf, prepareSquareLattice, warnIfConnectivityProvided

Methods inherited from class AbstractLattice

clone, ensureSquareSize, equals, hashCode, isFixedBoundary, setFixedBoundary, stripBoundary

Methods inherited from class AbstractGeometry

addDirected, addEdgeAt, addLinkAt, addUndirected, alloc, check, clearLinksFrom, clearLinksTo, create, create, create, decodeGeometry, deriveCompetitionGeometry, displaySingle, encodeGeometry, enforceSize, getAddwire, getCLI, getConnectivity, getEncodeKey, getFeatures, getLabel, getName, getNetwork2D, getNetwork3D, getRewire, getSize, getSpecs, getType, isConsistent, isDerivedFrom, isGraphConnected, isInterspecies, isLattice, isNeighborOf, isRegular, isRewired, isSingle, isType, isUndirected, isUnique, markDerivedFrom, parse, removeEdgeAt, removeLinkAt, rewire, rewireDirected, rewireEdgeAt, rewireLinkAt, rewireUndirected, setAddwire, setConnectivity, setInterspecies, setName, setNetwork2D, setNetwork3D, setRewire, setSingle, setSize, setType, swapEdges, usage, warn

Methods inherited from class Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Details

VonNeumannGeometry

public VonNeumannGeometry(EvoLudo engine)

Create a von Neumann square lattice geometry tied to the given engine.

Parameters:

engine - EvoLudo pacemaker

Method Details

parse

public boolean parse(String arg)

Description copied from class: AbstractGeometry

Parse geometry-specific CLI options.

Overrides:

parse in class SquareGeometry

Parameters:

arg - the argument string without the geometry key

Returns:

true if parsing succeeded, false if invalid

init

public void init()

Description copied from class: SquareGeometry

Generates square regular lattices with arbitrary neighbourhood sizes. Variant-specific initializers for standard stencils are available to subclasses.

Requirements/notes:

1. Population size must be a perfect square \(N=n^2\).
2. Admissible connectivities are \(4\) (von Neumann) or \((2m+1)^2-1\) for Moore-type stencils.
3. Inter-species interactions add the focal node as a neighbour and allow connectivity \(1\).
4. Boundaries are periodic by default but can be fixed.

Overrides:

init in class SquareGeometry

initHierarchicalVonNeumann

public static void initHierarchicalVonNeumann(AbstractGeometry geometry,
 int popSize,
 int demeSize,
 int startIndex,
 boolean fixedBoundary)

Initialize one hierarchical von Neumann square deme using population and deme sizes.

Parameters:

geometry - geometry receiving the links

popSize - total population size

demeSize - number of individuals in the deme

startIndex - index offset into the population

fixedBoundary - true for fixed boundary conditions

initVonNeumann

public static void initVonNeumann(AbstractGeometry geometry,
 int side,
 int fullside,
 int offset,
 boolean fixedBoundary)

Initialize a von Neumann square lattice.

Parameters:

geometry - geometry receiving the links

side - side length of the (sub) lattice

fullside - global side length

offset - index offset into the population

fixedBoundary - true for fixed boundary conditions

adjustBoundaries

private static void adjustBoundaries(AbstractGeometry geometry,
 int side,
 int fullside,
 int offset,
 boolean interspecies)

Adjust von Neumann neighbourhoods when fixed boundaries are requested.

Parameters:

geometry - geometry receiving the links

side - side length of the (sub) lattice

fullside - global side length

offset - index offset into the population

interspecies - true if self-links are required

checkSettings

protected boolean checkSettings()

Description copied from class: AbstractGeometry

Hook for subclasses to implement geometry specific checks.

Overrides:

checkSettings in class SquareGeometry

Returns:

true if adjustments require a reset