Skip to main content

Module skl2

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§

ActuationPathwayRecord
Musculotendon / hydraulic / cuticle actuation pathway descriptor (48B).
EpistemicProvenanceWord
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]
LoopClosureConstraintRecord
Closed-chain loop closure constraint (e.g. radius-ulna, pelvis-sacrum, arthropod linkage) (64B).
SkeletalSectionPayload
Decoded SKL2 biological skeletal payload supporting lossless v1 (32B) and v2 (64B) joints.
Skl2JointDescriptorV1
Legacy SKL2 v1 joint descriptor (32 bytes, little endian).
Skl2JointDescriptorV2
SKL2 v2 64-byte cache-line-aligned biological joint descriptor.
Ssm1BasisHeader
Statistical Shape Model (SSM1) basis header (32B).
Ssm1ModeWeight
Single Statistical Shape Model principal component mode descriptor (16B).
SwingTwistConeLimits
Swing-twist anatomical cone joint limits in radians (16 bytes).
TopologicalLandmarkRecord
Topological surface landmark pinned to mesh face barycentric coordinates (32B).

Enums§

KinematicSolverRegime
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.