# li'l AreTomo
A lightweight Python API for [AreTomo](https://www.biorxiv.org/content/10.1101/2022.02.15.480593v1).
## Installation
It is recommended to install into a fresh virtual environment.
```sh
pip install lil_aretomo
```
## Usage
```python
import numpy as np
import mrcfile
from lil_aretomo import align_tilt_series
tilt_series = mrcfile.read('my_tilt_series.mrc')
align_tilt_series(
tilt_series=tilt_series,
tilt_angles=np.linspace(-60, 60, 41),
pixel_size=1.35, # angstroms per pixel
sample_thickness_nanometers=2000, # angstroms
correct_tilt_angle_offset=True,
basename='TS_01', # basename for files passed to AreTomo
output_directory='TS_01_AreTomo',
skip_if_completed=False # set to True to skip if results from a previous alignment are present
)
```
### For developers
We use pre-commit to ensure code style and formatting remains consistent.
To install the package in editable mode development dependencies
```sh
pip install -e .[dev]
pre-commit install
```
Flake8, black and isort will then run automatically on each commit.
Raw data
{
"_id": null,
"home_page": "https://github.com/EuanPyle/lil_aretomo",
"name": "lil-aretomo",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Euan Pyle",
"author_email": "euanpyle@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/6a/52/5226ffe39caa5f12ba6ab8172466952c5d4799e8d5d2906529f0d0932731/lil_aretomo-0.1.1.tar.gz",
"platform": null,
"description": "# li'l AreTomo\n\nA lightweight Python API for [AreTomo](https://www.biorxiv.org/content/10.1101/2022.02.15.480593v1).\n\n## Installation\n\nIt is recommended to install into a fresh virtual environment.\n\n```sh\npip install lil_aretomo\n```\n\n## Usage\n\n```python\nimport numpy as np\nimport mrcfile\nfrom lil_aretomo import align_tilt_series\n\ntilt_series = mrcfile.read('my_tilt_series.mrc')\n\nalign_tilt_series(\n tilt_series=tilt_series,\n tilt_angles=np.linspace(-60, 60, 41),\n pixel_size=1.35, # angstroms per pixel\n sample_thickness_nanometers=2000, # angstroms\n correct_tilt_angle_offset=True,\n basename='TS_01', # basename for files passed to AreTomo\n output_directory='TS_01_AreTomo',\n skip_if_completed=False # set to True to skip if results from a previous alignment are present\n)\n```\n\n### For developers\n\nWe use pre-commit to ensure code style and formatting remains consistent.\n\nTo install the package in editable mode development dependencies\n\n```sh\npip install -e .[dev]\npre-commit install\n```\n\nFlake8, black and isort will then run automatically on each commit.\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "AreTomo (w)rapper for rln4",
"version": "0.1.1",
"project_urls": {
"Homepage": "https://github.com/EuanPyle/lil_aretomo",
"Source Code": "https://github.com/EuanPyle/lil_aretomo"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "788510273a7dede1739a6c16062956a4d78db13c5f15f347e3fb580c48ec2538",
"md5": "c382a962706dfd40a59857a1804167bd",
"sha256": "7318f945626f66b7700eac7b27172849d8991d02e87d55a17ba5d09263c08e8e"
},
"downloads": -1,
"filename": "lil_aretomo-0.1.1-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "c382a962706dfd40a59857a1804167bd",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.8",
"size": 6847,
"upload_time": "2024-06-05T09:32:16",
"upload_time_iso_8601": "2024-06-05T09:32:16.998893Z",
"url": "https://files.pythonhosted.org/packages/78/85/10273a7dede1739a6c16062956a4d78db13c5f15f347e3fb580c48ec2538/lil_aretomo-0.1.1-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6a525226ffe39caa5f12ba6ab8172466952c5d4799e8d5d2906529f0d0932731",
"md5": "9969aa604e174861c215c1b4df0c48c6",
"sha256": "02ccb0efbf2c06304570117f142e78331bfffdde46864e22de11c6cd7f30f178"
},
"downloads": -1,
"filename": "lil_aretomo-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "9969aa604e174861c215c1b4df0c48c6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 10018,
"upload_time": "2024-06-05T09:32:18",
"upload_time_iso_8601": "2024-06-05T09:32:18.610452Z",
"url": "https://files.pythonhosted.org/packages/6a/52/5226ffe39caa5f12ba6ab8172466952c5d4799e8d5d2906529f0d0932731/lil_aretomo-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-05 09:32:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "EuanPyle",
"github_project": "lil_aretomo",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "lil-aretomo"
}