Expand description
Typed candidate scientific EMF observations with explicit profile admission.
EMF full-profile codecs, semantic admission rules, and zero-heap envelope writers
covering canonical modes 0x0100..=0x0107 (with compatibility mapping for 0..=7).
Every measurement/model carrier preserves explicit units, calibration/evidence/provenance
links, frame conventions, and physical realizability checks; unsupported profiles fail closed
without recasting, and dose/biofield storage never emits universal safety verdicts.
Structs§
- Acquisition
Original Entry - A verified raw acquisition original entry (Mode
0x0104, Schemas 6/7). - Acquisition
Spec - BioContext
Spec - Biofield
Record - Brick
Layout - Calibration
Spec - Constitutive
Spec - Dose
Transport Record - EmfAcquisition
Registry - Mixed-domain registry composing EMF scientific profiles with raw acquisition storage.
- EmfMixed
Reader - Mixed-domain container reader admitting both EMF profiles and acquisition originals.
- Field
Chunk Input - Exact current128-byte records, borrowed immutably. encode_field_samples packs original f64 observations separately when a producer starts from native data.
- Field
Clock - Field
Document - Field
Frame - Field
Provenance - Field
Record - Field
Sample - Native observations; no guessed carrier, constitutive law, flux or confidence.
- Field
Write Limits - Frame
Pose - Active local-to-parent rigid pose (
rotation_xyzwunit Hamilton quaternion). - Grid
Layout - Grid
Spec - IqHeader
- IqPacket
View - Non-mutating zero-copy view over an admitted mode 0x0105 record preserving original bits.
- Jones
Vector - Complex transverse Jones vector
(Ex, Ey)in horizontal/vertical basis. - Limits
- Material
Spec - Model
Evidence Spec - Mueller
Record - Prepared
Field - Planning/storage fields borrow caller metadata/entry arenas and immutable source payloads. No reference to mutable payload staging escapes this prepare step.
- Profile
Chunk - Entire selected chunk verified and every admitted record checked. Invalid externally masked records return None, never invented valid-zero observations.
- Profile
Reader - A nonforgeable shared admission for the current EMF registry. Opening does not validate every payload; each chunk call verifies and admits that selected chunk. The caller may retain immutable returned chunks for hot access without rehashing.
- Profile
Registry - Admits all EMF v4 profiles and companion schemas (103, 105..=107, 132..=137).
- Profile
Response Validator - Resolves schema 132 key 7 (
response) to a typed Calibration (107) or auxiliary response descriptor (schema 3 -> schema 103) block with explicit units and normalization. - RayRecord
- Schema106
Transform - Qualified schema 106 4x4 transform supporting proper rigid and invertible affine maps.
- Spectral
Axis Spec - Spectrum
Record - Spectrum
Values - YeeParse
Policy - YeeRecord
Enums§
- Admitted
Mixed Entry - Admitted entry from a mixed-domain container: either typed EMF or raw acquisition original.
- Constitutive
Kind - Density
Target - Epistemic
Class - Error
- Extended
Mode Spec - Grid
Indexing - Harmonic
Sign - Mueller
Units - Phasor
Amplitude Kind - Signal
Kind - Spectral
Precision Profile - Transform
Kind - Transport
Species - Window
Kind
Constants§
- BAND_
COUNT_ 24 - BAND_
COUNT_ 28 - BIOFIELD_
MODEL_ URI - BIOFIELD_
PROFILE - BIO_
FLAG_ CARRIER - BIO_
FLAG_ POTENTIAL - BIO_
FLAG_ UNCERTAINTY - DOSE_
ALL_ VALID_ MASK - DOSE_
MODEL_ URI - DOSE_
PROFILE - DOSE_
VALID_ ABSORBED_ GY - DOSE_
VALID_ EQUIVALENT_ SV - DOSE_
VALID_ FLUENCE - DOSE_
VALID_ LET - DOSE_
VALID_ LINEAR_ ATTEN - DOSE_
VALID_ MASS_ ATTEN - DOSE_
VALID_ PHOTON_ ENERGY - DOSE_
VALID_ UNCERTAINTY - FIELD_
MODEL_ URI - FIELD_
PROFILE - FLAG_
LO_ PHASE_ KNOWN - IQ_
CONVENTION - IQ_
MODEL_ URI - IQ_
PROFILE - MAX_
IQ_ SAMPLES - MUELLER_
MODEL_ URI - MUELLER_
PROFILE - RAY_
MODEL_ URI - RAY_
PROFILE - SPECTRUM_
MODEL_ URI - SPECTRUM_
PROFILE - SPEED_
OF_ LIGHT_ M_ PER_ S - STFT_
FFT_ NORMALIZATION - VACUUM_
IMPEDANCE_ OHM - VACUUM_
PERMEABILITY_ H_ PER_ M - VACUUM_
PERMITTIVITY_ F_ PER_ M - VALIDITY_
MODEL_ URI - VALIDITY_
PROFILE - YEE_
MODEL_ URI - YEE_
PROFILE
Functions§
- absorbed_
dose_ gy - acquire_
biofield_ to_ emf - Encode bioelectric current-dipole records (
0x0107) into a self-admitted.emfv4 envelope. - acquire_
iq_ to_ emf - Encode a calibrated RF I/Q acquisition packet (
0x0105) into a self-admitted.emfv4 envelope. - acquisition_
rules - admit_
chunk - admit_
emf_ or_ acquisition_ entry - Admit a single entry as either a typed EMF profile chunk or an acquisition original entry.
- apply_
mueller - apply_
spectral_ response - Applies explicit instrument response weights per bin to spectral samples.
- bio_
context_ rules - build_
log_ band_ edges - Fills
out_edges(lengthband_count + 1) with deterministic log-spaced positive coordinates. - calibration_
rules - canonical_
emf_ mode - Explicit point-stream subset only. No constitutive/material/calibration,
- check_
complex_ nyquist_ band - Rejects base complex-baseband signals violating Nyquist bound
|bw| <= Fsunless explicitly admitted under a declared bandpass-sampling profile. - cloude_
coherency_ matrix - Builds Cloude 4x4 Hermitian coherency matrix
H(M) = (1/4) sum_{k,l} M_{kl} (sigma_k otimes sigma_l^*), returning(real_4x4, imag_4x4)with trace equal toM[0][0]. - cloude_
eigenvalues - Computes the 4 real eigenvalues of
H(M)(sorted descending) via exact 8x8 real symmetric Jacobi iteration over[[A, -B], [B, A]]. - constitutive_
model_ rules - convert_
carrier_ sign_ conjugate - Explicitly converts complex baseband between opposite RF carrier-sign conventions (
z -> conj(z)). - convert_
density_ hz - Converts frequency spectral density
S_f(per Hz) to angular (S_omega = S_f / 2pi), log-frequency (S_q = f * S_fforq = ln(f / f0)), or vacuum wavelength (S_lambda) Jacobian. - convert_
density_ wavelength_ to_ hz - coordinate_
transform_ rules - det_3x3
- dipole_
potential_ infinite_ homogeneous - Infinite homogeneous quasi-static point current dipole potential:
phi(r_obs) = (q . (r_obs - r_src)) / (4*pi * sigma * |r_obs - r_src|^3). Strictly fails closed at the singularity (|r_obs - r_src| <= 1e-12). - encode_
biofield_ records - encode_
dose_ records - encode_
field_ samples - encode_
iq_ packet - encode_
mueller_ records - encode_
yee_ records - energy_
density_ isotropic - energy_
density_ vacuum_ eb - equivalent_
dose_ sv - evaluate_
calibration - Evaluates linear calibration
scale * raw + offsetchecking[from, until)tick window. - evaluate_
instantaneous_ phasor - Evaluates
Re(F_tilde * exp(i * s * omega * t))for a 3-vector complex phasor. - extension_
rules - fft_
bins_ to_ ascending_ physical - Explicit permutation from native FFT order to strictly ascending physical frequencies (> 0 Hz).
Fails closed if any mapped frequency is
<= 0 Hzor if sign convention is not declared. - field_
entry_ slot - Initialize caller-owned entry slots; raw encoding rejects these until prepare fills them.
- field_
metadata_ len - integrate_
spectrum_ over_ axis - Integrates a spectral sample vector along an admitted
AxisViewrespectingPointDensity(trapezoid),BinIntegral(direct bin sum), orBinAverage(width-weighted sum). - invert_
3x3 - iq_
dft_ forward_ unscaled - Forward DFT preserving raw signed FFT bin ordering (
forward-unscaled-inverse-1/N). Does NOT sort bins or falsely attach schema 132 to signed baseband offsets. - iq_
idft_ scaled - Inverse DFT with exact
1/Nnormalization matchingforward-unscaled-inverse-1/N. - iq_
record_ crc32c - iq_
record_ stride - jones_
to_ mueller - Converts a complex 2x2 Jones matrix
J = re + i*imto its Mueller matrixM. - kev_
to_ joules - linear_
from_ mass_ attenuation - material_
binding_ contains - material_
binding_ rules - model_
evidence_ rules - open_
emf_ mixed_ container - Open an
.emfv4 container using the default mixed-domain registry. - open_
emf_ mixed_ container_ with_ registry - Open an
.emfv4 container using an explicit mixed-domain registry. - optical_
path_ delay_ seconds - peak_
to_ rms - photon_
uncollided_ fluence - Uncollided Beer-Lambert photon attenuation
Phi_out = Phi_in * exp(-mu * x). Rejects charged particles where stopping-power / CSDA transport applies instead. - polarization_
rules - poynting_
e_ cross_ h - poynting_
from_ eb_ vacuum - prepare_
field_ document - reconstruct_
rf_ real_ signal - Evaluates
s(t_n) = Re(z_n * exp(i * s * (2pi * f_c * (t_n - t_0) + phi_0))). Under canonicalHarmonicSign::MinusIwt,s = -1:I cos(theta) + Q sin(theta). - rms_
to_ peak - rotate_
mueller_ passive - Passive basis rotation:
R(theta_out) * M * R(-theta_in). - rotate_
stokes_ passive - Passive linear basis rotation of Stokes
[I, Q, U, V]by angletheta_rad. - signed_
baseband_ offset_ hz - Signed FFT bin baseband frequency offset in Hz without reordering stored bins.
- validate_
acquisition - validate_
band_ edges - Validates strictly ascending positive spectral bin edges (e.g. 25 edges for 24 bands, 29 for 28).
- validate_
bio_ context - validate_
calibration - validate_
constitutive_ model - validate_
coordinate_ transform - validate_
material_ binding - validate_
model_ evidence - validate_
yee_ extension - Validates Yee extension (
schema 103, mode2 | 0x0102), constitutive model completeness, auxiliary/boundary restart requirements, and staggered time offset arrays. - verify_
derivation_ schema7_ lineage - Verify derivation input binding when Schema 7 is attached to an entry.
- verify_
empirical_ join_ allowed - Prevents speculative models (
hypothesis,counterfactual,fictional) from silently joining or contaminatingempiricalbiofield/radiation evaluations. - verify_
mueller_ physical_ realizability - Verifies
M00 > 0, Stokes-cone physicality across pure basis inputs, and Cloude PSD (H >= 0). - verify_
source_ entry_ lineage - Verify that
derived_entry_indexdeclaressource_entry_indexin its provenance chain with matching BLAKE3 digest. - window_
weight - write_
extended_ envelope - Encodes an extended single-chunk EMF v4 envelope into
outputvia zero-heap staging and self-admits throughProfileReaderbefore final atomic copy. - yee_
cfl_ max_ dt_ seconds - Exact 3D Courant-Friedrichs-Lewy maximum stable time step for homogeneous isotropic cell.
- yee_
check_ cfl - Checks
dt_s <= dt_cfland returns the Courant numberS in (0, 1]. - yee_
discrete_ dispersion_ omega - Solves discrete 3D Yee plane-wave dispersion for angular frequency
omega (rad/s):sin^2(omega * dt / 2) = (c_mat * dt)^2 * sum_i sin^2(k_i * dx_i / 2) / dx_i^2. - yee_
step_ periodic - Advances a 3D staggered Yee lattice (
x + nx*(y + ny*z)) one full leapfrog step:H^{n+1/2} = H^{n-1/2} - (dt / mu) * curl_forward(E^n)followed byE^{n+1} = alpha * E^n + beta * (curl_backward(H^{n+1/2}) - J)with periodic wraps. - yee_
total_ energy_ j - Computes total electromagnetic energy across Yee cells using isotropic permittivity/permeability.