nx_realism_score.nx
buildroot/runtime/nx_realism_score.nx
about
nx_realism_score.nx -- end-to-end pipeline realism gate ("matches reality").
module: nishi-core.perception.realism_score
depends: nishi-core.perception.profile + nishi-core.perception.judge +
nishi-core.perception.transducer_characterizer + nishi-core.perception.signal_compensator +
nishi-core.perception.codec_perceptual_grader + nishi-core.io.syscalls
disk_kb: 5
capability: PERCEPTION
wired_status: PARTIAL_WIRED
MISSING_CAPABILITIES:
- SOURCE_REAL_CAPTURE_LOAD (load the calibrated reference recording
of the actual reality the pipeline is trying to reproduce)
- PIPELINE_ROUND_TRIP (source -> capture -> encode -> network -> decode
-> render -> physical transducer -> verification mic -> compare)
- DELTA_COMPUTE (frequency-domain + temporal-domain + spatial-domain
comparison; needs nx_fft + image-domain comparison primitives)
- PER_AXIS_REALISM_SCORE (decompose pipeline delta into perceptual axes
matching nx_perceptual_judge's 5-axis breakdown)
- LATENCY_DIMENSION (separate axis: was the pipeline FAST enough that
real-time interactivity preserved? composes with first-byte-of-call
latency from voice codec)
license_tier: PUBLIC_NISHI_SUBSTRATE
genealogy_id: feedback-multi-species-perceptual-substrate-not-anthropocentric_2026 +
feedback-substrate-primitives-meta-not-one-off_2026 +
feedback-bits-up-exceed-never-match +
feedback-honest-perf-verdict-no-aspirational-claims +
feedback-end-to-end-bit-traceability-architecture +
nx_codec_perceptual_grader
User directive 2026-05-20: "make sure our video and audio and all that
codecs are truly s class best in the world so they match reality both
on a video with a person in our nishifamily.com/video for speed and
quality and same for audio."
THIS primitive measures whether the FULL pipeline (source capture ->
codec encode -> network transit -> codec decode -> compensator
pre-correction -> physical transducer -> air -> verification mic)
reproduces reality close enough that a declared target profile (e.g.,
dependencies 6 imports · 0 importers
imports: nx_syscalls.nxnx_perceptual_profile.nxnx_perceptual_judge.nxnx_transducer_characterizer.nxnx_signal_compensator.nxnx_codec_perceptual_grader.nx
imported by: nobody (leaf or entry point)
structs
| 122 | struct NxRealismScoreCard |
consts
| 69 | const NX_REAL_STAGE_SOURCE_CAPTURE: i64 = 1 // mic / camera input quality |
| 70 | const NX_REAL_STAGE_PREPROCESSOR: i64 = 2 // gain / noise-suppression / framing |
| 71 | const NX_REAL_STAGE_CODEC_ENCODE: i64 = 3 // compression loss |
| 72 | const NX_REAL_STAGE_PACKETIZER: i64 = 4 // framing for transport |
| 73 | const NX_REAL_STAGE_NETWORK_TRANSIT: i64 = 5 // jitter / loss / reorder |
| 74 | const NX_REAL_STAGE_CODEC_DECODE: i64 = 6 // decompression |
| 75 | const NX_REAL_STAGE_JITTER_BUFFER: i64 = 7 // smoothing |
| 76 | const NX_REAL_STAGE_COMPENSATOR: i64 = 8 // signal compensator pre-correction |
| 77 | const NX_REAL_STAGE_TRANSDUCER_RENDER: i64 = 9 // DAC + amp + speaker imperfections |
| 78 | const NX_REAL_STAGE_ROOM_ACOUSTIC: i64 = 10 // reverb + reflections at listener |
| 79 | const NX_REAL_STAGE_LISTENER_BIOLOGY: i64 = 11 // species-perceptual-profile gate |
| 98 | const NX_REAL_VERDICT_S_CLASS: i64 = 5 // >= 90/100 all axes |
| 99 | const NX_REAL_VERDICT_A_CLASS: i64 = 4 // >= 80/100 all axes |
| 100 | const NX_REAL_VERDICT_B_CLASS: i64 = 3 // >= 70/100 all axes |
| 101 | const NX_REAL_VERDICT_C_CLASS: i64 = 2 // >= 60/100 all axes |
| 102 | const NX_REAL_VERDICT_D_CLASS: i64 = 1 // below 60 anywhere |
| 103 | const NX_REAL_VERDICT_F_NO_REFERENCE: i64 = 0 // no calibrated reference reality |
| 104 | const NX_REAL_VERDICT_DEPENDENCY_MISSING: i64 = -1 // PARTIAL_WIRED default |
functions
| 81 | func nx_real_stage_name(s: i64) -> *u8 |
| 106 | func nx_real_verdict_name(v: i64) -> *u8 |
| 147 | func nx_realism_score_evaluate_pipeline(pipeline_name_ptr: *u8, pipeline_name_len: i64, calls 1: nx_perceptual_profile_is_valid |
| 163 | func nx_realism_score_attribute_loss_to_stage(card_ptr: *NxRealismScoreCard, |
| 175 | func nx_realism_score_meets_s_class_gate(pipeline_name_ptr: *u8, pipeline_name_len: i64, calls 1: nx_perceptual_profile_is_valid |
| 191 | func nx_realism_score_register_reference_reality(reality_capture_hash_ptr: *u8, |
| 205 | func nx_realism_score_get_last_verdict() -> i64 |