# DeepScenario Toolkit
A Python toolkit for visualizing and working with DeepScenario datasets, which can be downloaded at [app.deepscenario.com](https://app.deepscenario.com).
## Overview
DeepScenario provides a platform to virtualize real-world recordings into:
- a **3D reconstruction** of the static environment
- **3D trajectories** of the dynamic objects
This toolkit provides easy-to-use tools for visualizing and working with DeepScenario datasets, including:
- visualization of the object annotations in 3D or in OpenStreetMap
- creation of an orthophoto from the 3D reconstruction
## Installation
### From PyPI (Recommended)
```bash
pip install dsc-toolkit
```
### From Source (Development)
This project uses [uv](https://github.com/astral-sh/uv) for dependency management. Make sure you have `uv` installed first.
```bash
# Clone the repository
git clone https://github.com/deepscenario/dsc-toolkit.git
cd dsc-toolkit
# Install the package and dependencies
uv sync
```
## Quick Start
The toolkit provides a command-line tool with several commands. Each command has detailed help available using the `--help` option, for example:
```bash
dsc-toolkit plot_annotations_3d --help
```
### `plot_annotations_3d`
Interactive 3D visualization of the object annotations:
```bash
dsc-toolkit plot_annotations_3d \
--data_dir tests/assets/data \
--recording 2000-12-31T23-59-59 \
--mesh tests/assets/data/textured_mesh/textured_mesh.obj
```
### `plot_annotations_georeferenced`
Interactive visualization of the object annotations in OpenStreetMap:
```bash
dsc-toolkit plot_annotations_georeferenced \
--data_dir tests/assets/data \
--recording 2000-12-31T23-59-59 \
--save_dir /tmp/output
```
### `render_orthophoto`
Render a georeferenced orthophoto from the textured mesh:
```bash
dsc-toolkit render_orthophoto \
--data_dir tests/assets/data \
--mesh tests/assets/data/textured_mesh/textured_mesh.obj \
--save_dir /tmp/output
```
## License
This project is licensed under the Apache License 2.0. See [LICENSE.txt](LICENSE.txt) for details.
## Support
For questions, issues, or contributions, please:
- open an [issue in this repository](https://github.com/deepscenario/dsc-toolkit/issues)
- contact DeepScenario at info@deepscenario.com
Raw data
{
"_id": null,
"home_page": null,
"name": "dsc-toolkit",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "3d, autonomous-driving, computer-vision, deepscenario, traffic, visualization",
"author": null,
"author_email": "DeepScenario <info@deepscenario.com>",
"download_url": "https://files.pythonhosted.org/packages/0f/a7/908962aa476c6dfce9045eac29f0f7700e1b623ade3722c2427c4cec4f37/dsc_toolkit-1.0.1.tar.gz",
"platform": null,
"description": "# DeepScenario Toolkit\n\nA Python toolkit for visualizing and working with DeepScenario datasets, which can be downloaded at [app.deepscenario.com](https://app.deepscenario.com).\n\n## Overview\n\nDeepScenario provides a platform to virtualize real-world recordings into:\n- a **3D reconstruction** of the static environment\n- **3D trajectories** of the dynamic objects\n\nThis toolkit provides easy-to-use tools for visualizing and working with DeepScenario datasets, including:\n- visualization of the object annotations in 3D or in OpenStreetMap\n- creation of an orthophoto from the 3D reconstruction\n\n## Installation\n\n### From PyPI (Recommended)\n\n```bash\npip install dsc-toolkit\n```\n\n### From Source (Development)\n\nThis project uses [uv](https://github.com/astral-sh/uv) for dependency management. Make sure you have `uv` installed first.\n\n```bash\n# Clone the repository\ngit clone https://github.com/deepscenario/dsc-toolkit.git\ncd dsc-toolkit\n\n# Install the package and dependencies\nuv sync\n```\n\n## Quick Start\n\nThe toolkit provides a command-line tool with several commands. Each command has detailed help available using the `--help` option, for example:\n\n```bash\ndsc-toolkit plot_annotations_3d --help\n```\n\n### `plot_annotations_3d`\n\nInteractive 3D visualization of the object annotations:\n\n```bash\ndsc-toolkit plot_annotations_3d \\\n\t--data_dir tests/assets/data \\\n\t--recording 2000-12-31T23-59-59 \\\n\t--mesh tests/assets/data/textured_mesh/textured_mesh.obj\n```\n\n### `plot_annotations_georeferenced`\n\nInteractive visualization of the object annotations in OpenStreetMap:\n\n```bash\ndsc-toolkit plot_annotations_georeferenced \\\n\t--data_dir tests/assets/data \\\n\t--recording 2000-12-31T23-59-59 \\\n\t--save_dir /tmp/output\n```\n\n### `render_orthophoto`\n\nRender a georeferenced orthophoto from the textured mesh:\n\n```bash\ndsc-toolkit render_orthophoto \\\n\t--data_dir tests/assets/data \\\n\t--mesh tests/assets/data/textured_mesh/textured_mesh.obj \\\n\t--save_dir /tmp/output\n```\n\n## License\n\nThis project is licensed under the Apache License 2.0. See [LICENSE.txt](LICENSE.txt) for details.\n\n## Support\n\nFor questions, issues, or contributions, please:\n- open an [issue in this repository](https://github.com/deepscenario/dsc-toolkit/issues)\n- contact DeepScenario at info@deepscenario.com\n",
"bugtrack_url": null,
"license": null,
"summary": "DeepScenario Toolkit for visualizing and working with DeepScenario datasets",
"version": "1.0.1",
"project_urls": {
"Bug Tracker": "https://github.com/deepscenario/dsc-toolkit/issues",
"Documentation": "https://github.com/deepscenario/dsc-toolkit#readme",
"Homepage": "https://app.deepscenario.com",
"Repository": "https://github.com/deepscenario/dsc-toolkit"
},
"split_keywords": [
"3d",
" autonomous-driving",
" computer-vision",
" deepscenario",
" traffic",
" visualization"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "07b0c61069e257e3dc4a6b024f7ed2afbf385afe7ae1bbf5e295e39029d12356",
"md5": "e61f17300d9fa50c86acc0abbe6da9bd",
"sha256": "f65129eb05d87a9fe8059a2aabd6a20144633800186055a0b6054312c1cb5e80"
},
"downloads": -1,
"filename": "dsc_toolkit-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e61f17300d9fa50c86acc0abbe6da9bd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 17974,
"upload_time": "2025-08-22T08:17:52",
"upload_time_iso_8601": "2025-08-22T08:17:52.094493Z",
"url": "https://files.pythonhosted.org/packages/07/b0/c61069e257e3dc4a6b024f7ed2afbf385afe7ae1bbf5e295e39029d12356/dsc_toolkit-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "0fa7908962aa476c6dfce9045eac29f0f7700e1b623ade3722c2427c4cec4f37",
"md5": "1e6017fa3c3cf40fe91627a598cad690",
"sha256": "ef5911ed472bba137990dca1a95cbb8e1dff321ab022011cfb654fb647ce18d0"
},
"downloads": -1,
"filename": "dsc_toolkit-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "1e6017fa3c3cf40fe91627a598cad690",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 320262,
"upload_time": "2025-08-22T08:17:53",
"upload_time_iso_8601": "2025-08-22T08:17:53.603332Z",
"url": "https://files.pythonhosted.org/packages/0f/a7/908962aa476c6dfce9045eac29f0f7700e1b623ade3722c2427c4cec4f37/dsc_toolkit-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-22 08:17:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "deepscenario",
"github_project": "dsc-toolkit",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "dsc-toolkit"
}
JSON
