Skip to main content Module read Copy item path Source 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. MeasurementRef Reference to a measurement file MeasurementSource Source of measurements (single file, multiple files for averaging, or in-memory curve) NORMALIZE_HIGH_FREQ High frequency bound for normalization (2000 Hz). NORMALIZE_LOW_FREQ Low frequency bound for normalization (1000 Hz). MeasurementBackend Abstraction over the network/source that provides measurement data. MeasurementCache Abstraction over the local measurement cache. 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. BackendResult Error type alias for backend/cache operations. Cea2034Data CEA2034 spin data with all standard curves.