Skip to main content

Module emf_profiles

Module emf_profiles 

Source
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§

AcquisitionOriginalEntry
A verified raw acquisition original entry (Mode 0x0104, Schemas 6/7).
AcquisitionSpec
BioContextSpec
BiofieldRecord
BrickLayout
CalibrationSpec
ConstitutiveSpec
DoseTransportRecord
EmfAcquisitionRegistry
Mixed-domain registry composing EMF scientific profiles with raw acquisition storage.
EmfMixedReader
Mixed-domain container reader admitting both EMF profiles and acquisition originals.
FieldChunkInput
Exact current128-byte records, borrowed immutably. encode_field_samples packs original f64 observations separately when a producer starts from native data.
FieldClock
FieldDocument
FieldFrame
FieldProvenance
FieldRecord
FieldSample
Native observations; no guessed carrier, constitutive law, flux or confidence.
FieldWriteLimits
FramePose
Active local-to-parent rigid pose (rotation_xyzw unit Hamilton quaternion).
GridLayout
GridSpec
IqHeader
IqPacketView
Non-mutating zero-copy view over an admitted mode 0x0105 record preserving original bits.
JonesVector
Complex transverse Jones vector (Ex, Ey) in horizontal/vertical basis.
Limits
MaterialSpec
ModelEvidenceSpec
MuellerRecord
PreparedField
Planning/storage fields borrow caller metadata/entry arenas and immutable source payloads. No reference to mutable payload staging escapes this prepare step.
ProfileChunk
Entire selected chunk verified and every admitted record checked. Invalid externally masked records return None, never invented valid-zero observations.
ProfileReader
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.
ProfileRegistry
Admits all EMF v4 profiles and companion schemas (103, 105..=107, 132..=137).
ProfileResponseValidator
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
Schema106Transform
Qualified schema 106 4x4 transform supporting proper rigid and invertible affine maps.
SpectralAxisSpec
SpectrumRecord
SpectrumValues
YeeParsePolicy
YeeRecord

Enums§

AdmittedMixedEntry
Admitted entry from a mixed-domain container: either typed EMF or raw acquisition original.
ConstitutiveKind
DensityTarget
EpistemicClass
Error
ExtendedModeSpec
GridIndexing
HarmonicSign
MuellerUnits
PhasorAmplitudeKind
SignalKind
SpectralPrecisionProfile
TransformKind
TransportSpecies
WindowKind

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 .emf v4 envelope.
acquire_iq_to_emf
Encode a calibrated RF I/Q acquisition packet (0x0105) into a self-admitted .emf v4 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 (length band_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| <= Fs unless 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 to M[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_f for q = 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 + offset checking [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 Hz or 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 AxisView respecting PointDensity (trapezoid), BinIntegral (direct bin sum), or BinAverage (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/N normalization matching forward-unscaled-inverse-1/N.
iq_record_crc32c
iq_record_stride
jones_to_mueller
Converts a complex 2x2 Jones matrix J = re + i*im to its Mueller matrix M.
kev_to_joules
linear_from_mass_attenuation
material_binding_contains
material_binding_rules
model_evidence_rules
open_emf_mixed_container
Open an .emf v4 container using the default mixed-domain registry.
open_emf_mixed_container_with_registry
Open an .emf v4 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 canonical HarmonicSign::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 angle theta_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, mode 2 | 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 contaminating empirical biofield/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_index declares source_entry_index in its provenance chain with matching BLAKE3 digest.
window_weight
write_extended_envelope
Encodes an extended single-chunk EMF v4 envelope into output via zero-heap staging and self-admits through ProfileReader before 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_cfl and returns the Courant number S 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 by E^{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.