/suarez_neuromorphicnetworks

Code supporting Suarez et al., Learning function from structure in neuromorphic networks. Nat Mach Intell 3, 771–786 (2021).

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Learning function from structure in neuromorphic networks

"What's in this repository?"

This repository contains code for the manuscript "Learning function from structure in neuromorphic networks" by Laura Suarez, Blake Richards, Guillaume Lajoie & Bratislav Misic.

We investigated the link between macroscale connectivity and the computational properties that emerge from network dynamics in the human connectome.

We've tried to document the various aspects of this repository with this README file, so feel free to check things out!

This repository can be referenced using DOI

"How to run the things from scratch?"

First, you'll need to make sure you have installed the appropriate software packages, and have downloaded the appropriate data files.

  1. Git clone the suarez_neuromorphicnetworks repository.
  2. Download the "data" and "raw_results" folder from DOI and place them into the repository's root directory.
  3. In the command line, type:
cd suarez_neuromorphicnetworks
conda env create -f environment.yml
conda activate rc
  1. Git clone reservoir repository.
  2. And install it in the newly created environment:
cd reservoir
pip install .
  1. Then, follow these steps sequentially (i.e., first "Run simulations", then "Compile results" and then "Analyses and Figures").

Step 1. Run simulations

python scripts/01_rc_workflow/1_run_rc_workflow.py

python scripts/01_rc_workflow/2_get_network_properties.py

Step 2. Compile results

python scripts/02_fetch_results/fetch_task_results.py

python scripts/02_fetch_results/fetch_net_props_results.py

Step 3. Analyses and figures

python scripts/03_analysis/figX.py

(replace X by the number of the figure)

"How to run only the analyses?"

  1. Git clone the suarez_neuromorphicnetworks repository.
  2. Download the "data" and "proc_results" folders from DOI and place them into the repository's root directory.

To run the analysis presented in Figure "X" of the manuscript, you just need to run:

python scripts/03_analysis/figX.py

"I have some questions..."

Open an issue on this repository and someone will try and get back to you as soon as possible!