Lattice Usage

The Lattice links entries in the left and right FATables. It consists of nodes and links (see the picture on the home page).

Nodes: The nodes are surrogates for the FATables. They contain the FATable identifiers and bookkeeping information - the user never interacts directly with them.

Links: The links connect the data. Each link contains the identifiers of the left and right data that it connects. Each link can connect several objects, if the topology of the Lattice allows it (see the construction page). The topology is specified when the Lattice is constructed. It can also contain arbitrary user defined "link data". The LinkData is under user control; s/he is free to modify it as desired (see the data access page).

All Lattice-specific data types in the code below are declared in Lattice.h. Because we can't use namespaces, you must write Lattice<>::Datatype to use one. I keep my code less verbose by declaring, typedef Lattice<>::Datatype Datatype for the ones I am using.

Lattice does not take ownership of any previously existing memory, so the user remains responsible for cleaning up. Lattice makes a copy of the LinkData (see below), so the user is free to delete or overwrite his/her copy whenever it is convenient.