# NImA
[](https://pypi.org/project/nima/)
[](https://github.com/darosio/nima/actions/workflows/ci.yml)
[](https://codecov.io/gh/darosio/nima)
[](https://nima.readthedocs.io/)
A library and a command-line interface (CLI) designed to assist with image
analysis tasks using scipy.ndimage and scikit-image.
- Version: “0.9.0”
## Features
- Bias and Flat Correction
- Automatic Cell Segmentation
- Multi-Ratio Ratiometric Imaging, enabling users to analyze multiple ratios
with ease.
## Installation
You can get the library directly from [PyPI](https://pypi.org/project/nima/)
using `pip`:
pip install nima
Alternatively, you can use [pipx](https://pypa.github.io/pipx/) to install it in
an isolated environment:
pipx install nima
To enable auto completion for the `nima` command, follow these steps:
1. Generate the completion script by running the following command:
_CLOP_COMPLETE=bash_source nima > ~/.local/bin/nima-complete.bash
2. Source the generated completion script to enable auto completion:
source ~/.local/bin/nima-complete.bash
## Usage
### Library
To use nima in your python code, import it as follows:
from nima import nima, generat, utils
### Command-Line Interface (CLI)
The CLI for this project provides two main commands: `nima` and `bima`. You can
find detailed usage information and examples in the
[documentation](https://nima.readthedocs.io/en/latest/click.html). Here are some
examples of how to use each command:
#### nima
The `nima` command is used to perform multi-ratio ratiometric imaging analyses
on multi-channel TIFF time-lapse stacks.
To perform multi-ratio ratiometric imaging analyses on a multichannel TIFF
time-lapse stack, use the following command:
nima <TIFFSTK> CHANNELS
Replace \<TIFFSTK> with the path to the TIFF time-lapse stack file, and `CHANNELS`
with the channel names. By default, the channels are set to ["G", "R", "C"].
#### bima
The `bima` command is used to compute bias, dark, and flat corrections.
To estimate the detector bias frame:
bima bias <FPATH>
Replace \<FPATH> with the paths to the bias stack (Light Off - 0 acquisition time).
To estimate the system dark (multi-channel) frame:
bima dark <FPATH>
Replace \<FPATH> with the paths to the dark stack (Light Off - Long acquisition time).
Note: The estimation of the system dark may be removed in future versions
because it risks being redundant with the flat estimation. It is likely to be
removed soon.
To estimate the system flat (multi-channel) frame:
bima flat --bias <BIAS_PATH> <FPATH>
Replace \<FPATH> with the path to the tf8 stack and <BIAS_PATH> with the path to
the bias image.
## Contributing
Contributions to the project are welcome!
If you are interested in contributing to the project, please read our
[contributing](https://darosio.github.io/ClopHfit/references/contributing.html)
and [development
environment](https://darosio.github.io/ClopHfit/references/development.html)
guides, which outline the guidelines and conventions that we follow for
contributing code, documentation, and other resources.
## License
We use a shared copyright model that enables all contributors to maintain the
copyright on their contributions - see the [revised BSD license](LICENSE.txt)
for details.
## Acknowledgments
Special thanks to the developers of scipy.ndimage and scikit-image for their
invaluable contributions to image processing in Python.
Raw data
{
"_id": null,
"home_page": null,
"name": "nima",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.12,>=3.10",
"maintainer_email": null,
"keywords": "ClopHensor, chloride, image analysis, pH, ratio imaging",
"author": null,
"author_email": "daniele arosio <daniele.arosio@cnr.it>",
"download_url": "https://files.pythonhosted.org/packages/19/87/c11cc2b5043d84b80c45b3c87a111b778b9e17160c4d1ce7eab8d7e2e7a9/nima-0.9.0.tar.gz",
"platform": null,
"description": "# NImA\n\n[](https://pypi.org/project/nima/)\n[](https://github.com/darosio/nima/actions/workflows/ci.yml)\n[](https://codecov.io/gh/darosio/nima)\n[](https://nima.readthedocs.io/)\n\nA library and a command-line interface (CLI) designed to assist with image\nanalysis tasks using scipy.ndimage and scikit-image.\n\n- Version: \u201c0.9.0\u201d\n\n## Features\n\n- Bias and Flat Correction\n- Automatic Cell Segmentation\n- Multi-Ratio Ratiometric Imaging, enabling users to analyze multiple ratios\n with ease.\n\n## Installation\n\nYou can get the library directly from [PyPI](https://pypi.org/project/nima/)\nusing `pip`:\n\n pip install nima\n\nAlternatively, you can use [pipx](https://pypa.github.io/pipx/) to install it in\nan isolated environment:\n\n pipx install nima\n\nTo enable auto completion for the `nima` command, follow these steps:\n\n1. Generate the completion script by running the following command:\n\n _CLOP_COMPLETE=bash_source nima > ~/.local/bin/nima-complete.bash\n\n2. Source the generated completion script to enable auto completion:\n\n source ~/.local/bin/nima-complete.bash\n\n## Usage\n\n### Library\n\nTo use nima in your python code, import it as follows:\n\n from nima import nima, generat, utils\n\n### Command-Line Interface (CLI)\n\nThe CLI for this project provides two main commands: `nima` and `bima`. You can\nfind detailed usage information and examples in the\n[documentation](https://nima.readthedocs.io/en/latest/click.html). Here are some\nexamples of how to use each command:\n\n#### nima\n\nThe `nima` command is used to perform multi-ratio ratiometric imaging analyses\non multi-channel TIFF time-lapse stacks.\n\nTo perform multi-ratio ratiometric imaging analyses on a multichannel TIFF\ntime-lapse stack, use the following command:\n\n nima <TIFFSTK> CHANNELS\n\nReplace \\<TIFFSTK> with the path to the TIFF time-lapse stack file, and `CHANNELS`\nwith the channel names. By default, the channels are set to [\"G\", \"R\", \"C\"].\n\n#### bima\n\nThe `bima` command is used to compute bias, dark, and flat corrections.\n\nTo estimate the detector bias frame:\n\n bima bias <FPATH>\n\nReplace \\<FPATH> with the paths to the bias stack (Light Off - 0 acquisition time).\n\nTo estimate the system dark (multi-channel) frame:\n\n bima dark <FPATH>\n\nReplace \\<FPATH> with the paths to the dark stack (Light Off - Long acquisition time).\n\nNote: The estimation of the system dark may be removed in future versions\nbecause it risks being redundant with the flat estimation. It is likely to be\nremoved soon.\n\nTo estimate the system flat (multi-channel) frame:\n\n bima flat --bias <BIAS_PATH> <FPATH>\n\nReplace \\<FPATH> with the path to the tf8 stack and <BIAS_PATH> with the path to\nthe bias image.\n\n## Contributing\n\nContributions to the project are welcome!\n\nIf you are interested in contributing to the project, please read our\n[contributing](https://darosio.github.io/ClopHfit/references/contributing.html)\nand [development\nenvironment](https://darosio.github.io/ClopHfit/references/development.html)\nguides, which outline the guidelines and conventions that we follow for\ncontributing code, documentation, and other resources.\n\n## License\n\nWe use a shared copyright model that enables all contributors to maintain the\ncopyright on their contributions - see the [revised BSD license](LICENSE.txt)\nfor details.\n\n## Acknowledgments\n\nSpecial thanks to the developers of scipy.ndimage and scikit-image for their\ninvaluable contributions to image processing in Python.\n",
"bugtrack_url": null,
"license": null,
"summary": "Numerical IMage Analyses.",
"version": "0.9.0",
"project_urls": {
"homepage": "https://github.com/darosio/nima/",
"repository": "https://github.com/darosio/nima/"
},
"split_keywords": [
"clophensor",
" chloride",
" image analysis",
" ph",
" ratio imaging"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "f8cd8593e9528dc7c093c899f6da93a258e9725b523dcb0ffe527653ac656770",
"md5": "05bbc0938cc17211ba0c6d81ad649c67",
"sha256": "d9d03335f4ad2ddbaffd0a2ee22efd52f40e98606d3ff70bf58b78a547fadbd7"
},
"downloads": -1,
"filename": "nima-0.9.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "05bbc0938cc17211ba0c6d81ad649c67",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.12,>=3.10",
"size": 23888,
"upload_time": "2024-03-28T14:28:34",
"upload_time_iso_8601": "2024-03-28T14:28:34.968504Z",
"url": "https://files.pythonhosted.org/packages/f8/cd/8593e9528dc7c093c899f6da93a258e9725b523dcb0ffe527653ac656770/nima-0.9.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "1987c11cc2b5043d84b80c45b3c87a111b778b9e17160c4d1ce7eab8d7e2e7a9",
"md5": "a168796ea1a5af75f8d3075a3d0bb9e0",
"sha256": "3fd55cdc03a9f8b96f55c3ff52b1a60f1000b6c34c2edebe1c2667ecbb850d9f"
},
"downloads": -1,
"filename": "nima-0.9.0.tar.gz",
"has_sig": false,
"md5_digest": "a168796ea1a5af75f8d3075a3d0bb9e0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.12,>=3.10",
"size": 7625001,
"upload_time": "2024-03-28T14:28:32",
"upload_time_iso_8601": "2024-03-28T14:28:32.561857Z",
"url": "https://files.pythonhosted.org/packages/19/87/c11cc2b5043d84b80c45b3c87a111b778b9e17160c4d1ce7eab8d7e2e7a9/nima-0.9.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-28 14:28:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "darosio",
"github_project": "nima",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "nima"
}
JSON
