No Description

Ajayrama Kumaraswamy bb138447e6 Applied changes to mirror those on Github and update to 2.0 3 years ago
ParFiles c5fcd4aa0b imported code from https://github.com/wachtlerlab/Reg-MaxS v1.1 6 years ago
TestFiles c5fcd4aa0b imported code from https://github.com/wachtlerlab/Reg-MaxS v1.1 6 years ago
regmaxsn 742f305d13 changes for Python 3.7+ compatibility; minor bug fixes 3 years ago
tests 742f305d13 changes for Python 3.7+ compatibility; minor bug fixes 3 years ago
.gitignore c5fcd4aa0b imported code from https://github.com/wachtlerlab/Reg-MaxS v1.1 6 years ago
LICENSE-CCBY c5fcd4aa0b imported code from https://github.com/wachtlerlab/Reg-MaxS v1.1 6 years ago
Readme.md bb138447e6 Applied changes to mirror those on Github and update to 2.0 3 years ago
datacite.yml 715bb32f77 added datacite.yml 6 years ago
setup.py 742f305d13 changes for Python 3.7+ compatibility; minor bug fixes 3 years ago
setupWorkspace.py 742f305d13 changes for Python 3.7+ compatibility; minor bug fixes 3 years ago

Readme.md

Welcome to regmaxsn repository! This is a snapshot of v2.0 of the GitHub repository https://github.com/wachtlerlab/Reg-MaxS. Updates and Newer versions of the software are posted on the Github repository.

Description

Reg-MaxS and Reg-MaxS-N: Algorithms for co-registration of pairs and groups of neuron morphologies based on maximization of spatial overlap

These algorithms have been discussed in detail in the following publication:

Kumaraswamy A., Kai K., Ai H., Ikeno H., Wachtler T. (2018). "Spatial registration of neuron morphologies based on maximization of volume overlap". In BMC Bioinformatics, DOI: 10.1186/s12859-018-2136-z

This repository contains scripts for running Reg-MaxS and Reg-MaxS-N algorithms for registering pairs and groups of neuron morphologies respectively.

The algorithms are written in Python and at the moment work only with SWC files.

Installation

With Conda (Linux or Windows):

  1. Create a new environment: >conda create --name regmaxsn python=3.7 numpy scipy pillow matplotlib scikit-learn pandas seaborn openpyxl xlrd statsmodels
  2. Activate environment: >(on Linux) source activate regmaxsn >(on Windows) activate regmaxsn
  3. Install regmaxsn: >pip install <path to Reg-MaxS repository>
  4. Create Reg-MaxS Workspace. Note where your Reg-MaxS Workspace is created. >python <path to Reg-MaxS repository>/setupWorkspace.py

Without Conda, with pip and virtualenvwrapper (only for Linux):

  1. Create a new environment: >mkvirtualenv regmaxsn
  2. Activate environment: >workon regmaxsn
  3. Install regmaxsn: >pip install <path to Reg-MaxS repository>
  4. Create Reg-MaxS Workspace. Note where your Reg-MaxS Workspace is created. >python <path to Reg-MaxS repository>/setupWorkspace.py

NOTE: This environment must be activated every time you want to run Reg-MaxS, Reg-MaxS-N or any other scripts of this package.

Usage:

Reg-MaxS

  1. First you need to create a parameter file for Reg-MaxS. This is created using the file > <path to your Reg-MaxS Workspace>/utilityScripts/constructRegMaxSParFile.py

You need to open this .py file in a editor and change variables as needed. The detailed usage instructions of this script are provided at the top of it. Two different use cases have been illustrated using three examples. Take a look at them and modify the script according to your needs.

  1. After editing the "constructRegMaxSParFile.py" as needed, create a parameter file as below:

    python <path to your Reg-MaxS Workspace>/utilityScripts/constructRegMaxSParFile.py

  2. Run Reg-MaxS with this parameter file:

    python -m regmaxsn.scripts.algorithms.RegMaxS <path to the above created Reg-MaxS parameter file>

Reg-MaxS-N

  1. First you need to create a parameter file for Reg-MaxS-N. This is created using the file > <path to your Reg-MaxS Workspace>/utilityScripts/constructRegMaxSNParFile.py

You need to open this .py file in a editor and change variables as needed. The detailed usage instructions of this script are provided at the top of it. Two different use cases have been illustrated using three examples. Take a look at them and modify the script according to your needs.

  1. After editing the "constructRegMaxSNParFile.py" as needed, create a parameter file as below:

    python <path to your Reg-MaxS Workspace>/utilityScripts/constructRegMaxSNParFile.py

  2. Run Reg-MaxS-N with this parameter file:

    python -m regmaxsn.scripts.algorithms.RegMaxSN <path to the above created Reg-MaxS-N parameter file>

datacite.yml
Title Reg-MaxS and Reg-MaxS-N: Algorithms for co-registration of pairs and groups of neuron morphologies based on maximization of spatial overlap
Authors Kumaraswamy,Ajayrama;Department of Biology II, Ludwig-Maximilians-Universität München, 82152 Planegg-Martinsried, Germany;orcid.org/0000-0001-7928-877X
Description Algorithms for registering pairs and groups of SWC neuronal morphologies based on maximizing spatial overlap.
License CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/)
References Kumaraswamy A., Kai K., Ai H., Ikeno H., Wachtler T. (2018). Spatial registration of neuron morphologies based on maximization of volume overlap. BMC Bioinformatics. [] (IsDescribedBy)
https://github.com/wachtlerlab/Reg-MaxS [] (IsPartOf)
Funding BMBF, 01GQ1116
BMBF, 01GQ1302
Keywords Neuroscience
Neuron morphology
Spatial registration
Resource Type Dataset