Skip to main content

Crate numen

Crate numen 

Source
Expand description

numen — field truth, evaluation, and authoring for the Seiche substrate.

A numen is a pervading influence, the presence felt in a place. This crate is that influence as data: the portable definitions of the fields an app lays over its graph, and the couplings that say how elements respond to them. numen owns field definitions, the analytic evaluator, registries and projection composition, plus opt-in Rhai authoring and Burn lowering. Seiche owns force laws and integrates them over Rapier bodies.

Fields are the third graph primitive, beside nodes and edges. Where the node and edge primitives live in the content substrate (chartulary), the field primitives live here, at the same portable tier, because a field is spatial (it reads positions). The types are numen’s; the truth is the graph realm’s, persisted beside nodes and edges as content.

The default path is plain, serde-serializable data plus analytic evaluation with no GPU or host dependencies. Rhai and Burn stay behind named opt-in features.

Re-exports§

pub use coupling::COUPLING_VOCAB;
pub use coupling::Coupling;
pub use coupling::CouplingResponse;
pub use coupling::NodeSelector;
pub use edge_path::EdgePath;
pub use edge_path::EdgePathRule;
pub use eval::eval_scalar;
pub use eval::eval_vector;
pub use eval::grad_scalar;
pub use field::CouplingId;
pub use field::Field;
pub use field::FieldDefinition;
pub use field::FieldExtent;
pub use field::FieldId;
pub use field::FieldLifecycle;
pub use field_ast as ast;
pub use field_ast::Falloff;
pub use field_ast::ScalarField;
pub use field_ast::VectorField;
pub use projection::FieldProjection;
pub use projection::FieldProjectionBuilder;
pub use registry::FieldDef;
pub use registry::FieldRegistry;
pub use responsive_path::MAX_COMPATIBILITY_KEY_BYTES;
pub use responsive_path::MAX_CONTROL_POINTS;
pub use responsive_path::MAX_FIELD_AST_DEPTH;
pub use responsive_path::MAX_FIELD_AST_NODES;
pub use responsive_path::MAX_FIELDS;
pub use responsive_path::MAX_ITERATIONS;
pub use responsive_path::PathField;
pub use responsive_path::ResponsivePath;
pub use responsive_path::ResponsivePathConfig;
pub use responsive_path::ResponsivePathError;
pub use responsive_path::evaluate_responsive_paths;

Modules§

coupling
Coupling — how nodes respond to a field. A coupling is field -> NodeSelector (a dynamic set) x response x strength.
edge_path
EdgePath / EdgePathRule — how an edge’s path is generated between its two endpoints, optionally traced through a vector field.
eval
Pure-Rust evaluator for numen field expressions.
field
The Field truth primitive — fields as a third graph element beside nodes and edges (the field-system extraction decision; this is its step-3 kernel slice).
field_ast
Portable field-expression AST — kernel truth.
projection
FieldProjection — per-canvas bundle of fields, couplings, and edge-path rules with an evaluation registry.
registry
Per-projection field registry.
responsive_path
Bounded, view-local flexible paths for the independent P5 link-dynamics probe.