Skip to main content

Module read

Module read 

Source

Structs§

ApiError
Represents an API error response from the spinorama API
ContourPlotData
Contour plot data with 2D heatmap structure
FsMeasurementCache
Production cache backed by the local filesystem.
InMemoryMeasurementCache
In-memory cache for deterministic tests.
InlineMeasurement
Inline measurement data (frequencies, SPL, phase)
MeasurementMultiple
Multiple measurements with metadata
MeasurementSingle
Single measurement with metadata
MockMeasurementBackend
Simple mock backend that returns a fixed response for a given URL.
PsychoacousticSmoothingConfig
Configuration for frequency-dependent psychoacoustic smoothing.
ReqwestMeasurementBackend
Production backend that issues real HTTP GET requests via reqwest.

Enums§

MeasurementRef
Reference to a measurement file
MeasurementSource
Source of measurements (single file, multiple files for averaging, or in-memory curve)

Constants§

NORMALIZE_HIGH_FREQ
High frequency bound for normalization (2000 Hz).
NORMALIZE_LOW_FREQ
Low frequency bound for normalization (1000 Hz).

Traits§

MeasurementBackend
Abstraction over the network/source that provides measurement data.
MeasurementCache
Abstraction over the local measurement cache.

Functions§

build_cea2034_data
Build Cea2034Data from curves HashMap
clamp_positive_only
Clamp only positive dB values to +max_db, leave negatives unchanged
create_log_frequency_grid
Create a standard logarithmic frequency grid
data_dir_for
Return the cache directory for a given speaker under <cache_root>/speakers/org.spinorama/<sanitized name>.
data_dir_for_cache_root
Return the cache directory for speaker below an explicit cache root.
extract_cea2034_curves
Extract all CEA2034 curves from plot data and interpolate to target frequency grid
extract_cea2034_curves_original
Extract all CEA2034 curves from plot data using the original frequency grid
extract_curve_by_name
Extract a single curve from a previously-fetched Plotly JSON object
fetch_available_headphones
Fetch the list of available headphones from the API
fetch_available_speakers
Fetch the list of available speakers from the API
fetch_contour_data
Fetch contour plot data (SPL Horizontal Contour or SPL Vertical Contour) from the spinorama API
fetch_contour_data_at_cache_root
Fetch contour data using an explicit cache root.
fetch_curve_from_api
Fetch a frequency response curve from the spinorama API
fetch_curve_from_api_at_cache_root
Fetch a frequency response curve using an explicit cache root.
fetch_directivity_data
Fetch directivity data (SPL Horizontal and SPL Vertical) from the spinorama API
fetch_directivity_data_at_cache_root
Fetch directivity data using an explicit cache root.
fetch_headphone_frequency_response
Fetch a headphone’s frequency response from the spinorama API.
fetch_headphone_frequency_response_at_cache_root
Fetch a headphone response using an explicit cache root.
fetch_headphone_frequency_response_with_backend
Fetch a headphone response using the supplied backend and cache.
fetch_headphone_frequency_response_with_backend_at_cache_root
Fetch a headphone response using supplied adapters and an explicit root.
fetch_measurement_plot_data
Fetch and parse the full Plotly JSON object for a given measurement (single HTTP GET)
fetch_measurement_plot_data_at_cache_root
Fetch and parse Plotly JSON using an explicit cache root.
fetch_measurement_plot_data_with_backend
Fetch and parse Plotly JSON using the supplied backend and cache.
fetch_measurement_plot_data_with_backend_at_cache_root
Fetch and parse Plotly JSON using supplied adapters and an explicit root.
fetch_record_from_api
Fetch a curve together with an API-origin provenance record.
find_similar_speakers
Find the closest matching speaker names using Levenshtein distance
format_speaker_not_found_error
Format a user-friendly error message with speaker suggestions
get_available_angles
Get available angles in the directivity data
get_directivity_at_angle
Extract a single directivity curve at a specific angle
get_on_axis
Get the on-axis response from directivity data
headphone_cache_dir
Return the cache directory for a headphone under <cache_root>/headphones/org.spinorama/<sanitized name>.
headphone_cache_dir_for_cache_root
Return the cache directory for headphone below an explicit cache root.
interpolate
Linear interpolation function
interpolate_log_space
Interpolate frequency response to a standard grid using linear interpolation in log space
interpolate_log_space_record
Interpolate a tracked record and record the target grid in its provenance ledger. Values outside the measured grid may be extrapolated, so this is marked as a lossy operation.
interpolate_response
Interpolate a frequency response curve WITHOUT normalizing.
load_driver_measurement
Load driver measurement data from a CSV file.
load_frequency_response
Load frequency response data from a CSV or text file Expected formats:
load_measurement
Load a single measurement from a file or inline data
load_source
Load measurement(s) from a source and average if necessary.
load_source_individual
Load individual measurement curves from a source without averaging.
load_source_with_individual
Load measurement(s) once and return both the representative response and the aligned individual responses.
load_spinorama_with_spin
Load spinorama measurement with full CEA2034 spin data
load_spinorama_with_spin_at_cache_root
Load spinorama measurement data using an explicit cache root.
measurement_filename
Return the cache filename for a measurement, neutralizing any path separators. For example, “Estimated In-Room Response” becomes “Estimated In-Room Response.json” and “A/B” becomes “A-B.json”.
normalize_and_interpolate_record
Normalize and resample a tracked record, preserving the exact operation parameters in its transformation ledger.
normalize_and_interpolate_response
Normalize and interpolate a frequency response curve.
normalize_and_interpolate_response_with_range
Normalize and interpolate response with custom normalization frequency range
read_curve_from_csv
Read a frequency response curve from a CSV file.
read_record_from_csv
Read a CSV into a tracked measurement record. The curve-only read_curve_from_csv adapter remains available for legacy callers.
read_spinorama
Fetch a frequency response curve from the spinorama API
read_spinorama_at_cache_root
Fetch a frequency response curve using an explicit cache root.
sanitize_dir_name
Sanitize a single path component by replacing non-alphanumeric characters (except space, dash and underscore) with underscores. This is used to map user-provided speaker names to safe directory names inside data/.
smooth_gaussian
Apply Gaussian smoothing to a scalar signal.
smooth_one_over_n_octave
Apply simple 1/N-octave smoothing.
smooth_psychoacoustic
Apply frequency-dependent psychoacoustic smoothing.

Type Aliases§

BackendResult
Error type alias for backend/cache operations.
Cea2034Data
CEA2034 spin data with all standard curves.