Metadata-Version: 2.1
Name: datasetinsights
Version: 0.2.1
Summary: Synthetic dataset insights.
License: Apache-2.0
Author: Unity AI Perception Team
Author-email: perception@unity3d.com
Requires-Python: >=3.7,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Framework :: Jupyter
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Dist: click (>=7.1.2,<8.0.0)
Requires-Dist: codetiming (>=1.2.0,<2.0.0)
Requires-Dist: cython (>=0.29.14,<0.30.0)
Requires-Dist: dash (==1.12.0)
Requires-Dist: dask[complete] (>=2.14.0,<3.0.0)
Requires-Dist: google-cloud-storage (>=1.24.1,<=1.28.1)
Requires-Dist: jupyter (>=1.0.0,<2.0.0)
Requires-Dist: kornia (>=0.1.4,<0.2.0)
Requires-Dist: numpy (>=1.17,<1.18)
Requires-Dist: nuscenes-devkit (>=1.0.2,<1.0.3)
Requires-Dist: pandas (>=1.0.1,<2.0.0)
Requires-Dist: plotly (>=4.4.1,<5.0.0)
Requires-Dist: pycocotools (>=2.0.0,<3.0.0)
Requires-Dist: pyquaternion (>=0.9.5,<0.10.0)
Requires-Dist: pytorch-ignite (>=0.3.0,<0.4.0)
Requires-Dist: tensorflow (>=2.2.0,<3.0.0)
Requires-Dist: torch (>=1.4.0,<1.5.0)
Requires-Dist: torchvision (>=0.5,<0.6)
Requires-Dist: tqdm (>=4.45.0,<5.0.0)
Requires-Dist: yacs (>=0.1.6,<0.2.0)
Description-Content-Type: text/markdown

# Dataset Insights

Unity Dataset Insights is a python package for understanding synthetic datasets.
This package enables users to analyze synthetic datasets generated using the [Perception SDK](https://github.com/Unity-Technologies/com.unity.perception).

## Installation

Dataset Insights maintains a pip package for easy installation. It can work in any standard Python environment using `pip install datasetinsights` command. We support Python 3 (>= 3.7).

## Getting Started

### Dataset Statistics

We provide a sample [notebook](notebooks/SynthDet_Statistics.ipynb) to help you get started with dataset statistics for the [SynthDet](https://github.com/Unity-Technologies/SynthDet) project. We plan to support other sample Unity projects in the future.

### Dataset Evaluation

Dataset evaluation provides tools to train and evaluate ML models for different datasets. You can run `download`, `train` and `evaluate` commands:

[Download Dataset](https://datasetinsights.readthedocs.io/en/latest/datasetinsights.commands.html#datasetinsights-commands-download)

```bash
datasetinsights download \
  --source-uri=<xxx> \
  --output=$HOME/data
```

[Train](https://datasetinsights.readthedocs.io/en/latest/datasetinsights.commands.html#datasetinsights-commands-train)

```bash
datasetinsights train \
 --config=datasetinsights/configs/faster_rcnn.yaml \
 --train-data=$HOME/data
```

[Evaluate](https://datasetinsights.readthedocs.io/en/latest/datasetinsights.commands.html#datasetinsights-commands-evaluate)

```bash
datasetinsights evaluate \
 --config=datasetinsights/configs/faster_rcnn.yaml \
 --test-data=$HOME/data
```

To learn more, see this [tutorial](https://datasetinsights.readthedocs.io/en/latest/Evaluation_Tutorial.html).

## Docker

You can use the pre-build docker image [unitytechnologies/datasetinsights](https://hub.docker.com/r/unitytechnologies/datasetinsights) to run similar commands.

## Documentation

You can find the API documentation on [readthedocs](https://datasetinsights.readthedocs.io/en/latest/).

## Contributing

Please let us know if you encounter a bug by filing an issue. To learn more about making a contribution to Dataset Insights, please see our Contribution [page](CONTRIBUTING.md).

## License

Dataset Insights is licensed under the Apache License, Version 2.0. See [LICENSE](LICENCE) for the full license text.

## Citation
If you find this package useful, consider citing it using:
```
@misc{datasetinsights2020,
    title={Unity {D}ataset {I}nsights Package},
    author={{Unity Technologies}},
    howpublished={\url{https://github.com/Unity-Technologies/datasetinsights}},
    year={2020}
}
```

