Skip to main content

Package to support the research of LIOM.

Project description

Liom Toolkit

This package supports the research being done by the Laboratoire d’Imagerie Optique et Moléculaire at Polytechnique Montréal. It hosts a collection of scripts used to process and analyze data collected by the lab.

Build and Publish Toolkit Documentation Status

Installation

The package can be installed using pip:

pip install liom-toolkit

Due to the complicated requirements, a detailed installation guide is provided below.

Usage

Demonstrations of some of the functionalities of the package can be found in the notebooks in the LIOM Notebooks repository. The repository can be found here: LIOM Notebooks

Requirements

The package requires the following packages to be installed and will attempt to install them using installation:

  • antspyx
  • tqdm
  • scikit-image
  • ome-zarr
  • nibabel
  • zarr
  • h5py
  • pynrrd
  • PyWavelets
  • SimpleITK
  • allensdk
  • dask
  • opencv-python
  • torch
  • torchvision
  • wandb
  • patchify
  • natsort
  • albumentations

To create an anaconda environment with all the required packages, run the following commands:

conda create -n <name>
conda activate <name>
conda install python=3.10

# Install Pytorch at this point, follow the instructions on the Pytorch website:
# https://pytorch.org/get-started/locally/
# Make sure the right version is installed for your system. Check for CUDA compatibility.
# For example, for Linux with a CUDA compatible GPU:
conda install pytorch torchvision torchaudio pytorch-cuda=12.1 -c pytorch -c nvidia
# For MacOS:
conda install pytorch::pytorch torchvision torchaudio -c pytorch

# The lines below are for Apple Silicon specifically. 
# Hdf5 needs to be installed using homebrew.
# Tables is used by the allenSDK and requires hdf5 to be installed.
# On apple silicon, HDF5 is not automatically installed by tables or detected on the system.
brew install hdf5
HDF5_DIR=/opt/homebrew/Cellar/hdf5/1.14.3_1 pip install tables

# From now on pip will be used to install the packages. Some packages are not available on conda, or are out of date.
pip install allensdk
pip install antspyx
pip install liom-toolkit

# To build the documentation of the package
pip install sphinx-rtd-theme
pip install sphinxcontrib-apidoc

# To run the LIOM Notebooks
pip install jupyter

Package Structure

The package contains the following modules:

Registration

The registration module is concerned with performing registration on brain imagery. It hosts a collection of scripts for registering mouse brains to the Allen Atlas as well as functions for creating brain templates to use in registration.

Segmentation

The segmentation module is concerned with segmenting brain imagery. It contains methods for segmenting brain images into different regions of interest. The vseg submodule contains methods for segmenting vasculature using deep learning using a U-net architecture. The pretrained model is trained on LSFM data.

Utils

Various utility functions used by the other modules. These include function for converting between the different data files used within the lab.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

liom_toolkit-0.8.18.tar.gz (55.4 kB view details)

Uploaded Source

Built Distribution

liom_toolkit-0.8.18-py3-none-any.whl (56.9 kB view details)

Uploaded Python 3

File details

Details for the file liom_toolkit-0.8.18.tar.gz.

File metadata

  • Download URL: liom_toolkit-0.8.18.tar.gz
  • Upload date:
  • Size: 55.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for liom_toolkit-0.8.18.tar.gz
Algorithm Hash digest
SHA256 d97a360a6d7bdb5921396d439dda42a8af9fc0b658fa8f9e39312777291f4114
MD5 7db82661c4df29300960d8ae4344802f
BLAKE2b-256 7a0459a39f45e861486184e8bf3db8ac9c69fb8fa1edaa83095a9a66390e6815

See more details on using hashes here.

File details

Details for the file liom_toolkit-0.8.18-py3-none-any.whl.

File metadata

File hashes

Hashes for liom_toolkit-0.8.18-py3-none-any.whl
Algorithm Hash digest
SHA256 6f7cd9574871ff8d12f11045f00b8a9f763a23043ab49d85e716d747fb97d79e
MD5 4c684eb0728b65dfc7ce197caae2ff7a
BLAKE2b-256 81c11605880de43764c12b3fdb6fff1b41aa2dc1b276458ea3cb93992cc87b6b

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