/ 
Sim-OPT-0.997
/ Sim::OPT::StructureDesign

NAME

Sim::OPT::StructureDesign - explicit transformations of Sim::OPT design lattices

DESIGN VOCABULARY

Evaluate points on the current design lattice. This remains Sim::OPT's job; this module records the lattice on which the search is performed.

zoom_in

Reduce scope around an incumbent while decreasing grid spacing (increasing resolution). The local workspace is centred on the incumbent when the requested window fits inside the parent scope. At a parent boundary, the whole local window is shifted inward so that reduce_scope remains a subset of the parent scope while preserving the requested number of local levels and fine-grid resolution.

zoom_out

Embed results obtained on a finer local lattice back into a finer global lattice covering exactly the parent scope. Existing parent levels map by j' = 1 + r (j - 1); zooming introduces no coordinate-origin offset. The resulting global lattice may contain unsampled points (voids).

pan

Move the sampled window while preserving its scope and resolution. A pan can be combined with zooming, but is represented separately in the manifest.

MEMORY RECONSTRUCTION MODES

plan_memory_reconstruction() supports two explicit reconstruction semantics. The selected mode is a scientific choice and should normally be written in the procedure as reconstruction_mode.

legacy_medoid_only

This mode reproduces the historical medoid-only reconstruction used by the first recall runs. The abstraction medoids are the retained cues. A compact shared lattice is derived from their positions, every medoid is an explicit star centre, and optional star_divisions adds evenly distributed auxiliary centres over that shared recalled lattice. No retained experiential cloud is required or used.

experiential_cloud

This mode implements medoid-anchored experiential recall. In addition to the frozen abstraction, memory_packet must contain cluster-conditioned direct experience produced by the retention step. The retained clouds position the compact recalled scope, direct remembered rows seed the surrogate, medoids remain mandatory privileged centres, and optional cloud_star_divisions selects additional star centres from actual retained experiences within their frozen categories.

Compatibility when the switch is omitted

For reproducibility of procedures written before the explicit switch existed, mode inference is intentionally conservative: a call carrying memory_packet is interpreted as experiential_cloud; otherwise it is interpreted as legacy_medoid_only. New procedures should nevertheless state the mode explicitly so that the scientific reconstruction semantics are visible in the procedure itself.

SAFETY MODEL

Planning is pure and non-destructive. Workspace creation refuses to overwrite an existing destination. Merge/renaming should be executed only from a validated manifest; short numeric IDs must be treated as identifiers, never replaced by a blind text substitution.