Metadata-Version: 2.3
Name: nrtk-explorer
Version: 0.0.6
Summary: Model Visualizer
Author-email: Alessandro Genova <alessandro.genova@kitware.com>, Vicente Adolfo Bolea Sanchez <vicente.bolea@kitware.com>
License-File: LICENSE
Keywords: Application,Framework,Interactive,Python,Web
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: License :: Other/Proprietary License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: JavaScript
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: accelerate
Requires-Dist: nrtk
Requires-Dist: numpy
Requires-Dist: pillow
Requires-Dist: scikit-learn==1.4.1.post1
Requires-Dist: smqtk-classifier==0.19.0
Requires-Dist: smqtk-core==0.19.0
Requires-Dist: smqtk-dataprovider==0.18.0
Requires-Dist: smqtk-descriptors==0.19.0
Requires-Dist: smqtk-detection[centernet,torch]==0.20.1
Requires-Dist: smqtk-image-io==0.17.1
Requires-Dist: tabulate
Requires-Dist: timm
Requires-Dist: torch
Requires-Dist: torchvision
Requires-Dist: trame
Requires-Dist: trame-client>=2.15.0
Requires-Dist: trame-quasar
Requires-Dist: trame-server>=2.15.0
Requires-Dist: transformers
Requires-Dist: ubelt==1.3.4
Requires-Dist: umap-learn
Provides-Extra: dev
Requires-Dist: black; extra == 'dev'
Requires-Dist: flake8; extra == 'dev'
Requires-Dist: mypy; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: tabulate; extra == 'dev'
Provides-Extra: package
Requires-Dist: build<0.10.0; extra == 'package'
Requires-Dist: python-semantic-release; extra == 'package'
Requires-Dist: setuptools; extra == 'package'
Requires-Dist: wheel; extra == 'package'
Description-Content-Type: text/markdown

NRTK EXPLORER
=============

NRTK Explorer is a web application for exploring image datasets. It provides
insights of a image dataset in [COCO][3] format and it evaluate image
transformation and perturbation resilience of object recognition DL models. It
is built using [trame][1] by the [kitware][2] team.

![nrtk explorer](https://github.com/Kitware/nrtk-explorer/blob/d3df0ecf748664d806f09ad11e2bbd71a0bca1dd/screenshot.png?raw=true)

Features
--------

- Explore image datasets in COCO format.
- Apply parametrized image degradation (such as blur) to the images.
- Benchmark dataset resilience with a differential PCA|UMAP analysis of the
  embeddings of the images and its transformation.
- Evaluate object detection DL models in both the source images and its
  transformations.
- When possible it will attempt to utilize the user GPU as much as possible to
  speedup its computations.

Installing
----------

Install it from pypi:

```bash
pip install nrtk_explorer
```

Or, download and install it manually with:

```bash
curl -OL https://github.com/Kitware/nrtk-explorer/archive/refs/heads/main.zip
```

Inside the application source code top directory, install it with:

```
pip install -e .
```

Run the application:

```
nrtk_explorer
```

CLI flags and options
---------------------

- `-h|--help` show the help for the command line options, it inherit trame
  command line options and flags.
- `--dataset` specify the directory containing a json file describing a COCO
  image dataset. You can specify multiple directory using a comma `,` as a
  separator.

Contribute to NRTK_EXPLORER
---------------------------

Run tests with:

```bash
pytest
```

[1]: https://trame.readthedocs.io/en/latest/
[2]: https://www.kitware.com/
[3]: https://cocodataset.org/
