Skip to content

sahilm89/CeDNe

Repository files navigation

CeDNe (pronounced "Sydney")

CeDNe (Connectome-embedded Dynamical Networks) is a modular, extensible Python library for multi-omic integration and systems-level modeling. It enables researchers to represent, combine, analyze, and simulate complex neuronal data using a flexible, graph-based object model.

Built on top of NetworkX, CeDNe allows intuitive access to neurons, connectomes, gene expression data, neurotransmitter systems, neuropeptide signaling, and calcium imaging activity — all structured in one coherent framework. This design supports both high-level exploratory workflows and low-level modeling and simulation pipelines.


What CeDNe Can Do

  • Multi-omic integration: unify anatomical, transcriptomic, neurochemical, and functional data
  • Motif search and path analysis: identify structural motifs, compute paths, and trace information flow
  • Neuron-annotated visualizations: render 2D/3D plots with contextual labels and spatial alignment
  • Data contextualization: map new experimental data (e.g., RNA-seq, imaging) onto known connectomic structures
  • Graph-based simulation and optimization: simulate neural activity and optimize parameters using Optuna
  • Workflow examples: ready-to-run notebooks for tasks ranging from data loading to motif-based simulation

Why Use CeDNe?

  • Designed for multi-modal data integration and analysis
  • Combines object-oriented structure with flexible graph analytics
  • Easy integration into existing Python pipelines
  • Modular API with support for advanced users
  • Extensible to several organisms
  • Web interface for data exploration and analysis

Installation

CeDNe requires Python ≥3.9 and uses Poetry for dependency management. To get started:

Clone the repository

git clone https://github.com/sahilm89/CeDNe.git
cd CeDNe

Install poetry if you don't have it

curl -sSL https://install.python-poetry.org | python3 -

Install dependencies in an isolated virtual environment

poetry install

To activate the virtual environment

poetry shell

For more details see INSTALL.md You may have to install a plugin now.

Getting Started

You can start exploring with just a few lines of code and minimal setup. See the examples/notebooks folder or try interactive notebooks in Binder:

Binder

For more notebooks, see the full list below:

01. Create Worm and Graph Connections

Binder

Builds the worm object and initializes anatomical connectivity.


02. Save Worm and Load Worm

Binder

Demonstrates serialization and deserialization of the worm model to/from disk.


03. Fold Network and Load Data

Binder

Introduces tools for network folding and attaches experimental data to network nodes.


04. Load Transcripts and View Positions

Binder

Loads transcriptomic data and maps neuron positions in anatomical space.


05. View 3D Positions

Binder

Interactive 3D visualization of neuron spatial layout using matplotlib.


06. Load Neuropeptides

Binder

Attaches neuropeptide expression data to neurons.


07. Load Neurotransmitters and Make Putative Graphs

Binder

Builds putative synaptic graphs using neurotransmitter and receptor identity.


08. All Paths Between Neuron Pair

Binder

Computes and visualizes all possible paths between selected neuron pairs.


09. Load Different Connectomes

Binder

Loads and compares multiple anatomical or functional connectomes.


10. Time Series and Correlations

Binder

Analyzes calcium imaging time series and computes neuron-neuron correlation matrices.


11. Motif Search

Binder

Detects common topological motifs in the connectome using motif-finding tools.


12. Subnetwork Connectivity

Binder

Explores connectivity patterns in user-defined neuron subnetworks.

About

This is a library for multi-omic integration and analysis of whole organism level C elegans data.

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages