Roadmap
Phase 0 — scientific foundation
- [x] Canonical labelled recording prototype
- [x] Robust and OLS reference-fit prototype with provenance
- [x] Event alignment retaining individual events
- [x] Initial landscape and extraction audits
- [x] Ground-truth simulation seed
- [x] Freeze benchmark scenarios and acceptance thresholds in-repository
- [ ] Confirm package name with likely users before first public release
Phase 1 — trustworthy preprocessing
- [x] Channel-level validity, dropout, repeated-extreme, and flat-step QC
- [x] Sampling-rate and gap diagnostics
- [x] Resampling with explicit interpolation provenance
- [x] Session-adaptive median-rate regularization and gap diagnostics
- [x] Frozen smooth-signal irregular-clock fidelity benchmark
- [x] Sharp-transient, missing-run, and event-boundary resampling benchmark
- [x] Outcome-blind real-data event-coverage and selection audit across 383 IBL sessions
- [x] New held-out real-data regularized-AsLS comparison (retained gate failure; no promotion)
- [x] Filter API with edge-effect reporting
- [ ] Bleaching models and control-free baseline comparators
- [x] Experimental double-exponential and AsLS signal-only APIs
- [x] Frozen v0.1 benchmark with retained partial failure
- [x] v0.2 baseline-fidelity, normalization, and sampling-rate benchmark
- [x] First independent real-data-control pilot (mixed; no promotion)
- [ ] Broader independent-control validation before typed-pipeline promotion
- [x] Event-correlated reference diagnostic benchmarked against confounds
- [ ] Reliable reference-lag diagnostic (v0.3 derivative scan failed)
- [x] Wavelength-aware hemodynamic correction and spectral-unmixing contract
- [x] Typed components, channel wavelengths, coefficients, offsets and calibration identity
- [x] Independent known-component calibration with rank and conditioning gates
- [x] Pointwise missing-channel-pattern identifiability without interpolation
- [x] Reconstruction residuals and overdetermined channel-holdout diagnostics
- [ ] Raw-system calibration and biological-recording validation across two sensor families
- [x] Optogenetic-pulse artifact masks and recovery-window diagnostics
- [x] Open, versioned sensor registry with kinetic, saturation, and interpretation constraints
- [x] Sensor-kinetic forward models and guarded deconvolution
- [x] Versioned model/profile/calibration identity without converting descriptive kinetics
- [x] Difference-of-exponentials and sampled empirical causal kernels
- [x] Gap-bounded forward prediction with explicit zero-state boundary evidence
- [x] Prospective sampling, duration, transfer and regularization identifiability gates
- [x] Conditional unconstrained/nonnegative recovery with complete reconstruction evidence
- [ ] Cross-regularization robustness summary and calibrated latent uncertainty
- [ ] Independent calibration fixtures across two sensors and realistic model mismatch
- [x] Initial three-scenario benchmark report with retained failure
- [x] Seven-scenario v0.2 benchmark with retained failures
- [x] Twelve-session, four-animal IBL channel-QC audit
- [x] Initial raw/peri-event/corrected diagnostic plot API
Phase 2 — interoperability
- [x] Core NWB round trip and
ndx-fiber-photometryresponse-series read path - [x] DANDI 001084 bounded remote-stream integration fixture
- [x] DANDI archived dF/F numerical reproduction and provenance discrepancy report
- [x] DANDI 001084 API metadata contract and bounded-streaming plan
- [x] Pinned DANDI 000971 raw calcium/isobestic adapter and frozen pilot
- [x] DANDI 000351 raw-to-processed parity audit (retained failure)
- [ ] Recover DANDI 000351 raw-to-dF/F transformation provenance
- [x] IBL table adapter with alternating-wavelength interpolation and masks
- [x] Real IBL session reproduction against archived analysis outputs
- [x] TDT and generic tabular adapters
- [x] Schema-first wide CSV/TSV recording and event adapter
- [x] Explicit TDT stream/epoc adapter through the same canonical boundary
- [x] Checksum-pinned official real-block TDT integration fixture
- [x] Native Doric, Neurophotometrics, and pyPhotometry adapters
- [x] Shared acquisition inspection, provenance, and conformance boundary
- [x] Doric HDF5 series/digital mapping with official-file parity
- [x] Neurophotometrics
Flags/LedStatealternating-wavelength import - [x] pyPhotometry legacy and v1.1 pulsed binary import
- [x] Behavioral ecosystem adapters
- [x] Typed pose, continuous-covariate, point-event and interval boundaries
- [x] Native-shaped DeepLabCut, SLEAP, Keypoint-MoSeq and BORIS adapters
- [x] Executable cross-tool composition tutorial and explicit gap register
- [x] Versioned real-file fixtures and numerical-parity matrix
- [x] Official checksum-pinned SLEAP legacy Analysis HDF5 fixture
- [x] Official checksum-pinned BORIS tabular CSV fixture
- [x] Current DeepLabCut single- and multi-animal writer-contract fixtures
- [x] Current Keypoint-MoSeq
results.h5writer-contract fixture - [x] Current SLEAP standard-preset and BORIS aggregated fixtures
- [x] Direct loss-aware
ndx-pose0.3 NWB inspection, 2D/3D import, export, and round trip - [x] Typed affine clock-synchronization evidence, drift diagnostics and refusal thresholds
- [x] Versioned metadata completeness and analysis/NWB/publication readiness report
Phase 3 — inference
- [x] Typed, versioned experimental-design representation
- [x] Experimental animal-level hierarchical bootstrap
- [x] Experimental design-aware sign-flip and label permutations
- [x] Frozen pseudoreplication benchmark contrasting trial and animal resampling
- [x] Initial independent MixedLM point-estimate parity
- [x] Independent interval and unbalanced mixed-model plumbing parity
- [x] Extended non-Gaussian, heteroscedastic, unequal-count calibration
- [x] Condition-stratified hierarchical resampling
- [x] Four-animal IBL event-table/design integration
- [x] Animal-level Welch and paired-t interval comparators
- [x] Frozen conditional power grid from 6–30 animals per condition
- [x] Conservative design-aware scalar inference recommender
- [x] Independent SciPy parity for Welch and paired intervals
- [x] Versioned analysis plans with explicit assumption acknowledgement
- [x] Result provenance with package version, timestamp, input fingerprint, and seed
- [x] Seeded Monte Carlo plan execution
- [x] First frozen descriptive IBL analysis plan and result
- [x] Typed preprocessing-to-inference pipeline with non-destructive QC gates
- [x] Typed multiverse expansion with stable IDs and compatibility rules
- [x] Failure-retaining robustness and decision summaries
- [x] Reference-pipeline leave-one-animal-out diagnostics
- [x] First frozen descriptive public-data multiverse
- [x] Specification-curve plot API and frozen IBL figure
- [x] Prospective, new-animal-gated IBL expansion protocol
- [x] Refresh held-out IBL manifest (gate failed: no labelled reference channels)
- [x] Resolve new-cohort IBL channel provenance (470-nm-only acquisition)
- [x] Implement the published rolling baseline with 20/50-Hz and gap fixtures
- [x] Freeze signal-only IBL v0.3 (18 animals; 15 executable universes)
- [x] Execute and report the amended signal-only IBL v0.3.2 multiverse
- [x] Pilot power sensitivity ranges
- [x] Opt-in scalar mixed-model sensitivity summaries
- [ ]
fastFMMbridge and numerical-parity fixtures - [x] Animal-level peri-event pointwise and simultaneous interval reporting
- [x] Common animal-level materialization and interaction boundary across peri-event, transient, state-band-power, and multi-signal workflows
- [ ] Behavioral/event-kernel GLMs with grouped cross-validation
- [x] Typed Gaussian FIR model for overlapping events and continuous covariates
- [x] Leakage-safe animal/session-held-out ridge selection
- [x] Ground-truth recovery fixture and executable simulation tutorial
- [x] Public-data literature reproduction with a frozen design and retained weak validation
- [x] Conditional grouped-jackknife kernel intervals and out-of-fold residual diagnostics
- [x] Validity-mask-aware complete-case fitting with coverage evidence and gap-safe residual diagnostics
- [ ] Formal interval-coverage calibration and simultaneous kernel bands
- [x] Freeze and execute the first 480-study event/progress calibration
- [x] Retain the failed normalized-progress gate without default promotion
- [ ] Validate a revised whole-model band across every frozen scenario
- [x] Named whole-spec design alternatives in reproducible robustness multiverses
- [x] Basis, trial-history, duration/amplitude, and predictor-family contribution alternatives
- [x] Typed full-FIR and raised-cosine kernel bases with physical-lag reconstruction
- [x] Explicit current/lagged event-value modulation with session-local history
- [x] Duration modulation and normalized-progress kernel alternatives
- [x] Paired held-out predictor-family contribution summaries
- [x] Validated longitudinal neural-summary handoff to Unspool
- [x] Frozen cross-package public IBL learning-trajectory benchmark with retained negative lagged-neural forecast
- [x] Across-session photometry comparability diagnostics before longitudinal handoff
- [x] Interval/bout event rules and variable-duration models
- [x] Preserve point/state distinction and physical bout duration
- [x] Explicit onset, offset and normalized-progress projections
- [x] Ordered merge/split/filter rules, contextual labels, overlap policies, lineage ledger, and evidence fingerprint
- [x] Duration/amplitude and progress-basis event-kernel alternatives
- [ ] Single-signal time/frequency/state analysis
- [x] Gap-aware autocorrelation and power spectral density
- [x] Spectrograms with explicit detrending, edge, and missing-data evidence
- [x] User-supplied state/epoch tables and animal-aware comparisons
- [x] Exact-axis animal-level inference for complete PSD and autocorrelation curves
- [ ] Public sleep/state or long-duration worked example
- [x] Multiscale long-duration summaries without unvalidated tonic/phasic biological labels
- [x] Named physical-time scales with explicit step, coverage and sample gates
- [x] Irregular-clock time weighting plus explicitly sample-weighted alternatives
- [x] Gap/state-bounded acceptance ledger and deterministic evidence fingerprint
- [x] Equal-session animal inference for paired and independent conditions
- [x] Experimental spontaneous transient detection with local-baseline sensitivity analysis
- [x] Prospective three-animal public dLight construct validation with retained detector disagreement
- [x] Separate candidate detection from quantification on non-z-scored dF/F
- [x] Named GuPPY, PASTa, and prominence-compatible detector families
- [x] Baseline/control-derived frozen thresholds, compound events, and cut-waveform QC
- [x] Baseline/control-derived frozen threshold objects
- [x] Compound-event group and rank metadata
- [x] Gap-aware cut waveforms and boundary QC
- [x] Animal-aware rate and kinetic inference
- [ ] Raw-signal and manual-annotation validation across two sensors/acquisition systems
- [x] Multi-site/multi-color paired and conditional association workflows
- [x] Paired channel/site metadata, alignment, control, and crosstalk diagnostics
- [x] Lagged and event/behavior-residualized association with blocked uncertainty
- [x] State-conditioned coherence and phase after single-signal spectral validation
- [x] Exact-axis animal-level inference for complete lag-association and coherence curves
- [x] Coordinate-aware mouse-level models for dense multi-fiber arrays
- [x] Shared coordinate space/unit and complete pair/exclusion ledger
- [x] Physical-distance bins and within-session node-label spatial null
- [x] Equal-session mouse-level paired and independent contrasts
- [ ] Raw-system validation with known geometry and injected shared artifacts
Phase 4 — adoption
- [x] Publishable MkDocs site with strict link and API-reference builds
- [x] Scientist-task methods catalog and supported/experimental/planned matrix
- [ ] Literature-shaped worked examples for each major method family
- [x] Public-data evidence atlas linking figures to estimands, units, and limitations
- [x] Event-locked public IBL analysis
- [x] Raw-NWB animal-level robustness analysis
- [ ] Behavioral event-kernel GLM
- [x] Ground-truth implementation tutorial
- [x] Public-data literature reproduction with retained negative held-out R²
- [x] Cross-tool pose/state/annotation interoperability tutorial
- [ ] Trial-level functional mixed model
- [ ] Long-duration tonic/phasic and spontaneous events
- [ ] Multi-site/multi-color association
-
[ ] Spectral or hemodynamic correction with controls
-
[x] First scientist-facing event-analysis workflow
- [x] Self-contained HTML evidence report with animal/QC/provenance views
- [x] Declarative TOML configuration for no-code-rewrite analysis choices
- [x] CLI from tabular project configuration to preflight, JSON, and HTML artifacts
- [x] CLI export of raw/processed signals, events, QC, and provenance to NWB
- [x] Unit-safe grouped report for complete multiverse robustness results
- [x] Configuration-driven multiverse preflight, execution, and evidence bundle
- [x] Extend project multiverses to signal-only preprocessing recipe families
- [x] Add per-unit-lane practical-effect thresholds and machine-readable summaries
- [x] Add declarative method-specific baseline parameters and compatibility rules
- [x] Add multiverse-aware NWB provenance and result export
- [x] Add a project-level result reader for JSON and NWB evidence bundles
- [x] Add cross-bundle comparison and reproducibility-diff reporting
- [x] Add signed publication manifests and detached verification
- [x] Add release/DOI deposition packaging and archival metadata validation
- [x] Add a sandbox-first Zenodo draft upload and validation adapter
- [x] First-class candidate-to-gated-to-complete event coverage API and report panel
- [x] Public IBL tutorial from import to fingerprinted JSON/HTML report
- [x] Canonical raw-NWB to animal-level robustness tutorial
- [x] Freeze the DANDI 000971 cohort, estimand, and eight-universe protocol
- [x] Add the executable workflow and synthetic end-to-end regression fixture
- [x] Execute the frozen public cohort and publish the retained result narrative
- [ ] Usability review with practicing photometry scientists
- [x] Freeze v0.1 protocol, stimulus generator, response sheet, and scoring key
- [ ] Run five moderated sessions and publish the de-identified synthesis
- [ ] External reproduction by two laboratories
- [ ] Stable schema and deprecation policy
- [x] Declare prospective v0.1 supported and experimental API surfaces
- [x] Version the primary JSON result and package its normative JSON Schema
- [x] Add deprecation, migration, changelog, and security policies
- [x] Complete clean-install and canonical-artifact release audit
- [x] First versioned public benchmark protocol and results
- [x] Scientific decision records and method review guidance
- [ ] External contributor governance
- [ ] 1.0 release and archival DOI