Skip to main content

Module spatial_predicates

Module spatial_predicates 

Source
Expand description

Canonical .q42 spatial, volumetric, and multi-sensory ontological predicates (§3.6.2). Canonical .q42 spatial, volumetric, and multi-sensory ontological predicates (§3.6.2 / §2.8).

Provides compile-time q_hash constants and zero-heap NQuin constructors/decoders for the 6 canonical predicate families (28 predicates total):

  • Multi-scale spatial & topological predicates (geo:*)
  • Volumetric & container sidecar predicates (q42:*)
  • Kinematic, biomechanical & botanical predicates (kin:*, bio:*, mech:*, phys:*)
  • Sensory, acoustic & optical predicates (sens:*)
  • Epistemic & bifurcation predicates (epi:*)
  • KV-cache & LLM grounding predicates (llm:*)

Constants§

ALL_SPATIAL_SENSORY_PREDICATES
All 28 canonical predicates defined by §3.6.2.
PBIO_HAS_HILL_MUSCLE_ALIAS
PRED_BIO_HAS_ALLOMETRIC_LAW
PRED_BIO_HAS_HILL_MUSCLE
PRED_EPI_HAS_BIFURCATION_WING
PRED_EPI_HAS_CONSENT_RECEIPT
PRED_EPI_HAS_QUANTUM_RANGE
PRED_GEO_HAS_PACKED_BBOX_MAX
PRED_GEO_HAS_PACKED_BBOX_MIN
PRED_GEO_HAS_PACKED_CENTROID
PRED_GEO_HAS_PORTAL_LINK
PRED_GEO_HAS_SCALE_TIER
PRED_GEO_HAS_TOPOLOGY_CLASS
PRED_GEO_HAS_VERTEX
PRED_KIN_HAS_JOINT_PARENT
PRED_KIN_HAS_PGA_MOTOR
PRED_LLM_HAS_KV_SLOT
PRED_LLM_HAS_SPARSE_ATOM_CODE
PRED_MECH_HAS_FATIGUE_LAW
PRED_PHYS_HAS_BOND_PORT
PRED_Q42_HAS_CLUSTER_DAG
PRED_Q42_HAS_CONTAINER_10D
PRED_Q42_HAS_EMF_CHUNK
PRED_Q42_HAS_HMC_BUNDLE
PRED_Q42_HAS_M64_CHUNK
PRED_Q42_HAS_SPECTRAL_SHEET_V3
PRED_SENS_HAS_HOA_ORDER
PRED_SENS_HAS_REFRACTIVE_INDEX
PRED_SENS_HAS_SOFA_HRTF
PRED_SENS_HAS_STOKES_VECTOR

Functions§

decode_container_link_quin
Decode container link payload: (container_hash, section_offset, chunk_records).
decode_epistemic_quin
Decode epistemic quin: returns quin.object.
decode_kinematic_quin
Decode kinematic quin: (parent_or_type_hash, motor_slot).
decode_llm_grounding_quin
Decode LLM grounding quin: (kv_slot, parent_page_id).
decode_sensory_quin
Decode sensory quin: (asset_hash, hoa_order_or_band).
decode_spatial_coord_quin
Decode coordinates and scale tier from a spatial coordinate NQuin.
make_container_link_quin
Construct an NQuin linking a subject to a binary container section (.10d, .m64, .emf, etc.).
make_epistemic_quin
Construct an NQuin linking a subject to an epistemic quantum range or consent receipt.
make_kinematic_quin
Construct an NQuin for a kinematic or physical property (joint parent, PGA motor slot).
make_llm_grounding_quin
Construct an NQuin linking a volumetric node to an LLM KV slot and prompt page.
make_sensory_quin
Construct an NQuin for sensory or acoustic attachments (Ambisonics HOA order, SOFA HRTF).
make_spatial_coord_quin
Construct an NQuin for a 3D spatial coordinate or bounding box bound.
pack_coord_with_scale
Pack 3D floating-point coordinates (x, y, z) into a 60-bit payload + 3-bit scale tier.
scale_tier_step_meters
Step in meters for scale tier 0..=7.
unpack_coord_with_scale
Unpack 60-bit payload + 3-bit scale tier into (x, y, z, scale_tier).