CICADA: A unified framework for NWB-based neurophysiological data analysis

Abstract

Neurophysiology datasets are becoming increasingly complex, combining behavioral measurements with high-dimensional neuronal activity recordings coming from optical and/or electrophysiological measurements. The Neurodata Without Borders (NWB) standard has emerged in the community as the format of record. While standardized and widely used preprocessing tools generating NWB files have been developed, extensible frameworks for scientific analysis downstream of the NWB ecosystem are still under-represented. We present CICADA, a Python framework dedicated to analysis of neurophysiological data in the standardized NWB format. The toolbox is built as three hierarchically-organized packages: cicada-nwb (NWB access layer), cicada-analysis (plugin-based analysis engine and tool library), and cicada-gui (PyQt5 desktop application at the head of the pipeline). Beyond this architectural separation, CICADA is built around a central design principle: supporting a continuum from turnkey use to full modularity. Researchers can use the complete GUI-driven cicada-gui workflow without writing code, programmatically use existing analysis plugins from cicada-analysis, contribute to new analysis plugins, reuse utilities from cicada-tools, or build entirely custom pipelines on top of the cicada-nwb access layer alone. The same analysis plugin runs identically in interactive GUI and parameter-configured headless modes, enabling reproducible multi-session, multi-animal group analyses. We illustrate the versatility of CICADA with example analyses of behavioral, calcium imaging (two-photon and widefield) and extracellular electrophysiology datasets from rodent laboratories. CICADA is open source, actively maintained, and designed so that any laboratory can contribute at any level of the stack without modifying the core framework.