# pytransformix
A python3 wrapper for `transformix`, a command-line utility provided as part of the package [elastix](https://elastix.lumc.nl/index.php)
Currently runs on MacOS and Linux.
## Installation
### Step 1
**Either** `pip install` this package directly from GitHub:
pip install git+https://github.com/jasper-tms/pytransformix.git
**or** first `git clone` it and then `pip install` it from your clone:
cd ~/repos # Or wherever on your computer you want to download this code to
git clone https://github.com/jasper-tms/pytransformix.git
cd pytransformix
pip install .
### Step 2
Install [elastix](https://elastix.lumc.nl/download.php) by first downloading it from the [releases page](https://github.com/SuperElastix/elastix/releases). Operating system compatibility notes:
- Ubuntu 20.04: Use elastix-5.0.1 or the latest version.
- Ubuntu 18.04: Use elastix-5.0.0
- Ubuntu 16.04: Use elastix-4.9.0
- MacOS: elastix-5.0.1 worked on Big Sur, and I haven't tested other combinations. Probably safe to download the latest version.
Then extract the `.zip` or `.tar.gz` file you downloaded and put the folder somewhere on your computer. Then add that folder's `bin` subdirectory to your shell `PATH` and that folder's `lib` subdirectory to your shell `LD_LIBRARY_PATH`. For example, if you put the folder at `~/software/elastix-5.0.1-linux`, then add these three lines of text
export PATH=~/software/elastix-5.0.1-linux/bin:$PATH
export LD_LIBRARY_PATH=~/software/elastix-5.0.1-linux/lib${LD_LIBRARY_PATH+:$LD_LIBRARY_PATH}
export DYLD_LIBRARY_PATH=~/software/elastix-5.0.1-linux/lib${DYLD_LIBRARY_PATH+:$DYLD_LIBRARY_PATH}
to your shell config file (`~/.bashrc` for bash on Linux, `~/.bash_profile` for bash on Mac, or `~/.zshrc` for zsh on Mac). Then open up a new terminal and run `elastix`. If you see `Use "elastix --help" for information about elastix-usage.`, you're good to go. If not, feel free to [open an issue](https://github.com/jasper-tms/pytransformix/issues) and I can try to help.
Raw data
{
"_id": null,
"home_page": "https://github.com/jasper-tms/pytransformix",
"name": "transformix",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "",
"author": "Jasper Phelps",
"author_email": "jasper.s.phelps@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/e5/6f/ca533a695cc92b470bafd23b5a40e6383595099aa4eb9206d9edf32bd399/transformix-1.0.1.tar.gz",
"platform": null,
"description": "# pytransformix\n\nA python3 wrapper for `transformix`, a command-line utility provided as part of the package [elastix](https://elastix.lumc.nl/index.php)\n\nCurrently runs on MacOS and Linux.\n\n\n## Installation\n### Step 1\n**Either** `pip install` this package directly from GitHub:\n \n \n pip install git+https://github.com/jasper-tms/pytransformix.git\n\n**or** first `git clone` it and then `pip install` it from your clone:\n\n cd ~/repos # Or wherever on your computer you want to download this code to\n git clone https://github.com/jasper-tms/pytransformix.git\n cd pytransformix\n pip install .\n\n### Step 2\nInstall [elastix](https://elastix.lumc.nl/download.php) by first downloading it from the [releases page](https://github.com/SuperElastix/elastix/releases). Operating system compatibility notes:\n- Ubuntu 20.04: Use elastix-5.0.1 or the latest version.\n- Ubuntu 18.04: Use elastix-5.0.0\n- Ubuntu 16.04: Use elastix-4.9.0\n- MacOS: elastix-5.0.1 worked on Big Sur, and I haven't tested other combinations. Probably safe to download the latest version.\n\nThen extract the `.zip` or `.tar.gz` file you downloaded and put the folder somewhere on your computer. Then add that folder's `bin` subdirectory to your shell `PATH` and that folder's `lib` subdirectory to your shell `LD_LIBRARY_PATH`. For example, if you put the folder at `~/software/elastix-5.0.1-linux`, then add these three lines of text\n\n export PATH=~/software/elastix-5.0.1-linux/bin:$PATH\n export LD_LIBRARY_PATH=~/software/elastix-5.0.1-linux/lib${LD_LIBRARY_PATH+:$LD_LIBRARY_PATH}\n export DYLD_LIBRARY_PATH=~/software/elastix-5.0.1-linux/lib${DYLD_LIBRARY_PATH+:$DYLD_LIBRARY_PATH}\n\nto your shell config file (`~/.bashrc` for bash on Linux, `~/.bash_profile` for bash on Mac, or `~/.zshrc` for zsh on Mac). Then open up a new terminal and run `elastix`. If you see `Use \"elastix --help\" for information about elastix-usage.`, you're good to go. If not, feel free to [open an issue](https://github.com/jasper-tms/pytransformix/issues) and I can try to help.\n",
"bugtrack_url": null,
"license": "GNU GPL v3",
"summary": "Python wrappers for transformix",
"version": "1.0.1",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f219cc3bb9ab2bef6b14eeb5fe5571bdc9bfff1db39fcc6b9c55a277ee17ee91",
"md5": "b3efacab16d8f12b937fbf106c5f5722",
"sha256": "d586a3ca1a606309be73792c0a4229dc0cd67b5eb8676c208b759cbeb39157dd"
},
"downloads": -1,
"filename": "transformix-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b3efacab16d8f12b937fbf106c5f5722",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 17197,
"upload_time": "2023-01-12T10:05:47",
"upload_time_iso_8601": "2023-01-12T10:05:47.308041Z",
"url": "https://files.pythonhosted.org/packages/f2/19/cc3bb9ab2bef6b14eeb5fe5571bdc9bfff1db39fcc6b9c55a277ee17ee91/transformix-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e56fca533a695cc92b470bafd23b5a40e6383595099aa4eb9206d9edf32bd399",
"md5": "b5ba38e69a650ce7257b9aef5afaa27e",
"sha256": "14ae5509ed1bd3cbdcfe0d5d2c5beb2896a5d1f9ba8e4c93511b9b58a733c92d"
},
"downloads": -1,
"filename": "transformix-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "b5ba38e69a650ce7257b9aef5afaa27e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 16953,
"upload_time": "2023-01-12T10:05:49",
"upload_time_iso_8601": "2023-01-12T10:05:49.774261Z",
"url": "https://files.pythonhosted.org/packages/e5/6f/ca533a695cc92b470bafd23b5a40e6383595099aa4eb9206d9edf32bd399/transformix-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-12 10:05:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "jasper-tms",
"github_project": "pytransformix",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "numpy",
"specs": []
}
],
"lcname": "transformix"
}