semvec/pypi-packages huggingface dataset:
dataformatter 0.2.12a0
Data formatter.
License: Apache-2.0
Requires Python: >=3.7,<4.0

# Dataset Formator

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)

Unity Dataset formator is a python package for transforming data from one format to another.

### Convert Datasets

If you are interested in converting the synthetic dataset to COCO format for
annotations that COCO supports, you can run the `convert` command:

```bash
dataformatter convert -i <input-directory> -o <output-directory> -f COCO-Instances
```
or
```bash
dataformatter convert -i <input-directory> -o <output-directory> -f COCO-Keypoints
```

Alternatively, you can transform dataset directly from python interface.

```python
   from dataformatter.datasets.transformers import get_dataset_transformer
   transformer = get_dataset_transformer(format="COCO-Instances", data_root="source_path")
   transformer.execute(output="local_path")
```
or
```python
   from dataformatter.datasets.transformers import get_dataset_transformer
   transformer = get_dataset_transformer(format="COCO-Keypoints", data_root="source_path")
   transformer.execute(output="local_path")
```

You will need to provide 2D bounding box definition ID in the synthetic dataset. We currently only support 2D bounding box and human keypoint annotations for COCO format.

## 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.