spatial6
Backend-agnostic 6D spatial vectors, transforms, and inertias for rigid-body dynamics. Spatial coordinates store angular components before linear components.
[]
= "1"
The crate provides MotionVector, ForceVector, MotionSubspace,
SpatialTransform, RigidBodyInertia, and ArticulatedBodyInertia.
| Feature | Backend |
|---|---|
builtin (default) |
Fixed Rust arrays |
std (default) |
Requests std support in enabled numeric dependencies |
nalgebra |
Native nalgebra vectors and matrices |
glam |
Native glam vectors and matrices |
serde |
Serialize/Deserialize for all public types |
| No default features | User-defined SpatialRepresentation |
Enable optional backends with features = ["nalgebra"] or features = ["glam"].
Enable features = ["serde"] for serialization support; combined with nalgebra
or glam, it also enables that backend's own serde integration so the
underlying vector/matrix types serialize too.
no_std
The library source is always no_std. Its default std feature enables std
support in enabled numeric dependencies. Disable default features for bare-metal
use and select a backend explicitly:
[]
= "1"
= false
= ["builtin"]
Use nalgebra or glam instead of builtin for those backends; add serde for
serialization. With no backend selected, provide a custom
SpatialRepresentation. Enabling std or serde alone does not select a backend.
The floating-point fallback is enabled automatically; no separate libm feature
is required.
With the supplied backends and f32/f64, the verified no_std operations do not
require a global allocator. Their serialization implementations use fixed
storage; custom representations, scalars, serialization adapters, and formatting
sinks determine their own resource requirements. Fixed storage grows with the
dimension of MotionSubspace<N> and does not imply a constant stack budget.
The library provides no panic handler and makes no panic-free or hard-real-time
execution claim.
Cargo unifies dependency features: another runtime dependency can enable std or alloc even when this dependency disables defaults. Inspect the final firmware graph with an explicit target, for example:
For hosted applications that disable defaults, add std explicitly to retain
the std-enabled numeric path. Otherwise the isolated graph uses libm,
which can change performance and rounding near validation thresholds. Algorithms,
validation rules, and public API are unchanged by this feature split; bitwise
reproducibility and identical decisions for every ill-conditioned boundary input
are not promised.
Downstream nalgebra/glam conversion features can also force glam's libm path
through feature unification even when std is enabled.
Examples
See the API documentation for usage and conventions,
and examples/ for worked algorithms built on these types:
composite rigid-body inertia, inverse dynamics via the Recursive Newton-Euler
Algorithm, and articulated-body inertia. Each of these three algorithms, plus
a minimal single-rigid-body case, is worked through all three backends in a
_nalgebra/_glam-suffixed sibling file (_builtin/no suffix is the
default), so switching backends can be seen changing only the storage type,
never the answer:
to_pose_parts() returns the local-to-reference rotation Q and the local
origin's position p in reference coordinates. Use from_pose_parts() to
rebuild a transform from those owned parts; the stored transform rotation and
translation remain the source-to-destination E/r representation.
let = transform.to_pose_parts;
let restored = from_pose_parts;
ArticulatedBodyInertia represents the current articulated inertia, including
the reduced symmetric operator produced by eliminating a joint acceleration
under a specified joint force. The core reduction uses only backend-agnostic
public operations:
let full = try_from?;
let u = full.apply;
let d = joint_motion.dot;
assert!;
let reduced = full.try_rank_one_updated?;
let child_in_parent = reduced.try_transformed?;
let accumulated = parent.try_combined?;
The aba_builtin example is a minimal fixed-base serial-chain ABA
forward-dynamics walkthrough using the public ArticulatedBodyInertia API.
Contributing
Install Rust (stable, including rustfmt and Clippy) and uv, then run:
Before submitting a change, run the same checks CI runs (which treats rustdoc warnings as errors):
License
Copyright 2026 Daisuke Nagao.
Licensed under either the MIT License or the
Apache License, Version 2.0, at your option
(MIT OR Apache-2.0). Copyright and SPDX license information is recorded in
Rust file headers.