Glossary#

A shared vocabulary across the three layers of the Microrobotics Simulation Framework. Terms link in from any page that uses the {term}`Name` MyST role; with sphinx-tippy enabled, hovering the link pops up the definition without leaving the page.

This page is single-source-of-truth in the MICROROBOTICA repo at docs/glossary.md. Identical mirrors live in MADDENING/docs/glossary.md and MIME/docs/glossary.md, kept in sync by MICROROBOTICA/scripts/sync_glossary.py.

Aitken acceleration#: A scalar relaxation factor (re-estimated each iteration from the residual sequence) that speeds up Gauss-Seidel / Jacobi convergence — cheap, no Jacobian needed.
Anatomical regime#: The set of physiological bounds (compartment, flow regime, pH, viscosity, temperature) under which a MIME asset has been validated. Enforced at load time before a simulation can run.
ASME V&V 40#: Verification & Validation 40-2018 — the ASME standard that defines the COU framing and the credibility levels expected of medical-device computational models.
Boundary inputs#: The data a Node receives from its upstream neighbours on a given Graph step — the values flowing in along its incoming Edges.
Bouzidi scheme#: An interpolated bounce-back boundary condition for LBM that places curved walls accurately between lattice nodes, instead of stair-stepping them onto the grid. Improves confined-flow fidelity.
CFL number#: Courant–Friedrichs–Lewy number — a dimensionless stability limit for explicit time-stepping: information must not cross more than one grid cell per step. Exceeding it makes a solver blow up; it bounds the timestep of MIME’s fluid nodes.
ComponentMeta#: The compile-time annotation MICROROBOTICA attaches to every interface, capturing intended use, verification status, and SOUP classification for IEC 62304 compliance.
COU#: Context Of Use — the FDA/ASME V&V40 framing of “what question is this simulation answering, and how much accuracy does that demand?” Drives per-node verification rigour.
Coupling#: The strategy by which mutually dependent nodes exchange data within a single graph step. MADDENING ships Gauss-Seidel and Jacobi coupling with Aitken acceleration and IQN-ILS.
CRBA#: Composite-Rigid-Body Algorithm — an O(n²) method for computing a robot’s joint-space mass matrix. Used by MIME’s RobotArmNode.
CSF#: Cerebrospinal fluid — the clear fluid in the brain ventricles and spinal canal. A primary target environment for the microrobots MIME models; its flow and viscosity define one Anatomical regime.
Cycle staggering#: How MADDENING handles feedback loops in the graph: a cyclic dependency is broken into an iterative Gauss-Seidel sweep rather than rejected, so strongly coupled subsystems still compile.
DeepONet#: Deep Operator Network — a neural architecture that learns function-to-function mappings (operators). MADDENING uses it as a Surrogate family for nodes that map fields to fields.
Defect correction#: An iterative scheme that solves a hard problem by repeatedly solving an easier approximate one and correcting with the residual (“defect”). MIME uses it to add fidelity to fast fluid nodes without paying the full solver cost every step.
Dipole response#: The force and torque a permanent-magnet or paramagnetic body experiences in an external field gradient. Modelled by MIME’s PermanentMagnetResponseNode.
Edge#: A typed, unit-aware connection between two nodes that carries a named field (e.g. magnetic_force, orientation). Edges encode the data-dependency graph the Graph step walks.
EU MDR#: EU Medical Device Regulation (2017/745). MDR Annex II.2 in particular asks for design rationale, V&V evidence, and traceability — the same evidence the framework’s regulatory docs are organised around.
FNO#: Fourier Neural Operator — a spectral-domain neural operator that is often dramatically more sample-efficient than MLPs on PDE surrogates. Another Surrogate option in MADDENING.
Gauss-Seidel#: Iterative coupling scheme where each node updates with the latest values from its neighbours within an iteration. Converges faster than Jacobi for many stiff systems but is sequential within a step.
GNN correction#: Graph Neural Network residual learnt on top of the analytical Stokeslet (or IBM-FVM) prediction to absorb modelling error. Optional in MIME; toggled via the asset schema.
Graph step#: One full traversal of a MADDENING node graph that advances simulation time by dt. Compiles into a single XLA op so the whole step is autodiff-able.
GraphManager#: The MADDENING object you add nodes and edges to. It validates the wiring, runs the Topological sort, applies Coupling, and compiles the whole Graph step into one XLA program.
Helical UMR#: A UMR shaped as a helix and rotated by an external magnetic field, converting rotation into translation. See the de Jongh (2025) replication in MIME/docs/validation/umr_deboer2025/.
IB-LBM#: Immersed-Boundary Lattice Boltzmann Method — LBM with the microrobot represented as immersed-boundary forcing points rather than a body-fitted mesh. One of MIME’s confined-flow fluid nodes.
IBM-FVM#: Immersed Boundary Method on a Finite-Volume Mesh — MIME’s higher-fidelity option for confined low-Reynolds flow. The body is represented as forcing terms on a regular fluid grid rather than as a conforming mesh.
IEC 62304#: The international standard for medical device software lifecycle processes. MICROROBOTICA ships pre-wired traceability (ComponentMeta, anomaly registry, verification benchmarks) to keep audit overhead low.
IEC 62366-1#: The international standard for usability engineering of medical devices — the use-related risk and human-factors process that sits alongside IEC 62304 and ISO 14971.
IQN-ILS#: Interface Quasi-Newton with Inverse Least-Squares. A vector-valued acceleration scheme that builds a low-rank approximation of the Jacobian from past iterations — usually much faster than Aitken acceleration for strongly coupled multiphysics.
ISO 13485#: The international standard for a medical-device quality management system. Governs the processes around the software, complementary to the product-focused IEC 62304.
ISO 14971#: The international standard for risk management of medical devices. The framework’s hazard-hint metadata is structured to feed an ISO 14971 risk file.
Jacobi#: Iterative coupling scheme where every node updates from the previous iteration’s values, so all nodes can update in parallel. Slower convergence than Gauss-Seidel but trivially parallelisable.
JAX#: The Python array library MADDENING is built on: NumPy-style code with composable transforms — grad (autodiff), jit (JIT compilation to XLA), vmap (vmap), and scan.
JAX-traceable#: Code that JAX can trace into its IR: no Python-level side effects, no data-dependent Python control flow, no in-place mutation. Node update methods must be JAX-traceable — use jnp.where instead of if/else.
JIT compilation#: Just-In-Time compilation. Each MADDENING Graph step is jax.jit-compiled into a single XLA op the first time it is called; subsequent calls reuse the cached binary.
LBM#: Lattice Boltzmann Method — a fluid solver that evolves particle distribution functions on a regular lattice rather than solving the Navier-Stokes equations directly. Well suited to confined, complex-geometry flow.
Low-Re#: Low Reynolds number (Re ≪ 1). The regime where viscous forces dominate inertia — i.e. the regime nearly all microrobots in biological fluids operate in.
Lubrication correction#: A near-wall force correction added on top of bulk drag in confined flows. MIME’s LubricationCorrectionNode adds this to MLP-predicted resistance.
MDCG 2019-11#: EU Medical Device Coordination Group guidance on qualification and classification of software under the EU MDR. Determines whether and at what class a piece of software is regulated.
MDCG 2019-16#: EU Medical Device Coordination Group guidance on cybersecurity for medical devices under the EU MDR.
MimeNode#: MIME’s base node class — a SimulationNode whose NodeMeta is extended with domain metadata (biocompatibility, Anatomical regime, SOUP classification).
MLP#: Multi-Layer Perceptron — a stack of dense layers. The default Surrogate architecture for short-range physics nodes such as MLPResistanceNode.
Momentum exchange#: The standard way to read the hydrodynamic force on an immersed body out of an LBM simulation: sum the momentum transferred as distribution functions bounce off the body’s boundary links.
Multi-rate#: A scheduling mode where different nodes advance at different dts, reconciled by a GCD-based scheduler. Used for stiff subsystems that need a smaller step than the rest of the graph.
Node#: The fundamental unit of computation in a MADDENING graph: a pure function (state, dt, boundary_inputs) -> new_state. Subclassed in MIME to add physics- and biology-specific metadata.
NodeMeta#: The compliance-metadata record attached to every MADDENING SimulationNode: stability level, validated regimes, references. MIME’s MimeNode extends it with biomedical fields; MICROROBOTICA’s ComponentMeta is the IDE-side analogue.
Notified Body#: The independent organisation that audits a manufacturer and its technical documentation before a medical device may be CE-marked under the EU MDR.
OpenUSD#: Open Universal Scene Description — Pixar’s open scene-graph format and composition engine. The framework’s interchange format: MADDENING serialises graphs to USD, MICROROBOTICA composes and renders them via USD layers.
PI controller#: A Proportional–Integral feedback controller. In MADDENING’s adaptive timestepper it shrinks/grows dt based on the current Richardson extrapolation error and its trend across recent steps — gentler than a pure proportional rule.
PISO#: Pressure-Implicit with Splitting of Operators — a segregated pressure–velocity solver for incompressible flow, used by MIME’s finite-volume (IBM-FVM) fluid node.
Pure function#: A function whose output depends only on its inputs and which has no side effects. MADDENING nodes are pure functions of (state, boundary_inputs, dt); this is what makes them JAX-traceable and safe to vmap.
pybind11#: Header-only C++ ↔ Python binding generator. MICROROBOTICA ships one microrobotica C++ library and exposes it both to the Qt app and to the embedded scripting console via pybind11.
Quasi-Newton#: A family of iterative solvers that approximate the Jacobian from past iterates instead of computing it directly. IQN-ILS is the quasi-Newton scheme MADDENING uses to accelerate Coupling.
Reynolds number#: The dimensionless ratio of inertial to viscous forces in a flow. Microrobots operate at Low-Re (Re ≪ 1), where viscosity dominates and motion is effectively time-reversible.
RFT#: Resistance-Force Theory — a fast analytical model for slender-body propulsion in Low-Re flow: drag is decomposed into components parallel and perpendicular to the body. Used as a cheap baseline against the full hydrodynamic nodes.
Richardson extrapolation#: Run a step at two different dts and combine the results to estimate the truncation error and a higher-order solution. MADDENING uses it to drive an adaptive timestepper.
RNEA#: Recursive Newton–Euler Algorithm — an O(n) method for robot inverse dynamics (joint torques from motion). Paired with CRBA in MIME’s robot-arm nodes.
ROS#: Robot Operating System. The hardware-integration bridge: the MICROROBOTICA IDE can publish or subscribe to ROS topics so a simulation can drive (or be driven by) a real robotic platform.
SaMD#: Software as a Medical Device — software that is itself a medical device, rather than software embedded in hardware. The regulatory category the simulation framework’s downstream uses fall under.
SBOM#: Software Bill of Materials — a machine-readable inventory of every dependency in a build. MADDENING emits one (CycloneDX format) so downstream SOUP analysis has a complete component list.
Schwarz coupling#: A domain-decomposition method: two solvers covering overlapping sub-regions exchange boundary values and iterate to agreement. MIME uses it to couple a boundary-element near field to an LBM or FVM far field.
SimulationNode#: The MADDENING base class every physics block subclasses. It declares an initial_state and an update(state, boundary_inputs, dt) method — see Node.
SkyPilot#: Open-source multi-cloud orchestration framework. MADDENING uses it to provision GPU VMs (RunPod, Lambda, AWS, GCP) for distributed graph execution and surrogate training.
SOUP#: Software Of Unknown Provenance — an IEC 62304 term for any third-party software included in a medical device. Each SOUP needs a documented classification and risk analysis.
Step-out frequency#: The rotation rate above which a magnetically driven UMR can no longer keep up with the rotating field and desynchronises — its propulsion speed collapses past this point. A key validation metric for Helical UMR experiments.
Stokeslet#: The fundamental Green’s function of the Stokes equations: the flow field produced by a point force in a viscous, low-Reynolds fluid. MIME uses regularised Stokeslets for confined low-Re hydrodynamics.
Surrogate#: A neural network (MLP / DeepONet / FNO) trained to mimic a slow physics node so it can be hot-swapped in at runtime. See surrogates/ in MADDENING.
Topological sort#: The ordering of graph nodes such that every edge points from earlier to later. MADDENING’s GraphManager topologically sorts each step; cycles are broken by cycle staggering (run them iteratively under Coupling).
UMR#: Untethered Microrobot — a microscale device propelled and steered by external fields rather than wires. The framework’s reference workload.
USD layer#: One of the three Pixar OpenUSD layers MICROROBOTICA uses to compose a scene: the immutable anatomy base, the simulator-written results layer, and the user override layer. Output never overwrites anatomy.
Verification benchmark#: A reproducible test that checks a node or graph against a known analytical solution or reference dataset. Every MADDENING / MIME node ships verification benchmarks; their results feed the audit trail.
vmap#: jax.vmap — automatic vectorisation. Lets you run the same Graph step across a batch of initial conditions (or parameters) with no manual loop and no per-instance compilation.
WebRTC#: The browser-native real-time streaming protocol. MADDENING uses it to push rendered viewport frames from a remote GPU VM to a local browser or to the MICROROBOTICA IDE.
Womersley number#: A dimensionless number for pulsatile flow, comparing the oscillation frequency to viscous diffusion. It characterises time-varying physiological flows such as pulsing CSF.
XLA#: Accelerated Linear Algebra — the optimising tensor-program compiler JAX targets. XLA emits CPU / GPU / TPU code from JAX’s tracing IR.
ZMQ#: ZeroMQ — the message-passing library MADDENING uses to wire distributed graph fragments together and to stream graph state to visualisation clients.