biobb-morph 5.0.1
biobb_morph is the Biobb module collection to create patien-specific 3D meshes from IVD template examples.
Requires Python: >=3.9
Keywords: Bioinformatics Workflows BioExcel Compatibility

[![](https://img.shields.io/github/v/tag/bioexcel/biobb_morph?label=Version)](https://GitHub.com/bioexcel/biobb_morph/tags/)
[![](https://img.shields.io/pypi/v/biobb-morph.svg?label=Pypi)](https://pypi.python.org/pypi/biobb-morph/)
[![](https://img.shields.io/conda/vn/bioconda/biobb_morph?label=Conda)](https://anaconda.org/bioconda/biobb_morph)
[![](https://img.shields.io/conda/dn/bioconda/biobb_morph?label=Conda%20Downloads)](https://anaconda.org/bioconda/biobb_morph)
[![](https://img.shields.io/badge/Docker-Quay.io-blue)](https://quay.io/repository/biocontainers/biobb_morph?tab=tags)
[![](https://img.shields.io/badge/Singularity-GalaxyProject-blue)](https://depot.galaxyproject.org/singularity/biobb_morph%3A5.0.1--pyhd7d9b99_0)
[![](https://img.shields.io/badge/OS-Unix%20%7C%20MacOS-blue)](https://github.com/bioexcel/biobb_morph)
[![](https://img.shields.io/pypi/pyversions/biobb-morph.svg?label=Python%20Versions)](https://pypi.org/project/biobb-morph/)
[![](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![](https://img.shields.io/badge/Open%20Source%3f-Yes!-blue)](https://github.com/bioexcel/biobb_morph)

[![](https://readthedocs.org/projects/biobb-morph/badge/?version=latest&label=Docs)](https://biobb-morph.readthedocs.io/en/latest/?badge=latest)
[![](https://img.shields.io/website?down_message=Offline&label=Biobb%20Website&up_message=Online&url=https%3A%2F%2Fmmb.irbbarcelona.org%2Fbiobb%2F)](https://mmb.irbbarcelona.org/biobb/)
[![](https://img.shields.io/badge/Youtube-tutorials-blue?logo=youtube&logoColor=red)](https://www.youtube.com/@BioExcelCoE/search?query=biobb)
[![](https://zenodo.org/badge/DOI/10.1038/s41597-019-0177-4.svg)](https://doi.org/10.1038/s41597-019-0177-4)
[![](https://img.shields.io/endpoint?color=brightgreen&url=https%3A%2F%2Fapi.juleskreuer.eu%2Fcitation-badge.php%3Fshield%26doi%3D10.1038%2Fs41597-019-0177-4)](https://www.nature.com/articles/s41597-019-0177-4#citeas)

[![](https://docs.bioexcel.eu/biobb_morph/junit/testsbadge.svg)](https://docs.bioexcel.eu/biobb_morph/junit/report.html)
[![](https://docs.bioexcel.eu/biobb_morph/coverage/coveragebadge.svg)](https://docs.bioexcel.eu/biobb_morph/coverage/)
[![](https://docs.bioexcel.eu/biobb_morph/flake8/flake8badge.svg)](https://docs.bioexcel.eu/biobb_morph/flake8/)
[![](https://img.shields.io/github/last-commit/bioexcel/biobb_morph?label=Last%20Commit)](https://github.com/bioexcel/biobb_morph/commits/master)
[![](https://img.shields.io/github/issues/bioexcel/biobb_morph.svg?color=brightgreen&label=Issues)](https://GitHub.com/bioexcel/biobb_morph/issues/)

[![fair-software.eu](https://img.shields.io/badge/fair--software.eu-%E2%97%8F%20%20%E2%97%8F%20%20%E2%97%8F%20%20%E2%97%8F%20%20%E2%97%8F-green)](https://fair-software.eu)
[![](https://www.bestpractices.dev/projects/8847/badge)](https://www.bestpractices.dev/projects/8847)

[](https://bestpractices.coreinfrastructure.org/projects/8847/badge)

[//]: # (The previous line invisible link is for compatibility with the howfairis script https://github.com/fair-software/howfairis-github-action/tree/main wich uses the old bestpractices URL)


# biobb_morph

## Introduction
Biobb_morph is a Python library that provides tools for performing 3D morphological transformations of intervertebral disc (IVD) meshes. It enables the creation of patient-personalized 3D models by morphing a morph IVD mesh into a target shape. The library is part of the BioExcel Building Blocks (Biobb) framework.
Biobb (BioExcel building blocks) packages are Python building blocks that
create new layer of compatibility and interoperability over popular
bioinformatics tools.
The latest documentation of this package can be found in our readthedocs site:
[latest API documentation](http://biobb-morph.readthedocs.io/en/latest/).

## Version
v5.0.1 2024.2

### Installation
Using PIP:

> **Important:** PIP only installs the package. All the dependencies must be installed separately. To perform a complete installation, please use ANACONDA, DOCKER or SINGULARITY.

* Installation:


        pip install "biobb_morph>=5.0.1"


* Usage: [Python API documentation](https://biobb-morph.readthedocs.io/en/latest/modules.html)

Using ANACONDA:

* Installation:


        conda install -c bioconda "biobb_morph>=5.0.1"


* Usage: With conda installation BioBBs can be used with the [Python API documentation](https://biobb-morph.readthedocs.io/en/latest/modules.html) and the [Command Line documentation](https://biobb-morph.readthedocs.io/en/latest/command_line.html)

Using DOCKER:

* Installation:


        docker pull quay.io/biocontainers/biobb_morph:5.0.1--pyhd7d9b99_0


* Usage:


        docker run quay.io/biocontainers/biobb_morph:5.0.1--pyhd7d9b99_0 <command>


Using SINGULARITY:

**MacOS users**: it's strongly recommended to avoid Singularity and use **Docker** as containerization system.

* Installation:


        singularity pull --name biobb_morph.sif https://depot.galaxyproject.org/singularity/biobb_morph:5.0.1--pyhd7d9b99_0


* Usage:


        singularity exec biobb_morph.sif <command>


The command list and specification can be found at the [Command Line documentation](https://biobb-morph.readthedocs.io/en/latest/command_line.html).


### Copyright & Licensing
This software has been developed in the [MMB group](http://mmb.irbbarcelona.org) at the [BSC](http://www.bsc.es/) & [IRB](https://www.irbbarcelona.org/) for the [European BioExcel](http://bioexcel.eu/), funded by the European Commission (EU H2020 [823830](http://cordis.europa.eu/projects/823830), EU H2020 [675728](http://cordis.europa.eu/projects/675728)).

* (c) 2015-2025 [Barcelona Supercomputing Center](https://www.bsc.es/)
* (c) 2015-2025 [Institute for Research in Biomedicine](https://www.irbbarcelona.org/)

Licensed under the
[Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0), see the file LICENSE for details.

![](https://bioexcel.eu/wp-content/uploads/2019/04/Bioexcell_logo_1080px_transp.png "Bioexcel")