PottsToolkit API Reference

Unordered contact/adhesion Hamiltonian declaration.

One typed semantic binding. Collection order is never scientific priority.

An immutable, canonically ordered binding collection whose public type does not encode its size. The tuple is deliberately an abstract field: bindings are host authoring data and lower to concrete device descriptors before execution.

Conservative quadratic finite-cell boundary Hamiltonian declaration.

Target boundary measure and quadratic strength for one finite cell type.

Read-only authoring snapshot of array values without encoding field size in its type.

Dense multi-cell raster whose runtime type is independent of the number of cells.

A semantic finite-cell raster used only to construct a problem's initial state.

A declared finite-cell property with explicit scope, initialization, lifecycle, persistence, visibility, and optionality semantics. Unsupported lifecycle behavior is represented by an explicit rejecting CorePotts policy, never by missing storage.

One cell-type-indexed property column produced by Level 2 lowering.

A named finite-cell category. It is never a runtime cell-type index.

Cell-type sensitivity bindings for a named prescribed-field chemotaxis drive.

Inclusive finite value range checked during authoring and initialization.

One inspectable normalized declaration and its lowering-relevant contract.

One explicit semantic dependency from a consumer to a provider.

One structured diagnostic emitted at a named validation stage.

Scheduled binary finite-cell division with an explicit geometry policy.

Exact conservative penalty on each finite cell's major-axis RMS extent.

Target major-axis RMS extent and quadratic strength for one finite cell type.

Digest of semantic meaning plus the selected execution contract.

First-class fluctuating/HST finite-cell boundary-tension declaration.

First-class fluctuating-volume mechanical declaration, distinct from the exact constraint.

Scheduled immediate removal of finite cells into one declared medium.

Inspectable, host-only result of lowering one normalized Level 2 model.

A named medium domain, distinct from a finite CellType.

A semantic medium raster used only to construct a problem's initial state.

An immutable reusable bundle of declarations with a lexical namespace.

Public inspectable summary of normalized meaning and its complete expansion.

Explicitly name a direct CorePotts component when more than one instance is composed.

An immutable hierarchical namespace used by biological and component identities.

Typed immutable normalized meaning shared by reports, fingerprints, and lowering.

Canonical pair identity for directed or symmetric scientific laws.

Typed pairwise scientific values with explicit symmetry and missing-pair behavior.

Persistent Julia-native Level 2 biological model.

Immutable Level 2 snapshot of a cell-centered prescribed scalar field.

Exact global finite-cell connectedness constraint; omit it to permit fragmentation.

One simultaneous per-cell property addition at an integer-MCS lifecycle boundary.

Typed origin record for one normalized declaration.

Canonical semantic digest independent of source paths and declaration order.

Portable description of normalized meaning; deliberately not executable serialization.

A semantic name whose namespace is independent of source and declaration order.

Scheduled decrement of a target property until CorePotts retires the shrunken cell.

Optional source position captured by a future Level 1 spelling; never fingerprinted.

Scheduled finite-cell type transition at an integer-MCS boundary.

Explicitly declare that a property has no value-range invariant.

Immutable collection of all independent diagnostics found in one validation pass.

Conservative quadratic finite-cell volume Hamiltonian declaration.

Target and strength values used by volume constraint declarations.

Convenience spelling for deterministic finite-cell target-volume growth.

Compose declarations or fragments without assigning precedence to argument order.

Return a new model with one declaration appended; the original remains unchanged.

Return CorePotts's public, allocation-free host compatibility preflight report.

Execution identity for cache keys, reports, and exact-replay qualification.

lower(model; dimensions, spacing)

Normalize and lower a Level 2 model into public CorePotts scientific values. This operation is host-only and performs no backend allocation or kernel compilation.

problem(model, shape, layouts...; capacity, tspan, seed, ...)

Construct the single public CorePotts/SciML PottsProblem from a Level 2 model and typed initial layouts. No PottsToolkit runtime wrapper is introduced.

Return a new model without the declaration of identity.

Replace exactly one declaration by semantic identity.

Return a stable semantic manifest for comparison, provenance, and paper artifacts.

The manifest intentionally declares :not_claimed reconstruction: runtime checkpoints remain a CorePotts concern, and executable model serialization requires a separate opt-in protocol.

Validate model-instance facts without compiling a backend or allocating device storage.

Reusable Level 2 single-cell chemotaxis model for one fixed gradient profile.

Construct an executable fixed-gradient chemotaxis reference problem.

Reusable two-population differential-adhesion Level 2 model.

Construct a deterministic mixed two-population differential-adhesion problem.

Modern 2D/3D fluctuating droplet with explicit contact energy.

Reusable elongation-driven endothelial-network model.

The elongation term is the exact conservative major-axis RMS Hamiltonian. Connectivity is an independent optional constraint: disabling it makes fragmentation valid model behavior.

Construct a deterministic sparse endothelial seed problem in two or three dimensions.

Reusable growth/division/repulsion model for a one-cell monolayer seed.

Construct an executable growth/division/repulsion monolayer problem.

Modern fluctuating-volume reference used by thermodynamic verification.