| Name | nrtk JSON |
| Version |
0.16.0
JSON |
| download |
| home_page | None |
| Summary | An open source toolkit for evaluating the natural robustness of computer vision algorithms. |
| upload_time | 2024-11-19 23:18:45 |
| maintainer | None |
| docs_url | None |
| author | Kitware, Inc. |
| requires_python | <4.0,>=3.9 |
| license | Apache-2.0 |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Natural Robustness Toolkit (NRTK)
The `nrtk` package is an open source toolkit for evaluating the natural robustness of computer vision
algorithms to various perturbations, including sensor-specific changes to camera focal length, aperture
diameter, etc. Functionality is provided through [Strategy](https://en.wikipedia.org/wiki/Strategy_pattern)
and [Adapter](https://en.wikipedia.org/wiki/Adapter_pattern) patterns to allow for modular integration
into systems and applications.
We have also created the [`nrtk-jatic`](https://github.com/Kitware/nrtk-jatic) package to support AI T&E
use-cases and workflows, through interoperability with the [`maite`](https://github.com/mit-ll-ai-technology/maite)
library and integration with other [JATIC](https://cdao.pages.jatic.net/public/) tools. Users seeking to use NRTK to
perturb MAITE-wrapped datasets or evaluate MAITE-wrapped models should
start with the `nrtk-jatic` package.
<!-- :auto installation: -->
## Installation
The following steps assume the source tree has been acquired locally.
Install the current version via pip:
```bash
pip install nrtk
```
Alternatively, you can also use [Poetry](https://python-poetry.org/):
```bash
poetry install --sync --with dev-linting,dev-testing,dev-docs
```
See [here for more installation documentation](
https://nrtk.readthedocs.io/en/latest/installation.html).
<!-- :auto installation: -->
<!-- :auto getting-started: -->
## Getting Started
We provide a number of examples based on Jupyter notebooks in the
`./examples/` directory to show usage of the `nrtk` package in a number
of different contexts.
Contributions are welcome!
See the [CONTRIBUTING.md](./CONTRIBUTING.md) file for details.
<!-- :auto getting-started: -->
<!-- :auto documentation: -->
## Documentation
Documentation snapshots for releases as well as the latest master are hosted
on [ReadTheDocs](https://nrtk.readthedocs.io/en/latest/).
The sphinx-based documentation may also be built locally for the most
up-to-date reference:
```bash
# Install dependencies
poetry install --sync --with dev-linting,dev-testing,dev-docs
# Navigate to the documentation root.
cd docs
# Build the docs.
poetry run make html
# Open in your favorite browser!
firefox _build/html/index.html
```
<!-- :auto documentation: -->
<!-- :auto developer-tools: -->
## Developer tools
**pre-commit hooks**
pre-commit hooks are used to ensure that any code meets all linting and
formatting guidelines required. After installing, this will always run before
committing to ensure that any commits are following the standards, but you
can also manually run the check without committing. If you want to commit
despite there being errors, you can add `--no-verify` to your commit command.
Installing pre-commit hooks:
```bash
# Ensure that all dependencies are installed
poetry install --sync --with dev-linting,dev-testing,dev-docs
# Initialize pre-commit for the repository
poetry run pre-commit install
# Run pre-commit check on all files
poetry run pre-commit run --all-files
```
<!-- :auto developer-tools: -->
<!-- :auto contributing: -->
## Contributing
- We follow the general guidelines outlined in the
[JATIC Design Principles](https://cdao.pages.jatic.net/public/program/design-principles/).
- We use the Git Flow branching strategy.
- See [docs/release_process.rst](./docs/release_process.rst) for detailed release information.
- See [CONTRIBUTING.md](./CONTRIBUTING.md) for additional contributing information.
<!-- :auto contributing: -->
<!-- :auto license: -->
## License
[Apache 2.0](./LICENSE)
<!-- :auto license: -->
<!-- :auto contacts: -->
## Contacts
**Principal Investigator**: Brian Hu (Kitware) @brian.hu
**Product Owner**: Austin Whitesell (MITRE) @awhitesell
**Scrum Master / Tech Lead**: Brandon RichardWebster (Kitware) @b.richardwebster
**Deputy Tech Lead**: Emily Veenhuis (Kitware) @emily.veenhuis
<!-- :auto contacts: -->
Raw data
{
"_id": null,
"home_page": null,
"name": "nrtk",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": null,
"author": "Kitware, Inc.",
"author_email": "nrtk@kitware.com",
"download_url": "https://files.pythonhosted.org/packages/be/fb/80a2d800084e9419b29f2b9af321e9434030661fd7c58eae849c2b3dd347/nrtk-0.16.0.tar.gz",
"platform": null,
"description": "# Natural Robustness Toolkit (NRTK)\n\nThe `nrtk` package is an open source toolkit for evaluating the natural robustness of computer vision\nalgorithms to various perturbations, including sensor-specific changes to camera focal length, aperture\ndiameter, etc. Functionality is provided through [Strategy](https://en.wikipedia.org/wiki/Strategy_pattern)\nand [Adapter](https://en.wikipedia.org/wiki/Adapter_pattern) patterns to allow for modular integration\ninto systems and applications.\n\nWe have also created the [`nrtk-jatic`](https://github.com/Kitware/nrtk-jatic) package to support AI T&E\nuse-cases and workflows, through interoperability with the [`maite`](https://github.com/mit-ll-ai-technology/maite)\nlibrary and integration with other [JATIC](https://cdao.pages.jatic.net/public/) tools. Users seeking to use NRTK to\nperturb MAITE-wrapped datasets or evaluate MAITE-wrapped models should\nstart with the `nrtk-jatic` package.\n\n<!-- :auto installation: -->\n## Installation\nThe following steps assume the source tree has been acquired locally.\n\nInstall the current version via pip:\n```bash\npip install nrtk\n```\n\nAlternatively, you can also use [Poetry](https://python-poetry.org/):\n```bash\npoetry install --sync --with dev-linting,dev-testing,dev-docs\n```\n\nSee [here for more installation documentation](\nhttps://nrtk.readthedocs.io/en/latest/installation.html).\n<!-- :auto installation: -->\n\n<!-- :auto getting-started: -->\n## Getting Started\nWe provide a number of examples based on Jupyter notebooks in the\n`./examples/` directory to show usage of the `nrtk` package in a number\nof different contexts.\n\nContributions are welcome!\nSee the [CONTRIBUTING.md](./CONTRIBUTING.md) file for details.\n<!-- :auto getting-started: -->\n\n<!-- :auto documentation: -->\n## Documentation\nDocumentation snapshots for releases as well as the latest master are hosted\non [ReadTheDocs](https://nrtk.readthedocs.io/en/latest/).\n\nThe sphinx-based documentation may also be built locally for the most\nup-to-date reference:\n```bash\n# Install dependencies\npoetry install --sync --with dev-linting,dev-testing,dev-docs\n# Navigate to the documentation root.\ncd docs\n# Build the docs.\npoetry run make html\n# Open in your favorite browser!\nfirefox _build/html/index.html\n```\n<!-- :auto documentation: -->\n\n<!-- :auto developer-tools: -->\n## Developer tools\n\n**pre-commit hooks**\npre-commit hooks are used to ensure that any code meets all linting and\nformatting guidelines required. After installing, this will always run before\n committing to ensure that any commits are following the standards, but you\n can also manually run the check without committing. If you want to commit\n despite there being errors, you can add `--no-verify` to your commit command.\n\nInstalling pre-commit hooks:\n```bash\n# Ensure that all dependencies are installed\npoetry install --sync --with dev-linting,dev-testing,dev-docs\n# Initialize pre-commit for the repository\npoetry run pre-commit install\n# Run pre-commit check on all files\npoetry run pre-commit run --all-files\n```\n<!-- :auto developer-tools: -->\n\n<!-- :auto contributing: -->\n## Contributing\n- We follow the general guidelines outlined in the\n[JATIC Design Principles](https://cdao.pages.jatic.net/public/program/design-principles/).\n- We use the Git Flow branching strategy.\n- See [docs/release_process.rst](./docs/release_process.rst) for detailed release information.\n- See [CONTRIBUTING.md](./CONTRIBUTING.md) for additional contributing information.\n<!-- :auto contributing: -->\n\n<!-- :auto license: -->\n## License\n[Apache 2.0](./LICENSE)\n<!-- :auto license: -->\n\n<!-- :auto contacts: -->\n## Contacts\n\n**Principal Investigator**: Brian Hu (Kitware) @brian.hu\n\n**Product Owner**: Austin Whitesell (MITRE) @awhitesell\n\n**Scrum Master / Tech Lead**: Brandon RichardWebster (Kitware) @b.richardwebster\n\n**Deputy Tech Lead**: Emily Veenhuis (Kitware) @emily.veenhuis\n\n<!-- :auto contacts: -->\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "An open source toolkit for evaluating the natural robustness of computer vision algorithms.",
"version": "0.16.0",
"project_urls": {
"Documentation": "https://nrtk.readthedocs.io/"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a77c655addb5552efc6fc4afb4bf454f3dd127b6cbaba1f0da845899f7f33e90",
"md5": "42228726b096ddbe22675fed772d3dec",
"sha256": "451e842a995748a177a07ecefc5dfa4079a5cf0f17e222a03726d914ef72a8a5"
},
"downloads": -1,
"filename": "nrtk-0.16.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "42228726b096ddbe22675fed772d3dec",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 57460,
"upload_time": "2024-11-19T23:18:43",
"upload_time_iso_8601": "2024-11-19T23:18:43.877421Z",
"url": "https://files.pythonhosted.org/packages/a7/7c/655addb5552efc6fc4afb4bf454f3dd127b6cbaba1f0da845899f7f33e90/nrtk-0.16.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "befb80a2d800084e9419b29f2b9af321e9434030661fd7c58eae849c2b3dd347",
"md5": "d4a0a742b12d883b28afb450b8d9fb26",
"sha256": "e566561c57e9d0dd378a721785d30070164ae9f374e428d09b532ab5a71e5c31"
},
"downloads": -1,
"filename": "nrtk-0.16.0.tar.gz",
"has_sig": false,
"md5_digest": "d4a0a742b12d883b28afb450b8d9fb26",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 35094,
"upload_time": "2024-11-19T23:18:45",
"upload_time_iso_8601": "2024-11-19T23:18:45.792278Z",
"url": "https://files.pythonhosted.org/packages/be/fb/80a2d800084e9419b29f2b9af321e9434030661fd7c58eae849c2b3dd347/nrtk-0.16.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-19 23:18:45",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "nrtk"
}
