Class SquareGeometry

Object

AbstractGeometry

AbstractLattice

SquareGeometry

Direct Known Subclasses:

MooreGeometry, SecondNeighbourGeometry, VonNeumannGeometry

public class SquareGeometry
extends AbstractLattice

Square lattice with arbitrary neighbourhood sizes. Provides shared helpers for square-based variants.

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
SquareGeometry(EvoLudo engine)	Create a square lattice geometry tied to the given engine.

Method Summary

Modifier and Type	Method	Description
private static void	adjustBoundaries(AbstractGeometry geometry, int range, int side, int fullside, int offset, boolean interspecies)	Adjust arbitrary-range neighbourhoods along fixed boundaries.
protected boolean	checkSettings()	Hook for subclasses to implement geometry specific checks.
void	init()	Generates square regular lattices with arbitrary neighbourhood sizes.
static void	initHierarchicalSquare(AbstractGeometry geometry, int popSize, int demeSize, int startIndex, boolean fixedBoundary)	Initialize one hierarchical square deme using population and deme sizes.
static void	initSquare(AbstractGeometry geometry, int side, int fullside, int offset, boolean fixedBoundary)	Initialize a square lattice with arbitrary (odd) neighbourhood sizes.
static void	initSquareSelf(AbstractGeometry geometry, int side, int fullside, int offset)	Initialize a square lattice that only connects nodes to themselves (used when connectivity equals one).
boolean	parse(String arg)	Parse geometry-specific CLI options.
protected int	prepareSquareLattice()	Common setup for square geometries.
protected void	warnIfConnectivityProvided(String numeric)	Emit a warning if the user attempts to specify connectivity for a fixed stencil.

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

SquareGeometry

public SquareGeometry(EvoLudo engine)

Create a 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 AbstractGeometry

Parameters:

arg - the argument string without the geometry key

Returns:

true if parsing succeeded, false if invalid

warnIfConnectivityProvided

protected void warnIfConnectivityProvided(String numeric)

Emit a warning if the user attempts to specify connectivity for a fixed stencil.

Parameters:

numeric - connectivity string passed on the CLI

init

public void init()

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.

Specified by:

init in class AbstractGeometry

prepareSquareLattice

protected int prepareSquareLattice()

Common setup for square geometries.

Returns:

the computed side length of the lattice

initSquareSelf

public static void initSquareSelf(AbstractGeometry geometry,
 int side,
 int fullside,
 int offset)

Initialize a square lattice that only connects nodes to themselves (used when connectivity equals one).

Parameters:

geometry - geometry receiving the links

side - side length of the (sub) lattice

fullside - global side length

offset - index offset into the population

initHierarchicalSquare

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

Initialize one hierarchical 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

initSquare

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

Initialize a square lattice with arbitrary (odd) neighbourhood sizes.

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 range,
 int side,
 int fullside,
 int offset,
 boolean interspecies)

Adjust arbitrary-range neighbourhoods along fixed boundaries.

Parameters:

geometry - geometry receiving the links

range - interaction range

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 AbstractGeometry

Returns:

true if adjustments require a reset