Skip to content

Reference

Quick tables. variants() and tasks() are the live source of truth.

Node presets

symbolfamilystatus
:falandays_base (:falandays)Falandaysstable baseline (authors-faithful)
:falandays_extendedFalandaysbase + noise + Watts–Strogatz + Dale
:falandays_noisy / _ablated / _hemispheric / _oosawa / _dendritic / _spatial / _delayedFalandaysexperimental variants
:compartmental_dense / _structuredCTRNNevolved (required)
:sornSORNexperimental
:null_randomcontrolrandom-output null baseline (sanity floor)

Tasks

:wall, :tracking, :pong, :pong_hitrate, :cartpole (+ _hard / _swingup / _long), :torus, :forage.

Ablations

:freeze_plasticity, :zero_recurrent, :clamp_target, :disable_vision (cross-family perturbations), plus the compartmental :reset_dendrites, :no_soma_back, :no_hillock_back.

Sweep config schema

[sweep] # id, mode = one_at_a_time | factorial, seeds = [...], max_cells
[baseline] # node, task, N, ticks — the canonical setup (see below)
[axes] # "node.<p>" / "env.<p>" / "drive.<p>" / "task.<p>" / "ablation" / "seed" -> [values]
[analytics] # measures = [...] — see the full set below

See Tooling for the walkthrough and sweep --list-axes <node> <task> to discover what’s tunable.

[baseline] keys — the canonical setup

The [baseline] table fixes the setup that every axis then perturbs. It accepts a small set of canonical scalar keys plus any dotted axis key; the dotted keys and the env.* / node.* / drive.* knobs pass straight through to the corresponding simulate(...) kwargs (so anything a run accepts, a baseline can pin).

Canonical scalar keys:

keymeaning
nodenode preset symbol (default falandays_base)
tasktask symbol (default wall)
N (alias n_nodes)reservoir size
ticksrollout length
windowmetric / liveness window (defaults to ticks, or the task default for swarm tasks)
n_agentsswarm population size (swarm/forage tasks)
seed_base (alias seed)base seed
body / drivebody and drive preset symbols
ablationablation symbol applied to the baseline

Common dotted pass-through knobs (forage / swarm):

keymeaning
"env.vision_range"max conspecific/source vision distance
"env.source_gain"forage source bank gain
"env.conspecific_vision"whether agents see each other (true / false)
"env.capture_radius"forage capture radius
"env.sensory_noise"sensory noise level

[analytics] measures — the full set

measures selects which analytics are computed per cell (default ["sigma_mr", "spectral_radius", "liveness"]). Valid names:

measurewhat it records
sigma_mrpooled branching ratio (MR)
sigma_mr_nodeper-agent reservoir branching
sigma_mr_agentagent-scale turn-event branching (per ensemble observable)
dist_to_sourcemean distance to forage source
forage_scoreforaging performance score
spectral_radiusdominant recurrent-eigenvalue magnitude
susceptibility_nodenode-scale synchrony susceptibility
susceptibility_agentagent-scale polarization susceptibility
correlation_lengthvelocity-fluctuation correlation length
contact_clusterscontact-graph connected-component summaries
livenessrun liveness (already in the base columns)
regimediscrete swarm-regime label (+ polarization / milling / speed)

contact_clusters emits cluster_n_components, cluster_largest_component_frac, and cluster_mean_component_size; regime emits regime_polarization, regime_milling, and regime_speed alongside regime. The aliases clusters, cluster_stats, and contact_graph_clusters all canonicalize to contact_clusters.