Expand description
SKL2: versioned biomechanical skeletal joint descriptors (v1 32B / v2 64B), loop-closure constraints, topological landmarks, actuation pathways, SSM1 morphable basis descriptors, and bit-packed epistemic provenance.
All records are little-endian and bytemuck::{Pod, Zeroable} with explicit
padding and CRC-32C integrity words. Decoding validates record alignment,
bounds, and the 42 MB container budget before returning descriptors.
Structs§
- Actuation
Pathway Record - Musculotendon / hydraulic / cuticle actuation pathway descriptor (48B).
- Epistemic
Provenance Word - 32-bit bit-packed epistemic provenance word per Section 9.2:
[3b status | 5b method_class | 3b observer_role | 3b stability_class | 10b freshness_q10 | 8b confidence_q8] - Loop
Closure Constraint Record - Closed-chain loop closure constraint (e.g. radius-ulna, pelvis-sacrum, arthropod linkage) (64B).
- Skeletal
Section Payload - Decoded SKL2 biological skeletal payload supporting lossless v1 (32B) and v2 (64B) joints.
- Skl2
Joint Descriptor V1 - Legacy SKL2 v1 joint descriptor (32 bytes, little endian).
- Skl2
Joint Descriptor V2 - SKL2 v2 64-byte cache-line-aligned biological joint descriptor.
- Ssm1
Basis Header - Statistical Shape Model (
SSM1) basis header (32B). - Ssm1
Mode Weight - Single Statistical Shape Model principal component mode descriptor (16B).
- Swing
Twist Cone Limits - Swing-twist anatomical cone joint limits in radians (16 bytes).
- Topological
Landmark Record - Topological surface landmark pinned to mesh face barycentric coordinates (32B).
Enums§
- Kinematic
Solver Regime - Governing mechanical solver regime for a structural element / joint.
Constants§
- SKL2_
HEADER_ LEN - SKL2 fixed header length in bytes.
- SKL2_
JOINT_ FLAG_ EXOSKELETAL - SKL2_
JOINT_ FLAG_ HYDROSTATIC - SKL2_
JOINT_ FLAG_ LOOP_ ANCHOR - SKL2_
JOINT_ FLAG_ SYMMETRIC - Joint-level descriptor flags.
- SKL2_
JOINT_ FLAG_ VESTIGIAL - SKL2_
MAGIC - 4-byte magic identifier for SKL2 payloads.
- SKL2_
MAX_ CONTAINER_ BYTES - Global QualiaDB 42 MB payload sentinel.
- SKL2_
MAX_ JOINTS - Maximum joint descriptors permitted in a single SKL2 payload (Tier-0 limit).
- SKL2_
NONE_ INDEX - Sentinel index denoting no parent / no partner / no linked record.
- SKL2_
VERSION_ 1 - SKL2 format version 1 (32-byte joint descriptor).
- SKL2_
VERSION_ 2 - SKL2 format version 2 (64-byte cache-line-aligned joint descriptor).
- SSM1_
MAGIC - 4-byte magic identifier for Statistical Shape Model basis descriptors.