med64 0.0.2

Headless MED64 electrophysiology toolkit: .modat I/O, spike/burst analysis, assays, spike-rate maps, and CSV/HTML/SVG/HDF5 export
Documentation
//! Headless **MED64** electrophysiology toolkit: `.modat` I/O, spike/burst analysis,
//! assay modules, spike-rate maps, and CSV / HTML / SVG / PNG / HDF5 export.
//!
//! See the crate [README](https://docs.rs/med64) (or `README.md` in the repo) for CLI
//! commands, feature flags, and limitations.
//!
//! # Feature flags
//!
//! | Flag | Default | Purpose |
//! |------|---------|---------|
//! | `analysis` | yes | IIR filters, spike detection |
//! | `bursts` | yes | Single/multi-channel bursts + ASDR |
//! | `correlation` | yes | Burst-onset correlogram + synchrony |
//! | `histograms` | yes | ISI / amplitude histograms |
//! | `workflow` | yes | `.moflo` compute runner |
//! | `chart` | yes | HTML Chart.js reports |
//! | `diagnostics` | yes | Channel statistics |
//! | `layouts` | yes | 384-ch well plate / Basic4x4 / QuadII labels |
//! | `parallel` | yes | rayon batch + per-channel detect |
//! | `hdf5` | yes | Spike / SIS-style HDF5 (`hdf5-no-c`) |
//! | `accelerate` | yes | macOS vDSP FFT (no-op elsewhere) |
//! | `blas` | no | alias for `accelerate` |
//! | `slow-goldens` | no | long analysis goldens |
//! | `full` | no | alias for `default` |
//!
//! # Quick start
//!
//! ```no_run
//! use med64::prelude::*;
//!
//! # fn main() -> med64::Result<()> {
//! let mut rec = Recording::open("data/sample data1.modat")?;
//! for block in rec.blocks() {
//!     let block = block?;
//!     println!("block {} has {} points", block.block_number, block.samples.len());
//! }
//! convert("data/sample data1.modat", "/tmp/out.csv", &ConvertOptions::default())?;
//! # Ok(())
//! # }
//! ```
//!
//! # Burst analysis facade
//!
//! ```no_run
//! # #[cfg(feature = "analysis")]
//! use med64::{run_burst_pipeline, BurstPipelineOptions};
//!
//! # #[cfg(feature = "analysis")]
//! # fn main() -> med64::Result<()> {
//! let report = run_burst_pipeline("data/sample data1.modat", &BurstPipelineOptions::default())?;
//! println!("{} spikes", report.spikes.len());
//! # Ok(())
//! # }
//! # #[cfg(not(feature = "analysis"))]
//! # fn main() {}
//! ```

// Ported / numeric-heavy code: keep clippy CI strict without mass-rewriting loops and signatures.
#![allow(
    clippy::approx_constant,
    clippy::collapsible_match,
    clippy::if_same_then_else,
    clippy::needless_range_loop,
    clippy::neg_cmp_op_on_partial_ord,
    clippy::ptr_arg,
    clippy::too_many_arguments,
    clippy::wildcard_in_or_patterns
)]

mod batch;
mod block;
mod convert;
mod error;
#[doc(hidden)]
pub mod fixture_paths;
mod format;
mod formats;
mod header;
mod moflo;
mod pipeline;
mod png;
pub mod prelude;
mod reader;
mod recording;
mod stream;
mod writer;

#[cfg(feature = "analysis")]
mod accelerate_fft;
#[cfg(feature = "analysis")]
mod analysis;
#[cfg(feature = "analysis")]
pub mod burst_pipeline;
#[cfg(feature = "chart")]
mod chart;
#[cfg(feature = "diagnostics")]
mod diagnostics;
#[cfg(feature = "analysis")]
mod emf;
#[cfg(feature = "analysis")]
mod export;
#[cfg(all(feature = "analysis", feature = "hdf5"))]
mod export_hdf5;
#[cfg(feature = "analysis")]
mod export_waveform;
#[cfg(feature = "analysis")]
mod gallery;
#[cfg(feature = "layouts")]
mod layout;
#[cfg(feature = "analysis")]
mod project;
#[cfg(all(feature = "analysis", feature = "layouts"))]
pub mod rate_map;
#[cfg(feature = "analysis")]
pub mod svg;
#[cfg(feature = "layouts")]
mod synthetic;
#[cfg(feature = "analysis")]
mod toolkit;
#[cfg(feature = "analysis")]
mod wavestack;
#[cfg(feature = "workflow")]
mod workflow;

#[cfg(feature = "analysis")]
pub use accelerate_fft::{accelerate_dot, accelerate_fft_inplace};
#[cfg(all(feature = "analysis", feature = "histograms"))]
pub use analysis::{amplitude_histogram, isi_histogram, Histogram, HistogramOptions};
#[cfg(feature = "analysis")]
pub use analysis::{
    amplitude_rank_report, apply_dose_edits, attach_waveforms, average_spike_waveforms,
    calc_moving_average, calc_thresholds, compare_burst_result_tables, compute_burst_result_table,
    compute_stat_results, create_multi_stat_map, create_single_stat_map,
    detect_multi_channel_bursts, detect_single_channel_bursts, detect_spikes, detect_spikes_f32,
    filter_spikes, format_spike_csv_row, import_spike_csv, import_spike_timestamps_hdf5,
    load_analysis_log_dir, load_burst_data_json, multi_channel_burst_profile,
    percent_change_from_first, prepare_native_log_restore, raster_time_histogram,
    read_native_analysis_log, run_analysis, run_analysis_from_spikes, run_analysis_on_recording,
    run_analysis_with_progress,
    run_dose_series, run_dose_series_report, run_result_table_compare, save_analysis_log_dir,
    spike_autocorrelogram, spike_heatmap, spike_posthoc, spike_raster, spike_timestamp_csv_header,
    write_dose_csv, write_dose_html, write_dose_interactive_html, write_native_analysis_log,
    write_native_analysis_log_with_options, write_raster_histogram_csv,
    write_result_table_interactive_html, write_scatter_csv, AmplitudeRankReport, AmplitudeRankRow,
    AnalysisLogManifest, AnalysisLogRestore, AnalysisOptions, AnalysisProgress, AnalysisReport,
    AnalysisStage, AsdrTrace, AutoThresholdBase, AutocorrOptions, AutocorrReport, AverageWaveform,
    BandpassFilter, BurstDataFilePublic, BurstProfile, BurstProfileAlignment, BurstProfileOptions,
    BurstProfilePoint, BurstResultTable, ChannelAutocorr, ChannelCriteria, ChannelStatRow,
    DoseEditRow, DoseEditTable, DosePoint, DoseSeriesReport, FilterAlgorithm, FilterChain,
    FilteredSample, HeatmapCell, HighPassFilter, ImportedSpikes, LowPassFilter, LowPassKind,
    MultiBurstMethod, MultiChannelBurst, MultiChannelBurstOptions, MultiFileResultColumn,
    MultiFileResultTable, MultiStatType, NativeAnalysisLog, NativeLogOptions, RasterPoint,
    RasterTimeHistogram, ResultTableOptions, ResultTableRow, SingleChannelBurst,
    SingleChannelBurstOptions, SingleStatType, Spike, SpikeDetectOptions, SpikeDirection,
    SpikeFilterOptions, SpikeFrequencyBin, SpikeHeatmap, SpikePostHocReport, SpikeRaster,
    SpikeScatterPoint, SpikeTrain, StatKind, StatResultReport, ThresholdMethod, ThresholdOptions,
    UNDEFINED_INDEX,
};
#[cfg(all(feature = "analysis", feature = "correlation"))]
pub use analysis::{
    burst_onset_correlogram, synchrony_index, BurstOnsetCorrelogram, ChannelSynchrony,
    CorrelationOptions,
};
pub use batch::Batch;
pub use block::Med64DataBlock;
#[cfg(all(feature = "analysis", feature = "histograms"))]
pub use burst_pipeline::{burst_pipeline_amplitude_histogram, burst_pipeline_isi_histogram};
#[cfg(feature = "analysis")]
pub use burst_pipeline::{
    burst_pipeline_asdr, burst_pipeline_create_image, burst_pipeline_detect_spikes,
    burst_pipeline_dose_series, burst_pipeline_export_bundle, burst_pipeline_multi_channel_bursts,
    burst_pipeline_native_log, burst_pipeline_result_table, burst_pipeline_single_channel_bursts,
    run_burst_pipeline, write_amplitude_chart_html, write_analysis_dashboard_html, write_asdr_svg,
    write_botcc_svg, write_burst_chart_html, write_correlation_chart_html,
    write_freq_count_chart_html, write_isi_chart_html, write_map_chart_html, write_synchrony_svg,
    BurstPipelineOptions, BurstPipelineReport,
};
#[cfg(all(feature = "analysis", feature = "correlation"))]
pub use burst_pipeline::{burst_pipeline_botcc, burst_pipeline_synchrony};
#[cfg(feature = "chart")]
pub use chart::{
    chart_file, extract_waveforms, render_html, write_html_report, ChartOptions, WaveformSeries,
};
pub use convert::{convert, ConvertOptions, ConvertReport};
#[cfg(feature = "diagnostics")]
pub use diagnostics::{analyze, analyze_path, ChannelStats, DiagnosticOptions, Diagnostics};
#[cfg(feature = "analysis")]
pub use emf::{encode_bgr_emf, write_bgr_emf};
pub use error::{Med64Error, Result};
#[cfg(feature = "analysis")]
pub use export::{
    write_amplitude_rank_csv, write_analysis_bundle, write_asdr_csv, write_autocorr_csv,
    write_average_waveforms_csv, write_burst_batch_package, write_burst_batch_package_with_chart,
    write_burst_detector_bundle, write_burst_detector_bundle_with_options, write_burst_profile_csv,
    write_chart_snapshots, write_create_image_package, write_create_image_package_with_options,
    write_filtered_raw_csv, write_frequency_csv, write_intra_burst_csv, write_multi_burst_csv,
    write_png_snapshot, write_raster_csv, write_result_table_compare_csv, write_result_table_csv,
    write_result_table_csv_with_options, write_single_burst_csv, write_spike_timestamps_csv,
    write_spike_timestamps_csv_from_train, write_spike_timestamps_hdf5,
    write_spike_timestamps_plus_waveforms_csv, write_stat_results_csv, write_svg_snapshot,
    AsdrChartKind, BurstDetectorBundleOptions, CreateImagePackageOptions,
};
#[cfg(all(feature = "analysis", feature = "hdf5"))]
pub use export::{write_spike_hdf5, SpikeHdf5Options};
#[cfg(feature = "analysis")]
pub use export_waveform::{
    write_filtered_f32_binary, write_filtered_i16_binary, write_filtered_interleaved_csv,
    write_filtered_waveforms, FilteredExportOptions, FilteredExportReport,
};
pub use format::FileFormat;
pub use formats::{
    is_waveform_file, open_recording_any, write_modax_wrapper, write_modax_wrapper_with_meta,
    ModaxWrapperMeta, RecordingFormat,
};
#[cfg(feature = "analysis")]
pub use gallery::write_examples_gallery;
pub use header::{HeaderBuilder, Med64Header, FILE_HEADER_BYTES, NUM_CHANNELS};
#[cfg(feature = "layouts")]
pub use layout::{
    active_channel_map_bytes, analysis_channels, channel_label, detect_layout,
    extended_header_bytes, is_presto_file, open_with_layout, RecordingLayout, WellPlate,
};
pub use moflo::{write_analysis_moflo, MofloNode, MofloProtocol};
pub use pipeline::{pipe, Pipeline, SampleCollector, SampleSink, SampleUnit};
pub use png::{write_bgr_png, write_heatmap_png, write_rgb_png};
#[cfg(feature = "analysis")]
pub use project::{load_project, save_project, AnalysisOptionsSnapshot, AnalysisProject};
#[cfg(all(feature = "analysis", feature = "layouts", feature = "correlation"))]
pub use rate_map::write_synchrony_table_csv;
#[cfg(all(feature = "analysis", feature = "layouts"))]
pub use rate_map::{
    build_rate_map_report, compute_rate_map, compute_rate_map_batch, compute_stv_table,
    smooth_rate_map_rates, write_poincare_isi_csv, write_rate_map_average_package,
    write_rate_map_channel_table_csv, write_rate_map_filtered_export, write_rate_map_html,
    write_rate_map_overlay_html, write_rate_map_prefs_json, write_rate_map_propagation_package,
    write_rate_map_raw_package, write_rate_map_smoothing_csv, write_rate_map_speed_table_csv,
    write_rate_map_start_package, write_rate_map_summary_csv, write_rate_map_well_package,
    write_rate_map_well_package_with_prefs, write_rate_summary_csv, write_rate_table1_csv,
    write_rate_table2_csv, write_rate_table2r_csv, write_rate_table3_csv,
    write_rate_table3_from_batch, write_raw_viewer_html, write_stv_metrics_csv,
    write_stv_table_csv, write_well_plate_channels_bin, write_well_plate_channels_csv,
    write_well_plate_html, write_well_plate_raw_html, write_well_plate_viewer_html,
    write_well_plate_viewer_html_with_analysis, RateMapBatchReport, RateMapCell,
    RateMapFileSummary, RateMapOptions, RateMapPrefs, RateMapReport, RawViewerHtmlOptions,
    StvMetrics,
};
pub use reader::{
    discover_data_files, is_med64_data_file, is_modat_file, is_moflo_file, is_waveform_recording,
    Med64Reader,
};
pub use recording::{open, Recording};
pub use stream::{BlockStream, Sample, SampleBatch, SampleChunks, SampleStream};
#[cfg(feature = "analysis")]
pub use svg::{
    downsample_lttb, escape_xml, render_bar_svg, render_line_svg, render_raster_svg, write_bar_svg,
    write_line_svg, write_raster_svg, write_svg_file, SvgChartOptions, SvgSeries, SvgStyle,
};
#[cfg(feature = "layouts")]
pub use synthetic::{
    write_synthetic_well384, write_synthetic_well384_modax, SyntheticWell384Options,
};
#[cfg(feature = "analysis")]
pub use toolkit::{
    activation_from_spikes, activation_map, analysis_options_from, analyze_ltp, analyze_pacing,
    analyze_paid, apply_hum_filter, apply_to_all_cluster, apply_to_all_minus_thresh,
    apply_to_all_on_off, apply_to_all_plus_thresh, cluster_spikes, color_bin, compute_csd,
    compute_threshold_table, conduction_series, conduction_series_from_spikes, connection_map,
    continuous_wavelet, default_connectivity_prefs_path, default_fast_backend, detect_beats,
    detect_beta_oscillations, discrete_wavelet, execute_fft, fft_inplace, first_selected_channel,
    gap_histogram_from_report, load_batch_export_prefs, load_beat_prefs, load_beta_prefs,
    load_connectivity_properties, load_default_connectivity_prefs, load_fft_settings_properties,
    load_last_path_prefs, load_multi_channel_burst_chart_prefs, load_paid_prefs,
    load_propagation_prefs, load_propagation_spike_detector_threshold, load_psa_chart_prefs,
    load_settings_table_csv, load_single_channel_burst_export_prefs, load_spectrum_prefs,
    load_spike_detector_prefs, load_spike_detector_prefs_pair, load_stage_properties,
    load_threshold_properties, load_voltage_chart_export_prefs, load_voltage_chart_path_prefs,
    multi_bandpass, pacing_from_spikes, paid_from_spikes, pdm_detect, pdm_timestamp_data_header,
    peri_event_histogram, poincare_isi, power_spectrum, propagation_delay_map,
    propagation_from_spikes, reference_fft_inplace, resolve_pace_times, run_connectivity_package,
    run_fbo, run_fbo_filtering_batch, run_four_well_asdr, run_pdm_detector,
    run_pdm_detector_package, run_spike_detector, run_spike_frequency, run_spike_well_freq,
    run_voltage_chart_package, spectrogram, spike_connectivity, stim_events_from_recording,
    upsample_delay_grid, voltage_colormap, voltage_stft_colormap, write_batch_export_prefs,
    write_beat_csv, write_beat_fpd_isi_csv, write_beat_html, write_beat_package, write_beat_prefs,
    write_beta_create_image, write_beta_package, write_beta_prefs, write_burst4well_html,
    write_cluster_package, write_conduction_html, write_connection_map_csv,
    write_connection_map_html, write_connection_map_matrix_csv, write_connection_map_package,
    write_connectivity_properties, write_fft_settings_properties, write_filtered_mobius_modat,
    write_four_well_asdr_package, write_gap_histogram_csv, write_last_path_prefs,
    write_multi_bandpass_csv, write_multi_channel_burst_chart_prefs, write_oversample_csv,
    write_pacing_chchart_html, write_pacing_delay_map_html, write_pacing_package, write_paid_csv,
    write_paid_prefs, write_pdm_timestamp_csv, write_pdm_timestamp_package, write_propagation_csv,
    write_propagation_html, write_propagation_prefs, write_psa_chart_prefs,
    write_settings_table_csv, write_single_channel_burst_export_package,
    write_single_channel_burst_export_prefs, write_spectrum_prefs, write_spike_detector_bundle,
    write_spike_detector_create_image, write_spike_detector_panel_html, write_spike_detector_prefs,
    write_spike_detector_result_table_html, write_spike_frequency_package,
    write_spike_well_freq_package, write_stage_properties, write_threshold_properties,
    write_voltage_binary, write_voltage_chart_export_prefs, write_voltage_chart_package,
    write_voltage_chart_path_prefs, write_voltage_create_image, write_voltage_frame_png,
    write_voltage_panel_html, write_voltage_stft_html, write_wavelet_create_image,
    write_wavelet_package, ActivationCell, ActivationOptions, ActivationReport, AsdrValueType,
    AverageBinKind, BandpassBand, BatchExportPrefs, Beat, BeatExportOptions, BeatOptions,
    BeatPrefs, BeatReport, BetaExportOptions, BetaOscillationOptions, BetaOscillationReport,
    BetaPrefs, BetaThresholdMethod, ChChartBeat, ChannelThresholdRow, ChartImageType,
    ClusterAssignment, ClusterCentroid, ClusterOptions, ClusterReport, ConductionFrame,
    ConductionSeries, ConnectionMapOptions, ConnectionMapReport, ConnectivityEdge,
    ConnectivityExportOptions, ConnectivityOptions, ConnectivityPackageOptions,
    ConnectivityPackageReport, ConnectivityPrefs, ConnectivityReport, CsdCell, CsdOptions,
    CsdReport, DiscreteWaveletReport, DownsampleMode, ExportTraceType, FboBatchFileResult,
    FboBatchOptions, FboBatchReport, FboOptions, FboReport, FftConfig, FourWellAsdrOptions,
    FourWellAsdrReport, GapHistBin, HumNoiseRemoval, LtpOptions, LtpPoint, LtpReport,
    MultiBandpassOptions, MultiBandpassReport, MultiBandpassTrace, MultiChannelBurstChartPrefs,
    NotchFilter, OscillationEvent, OversampleGrid, OversampleMode, PaceRhythmMode, PaceSource,
    PaceWindow, PacingOptions, PacingReport, PaidCell, PaidOptions, PaidPrefs, PaidReport,
    PdmDetectorOptions, PdmDetectorReport, PdmTimestampCsvStyle, PdmTimestampMode,
    PdmTimestampVariant, PethBin, PethOptions, PethReport, PoincarePoint, PoincareReport,
    PropagationCell, PropagationOptions, PropagationPrefs, PropagationReport, PsaChartPrefs,
    PsdReduce, SettingsFormParams, ShihyouBins, SingleChannelBurstChartImageFormat,
    SingleChannelBurstChartType, SingleChannelBurstExportPrefs, SpectrogramReport, SpectrumBackend,
    SpectrumBin, SpectrumOptions, SpectrumPrefs, SpectrumReport, SpectrumWindow,
    SpikeDetectorExportMatrix, SpikeDetectorExportOptions, SpikeDetectorOptions,
    SpikeDetectorPanelPrefs, SpikeDetectorPrefs, SpikeDetectorReport, SpikeFrequencyOptions,
    SpikeFrequencyReport, SpikePolarity, SpikeWellFreqOptions, SpikeWellFreqReport,
    StageWindowPrefs, ThresholdCalcRange, TimeRangeMs, VoltageCell, VoltageChartExportPrefs,
    VoltageChartFormat, VoltageChartOptions, VoltageChartPackageReport, VoltageChartPathPrefs,
    VoltageFilterType, VoltageHdrStyle, VoltageMapOptions, VoltageMapReport, VoltageStftFrame,
    VoltageStftReport, WaveformViewerPathPrefs, WaveletBand, WaveletExportOptions, WaveletOptions,
    WaveletReport,
};
#[cfg(feature = "analysis")]
pub use wavestack::{load_wave_stack, write_wavestack_html, WaveStack, WaveStackTrace};
#[cfg(feature = "workflow")]
pub use workflow::{
    run_workflow, WorkflowGraph, WorkflowLink, WorkflowNodeRef, WorkflowOptions, WorkflowReport,
};
pub use writer::{CsvWriter, JsonWriter, ModatWriter, Writer};

pub use recording::open as open_recording;