Skip to main content

Some scripts to register images in space and time

Project description

Registration tools

Before everything else, the current status of the whole thing here is that it only works on UNIX systems (eg Linux & MacOs) that have reasonnable chips (eg not M1 chips for example).

Purpose and "history"

This repository is about two scripts to do spatial and temporal registration of 3D microscopy images. It was initially developed to help friends with their ever moving embryos living under a microscope. I found that actually quite a few people were interested so I made a version of it that is somewhat easier to use.

In theory, the main difficulty to make the whole thing work is to install the different libraries.

Credits

The whole thing is just a wrapping of the amazing blockmatching algorithm developed by S. Ourselin et al. and currently maintained Grégoire Malandin et al.@Team Morphem - inria (if I am not mistaking).

Installation

conda and pip are required to install registration-tools

We recommand to install the registration tools in a specific environement (like conda). For example the following way:

conda create -n registration python=3.10

You can then activate the environement the following way:

conda activate registration

For here onward we assume that you are running the commands from the registration conda environement.

Then, to install the whole thing, it is necessary to first install blockmatching. To do so you can run the following command:

conda install vt -c morpheme -c trcabel

Then, you can install the 3D-registration library either directly via pip:

pip install 3D-registration

Or, if you want the latest version, by specifying the git repository:

pip install git+https://github.com/GuignardLab/registration-tools.git

Troubleshooting

  • Windows:

    If you are trying to run the script on Windows you might need to install pthreadvse2.dll.

    It can be found there: https://www.pconlife.com/viewfileinfo/pthreadvse2-dll/ . Make sure to download the version that matches your operating system (32 or 64 bits, most likely 64).

  • MacOs:

    As there are no M1 binaries available yet, please use rosetta or install an intel version of conda.

Usage

Most of the description on how to use the two scripts is described in the manual (Note that the installation part is quite outdated, the remaining is ok).

That being said, once installed, one can run either of the scripts from anywhere in a terminal by typing:

time-registration

or

spatial-registration

The location of the json files or folder containing the json files will be prompted and when provided the registration will start.

It is also possible to run the registration from a script/notebook the following way:

from registrationtools import TimeRegistration
tr = TimeRegistration('path/to/param.json')
tr.run_trsf()

or

from registrationtools import TimeRegistration
tr = TimeRegistration('path/to/folder/with/jsonfiles/')
tr.run_trsf()

or

from registrationtools import TimeRegistration
tr = TimeRegistration()
tr.run_trsf()

and a path will be asked to be inputed.

Example json files

Few example json files are provided to help the potential users. You can find informations about what they do in the manual.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

3D-registration-0.5.1.tar.gz (211.7 kB view details)

Uploaded Source

Built Distribution

3D_registration-0.5.1-py3-none-any.whl (218.9 kB view details)

Uploaded Python 3

File details

Details for the file 3D-registration-0.5.1.tar.gz.

File metadata

  • Download URL: 3D-registration-0.5.1.tar.gz
  • Upload date:
  • Size: 211.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/0.0.0 CPython/3.10.8

File hashes

Hashes for 3D-registration-0.5.1.tar.gz
Algorithm Hash digest
SHA256 a426c105c02fba88dc18c49ddc86fcfc7a1a6ad8745b6e7f1b44c1c567c5458f
MD5 1ff2811bc387c2611ce1d214cd8e4d2a
BLAKE2b-256 019b34d90e01aecc591a33cf75003c192b4362e278fb8691ab8b48426c72da99

See more details on using hashes here.

File details

Details for the file 3D_registration-0.5.1-py3-none-any.whl.

File metadata

File hashes

Hashes for 3D_registration-0.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 845cd46bf693a90d3c94754b5901ed84ff5635aeecf9b24f4e158d36002b10b2
MD5 87d9e158e32a874240a2f08af2f5078b
BLAKE2b-256 ae26bc07356cd0248d8e5a1f2e7789abeb7717ddd6ef2c6ad09b53352c08767e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page