This project contains several workflows for processing morphologies:
Curate: from raw morphologies, ensures that morphologies can be used with the rest of BBP codes
Annotate: create various annotations on morphologies needed by specific BBP codes
Repair: process morphologies to correct for artifacts of in-vitro reconstruction
In a nutshell, the user provides a list of morphologies in a
.csv file, with their names and
paths and a
luigi.cfg configuration file. Each workflow is run independently and creates an
output folder, with one subfolder per task. In each, there will be a
report.csv and a
folder containing the output files of the task if any. In the
report.csv file, columns contain
paths to these files, additional information, error messages if the task failed on that
morphologies, as well as a flag
is_valid, used in subsequent tasks to filter valid morphologies.
At the end of each workflow, another
report.csv file is created, with the main output columns of
each tasks, and a
report.pdf containing a human readable summary of the result of the workflow.
This should be installed using pip:
pip install morphology-workflows
This workflow is based on the
luigi library but can be run via the command line interface:
morphology_workflows --local-scheduler Curate
NOTE This command must be executed from a directory containing a
luigi.cfgfile. An example of such file is given in the
More details can be found in the command line interface section of the documentation.
examples folder contains a simple example that will process a set of morphologies.
dataset.csv file is provided which is taken as input for the workflows. A
is also provided to give a default configuration for the workflows.
This example can simply be run using the following command:
This script will create a new directory
out_curated which will contain the report and all the
Funding & Acknowledgment¶
The development of this software was supported by funding to the Blue Brain Project, a research center of the École polytechnique fédérale de Lausanne (EPFL), from the Swiss government’s ETH Board of the Swiss Federal Institutes of Technology.
For license and authors, see
Copyright © 2021 Blue Brain Project/EPFL