visionsim 0.1.0a1__tar.gz

visionsim-0.1.0a1/.github/workflows/integration_tests.yml

@@ -0,0 +1,48 @@
+name: CLI Installation
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        # python-version: ["3.8", "3.9", "3.10", "3.11"]
+        python-version: ["3.10"]
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Lint with ruff
+        run: |
+          python -m pip install --upgrade pip
+          pip install ruff
+          ruff check --extend-select I tasks.py visionsim/ tests/
+      - name: Install VisionSim and dependencies
+        run: |
+          pip install .[dev]
+      ## Note: No test currently requires blender/ffmpeg
+      #- name: Install FFmpeg
+      #  run: |
+      #    sudo snap install ffmpeg
+      #    ffmpeg -version
+      #- name: Install Blender
+      #  run: |
+      #    sudo snap install blender --classic --channel=3.3lts/stable
+      #    echo -n "BLENDER_PY=$(blender --background --python-expr 'import sys; print(sys.executable, file=sys.stderr)' 2>&1 >/dev/null)" >> $GITHUB_ENV
+      #    blender --version
+      #- name: Install Blender dependencies
+      #  run: |
+      #    echo "Found blender python interpreter at $BLENDER_PY"
+      #    $BLENDER_PY -m ensurepip
+      #    $BLENDER_PY -m pip install scipy rich
+      - name: Build Docs
+        run : |
+          inv build-docs
+      - name: Run Tests
+        run: |
+          pytest --durations=0

visionsim-0.1.0a1/.gitignore

@@ -0,0 +1,121 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# dotenv
+.env
+
+# virtualenv
+.venv
+venv/
+ENV/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+# IDE settings
+.vscode/
+.idea/
+
+# Custom
+paper/
+out/
+TODO.md
+*.pkl
+*.DS_store
+scenes/
+data/
+cache/
+examples/logs/
+examples/renders/
+examples/*.blend*
+docs/source/apidocs/
+docs/source/clidocs/

visionsim-0.1.0a1/.pre-commit-config.yaml

@@ -0,0 +1,27 @@
+fail_fast: false
+repos:
+- repo: local
+  hooks:
+  - id: inv-lint
+    name: Lint (with Ruff)
+    entry: invoke lint
+    pass_filenames: False
+    language: system
+
+  - id: inv-tests
+    name: Run Tests
+    entry: invoke test
+    pass_filenames: False
+    language: system
+
+  - id: inv-clean
+    name: Clean Caches
+    entry: invoke clean
+    pass_filenames: False
+    language: system
+
+  - id: inv-docs
+    name: Build Docs
+    entry: invoke build-docs
+    pass_filenames: False
+    language: system

visionsim-0.1.0a1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 WISION Lab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

visionsim-0.1.0a1/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: visionsim
+Version: 0.1.0a1
+Summary: Towards a Sensor-Realistic World Simulator
+Project-URL: GitHub, https://github.com/WISION-Lab/visionsim
+License-Expression: MIT
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.9
+Requires-Dist: imageio
+Requires-Dist: invoke
+Requires-Dist: jsonschema
+Requires-Dist: matplotlib
+Requires-Dist: more-itertools
+Requires-Dist: multiprocess
+Requires-Dist: natsort
+Requires-Dist: numpy
+Requires-Dist: opencv-python
+Requires-Dist: openexr
+Requires-Dist: rich
+Requires-Dist: rpyc
+Requires-Dist: scipy
+Requires-Dist: tdigest
+Requires-Dist: torch
+Requires-Dist: torchvision
+Requires-Dist: tqdm
+Requires-Dist: tyro
+Provides-Extra: dev
+Requires-Dist: click-extra[pygments,sphinx]; extra == 'dev'
+Requires-Dist: coverage; extra == 'dev'
+Requires-Dist: furo; extra == 'dev'
+Requires-Dist: hypothesis; extra == 'dev'
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: scipy-stubs; (python_version >= '3.10') and extra == 'dev'
+Requires-Dist: sphinx; extra == 'dev'
+Requires-Dist: sphinx-copybutton; extra == 'dev'
+Requires-Dist: sphinxcontrib-napoleon; extra == 'dev'
+Requires-Dist: sphinxcontrib-programoutput>=0.18; extra == 'dev'
+Requires-Dist: sphinxcontrib-video; extra == 'dev'
+Requires-Dist: types-jsonschema; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# VisionSIM: Towards a Sensor-Realistic World Simulator
+
+A modular and extensible framework that realistically emulates many different sensor types, alongside rich pixel-perfect ground truth annotations across low-, mid-, and high-level scene characteristics, as well as intrinsic and extrinsic camera properties.
+
+*Warning:* This project is under heavy development and still considered unstable. 
+
+## Installation & Dependencies 
+
+You'll need:
+
+- [Blender](https://www.blender.org/download/) >= 3.3.1, to render new views. 
+- [ffmpeg](https://ffmpeg.org/download.html), for visualizations. 
+- python dependencies listed in `requirements.txt`. 
+- install `visionsim` locally using `pip install .` or using `pip install -e ".[dev]"` if developing.
+
+Make sure Blender and ffmpeg are on your PATH.
+The first time you use the renderer, it may ask you to install additional packages into blender's runtime. 
+
+## Building the Documentation
+
+In the project root, with visionsim installed with the dev dependencies, run:
+```
+inv clean build-docs --preview
+```

visionsim-0.1.0a1/README.md

@@ -0,0 +1,24 @@
+# VisionSIM: Towards a Sensor-Realistic World Simulator
+
+A modular and extensible framework that realistically emulates many different sensor types, alongside rich pixel-perfect ground truth annotations across low-, mid-, and high-level scene characteristics, as well as intrinsic and extrinsic camera properties.
+
+*Warning:* This project is under heavy development and still considered unstable. 
+
+## Installation & Dependencies 
+
+You'll need:
+
+- [Blender](https://www.blender.org/download/) >= 3.3.1, to render new views. 
+- [ffmpeg](https://ffmpeg.org/download.html), for visualizations. 
+- python dependencies listed in `requirements.txt`. 
+- install `visionsim` locally using `pip install .` or using `pip install -e ".[dev]"` if developing.
+
+Make sure Blender and ffmpeg are on your PATH.
+The first time you use the renderer, it may ask you to install additional packages into blender's runtime. 
+
+## Building the Documentation
+
+In the project root, with visionsim installed with the dev dependencies, run:
+```
+inv clean build-docs --preview
+```

visionsim-0.1.0a1/docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = source
+BUILDDIR      = build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

visionsim-0.1.0a1/docs/make.bat

@@ -0,0 +1,35 @@
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=sphinx-build
+)
+set SOURCEDIR=source
+set BUILDDIR=build
+
+%SPHINXBUILD% >NUL 2>NUL
+if errorlevel 9009 (
+	echo.
+	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
+	echo.installed, then set the SPHINXBUILD environment variable to point
+	echo.to the full path of the 'sphinx-build' executable. Alternatively you
+	echo.may add the Sphinx directory to PATH.
+	echo.
+	echo.If you don't have Sphinx installed, grab it from
+	echo.https://www.sphinx-doc.org/
+	exit /b 1
+)
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+
+:end
+popd

visionsim-0.1.0a1/docs/source/_static/css/custom.css

@@ -0,0 +1,19 @@
+table.borderless,
+table.borderless td,
+table.borderless th {
+    border: 0px solid transparent;
+    padding: 0px;
+    padding-right: 0.5em;
+    box-shadow: none
+}
+
+/* For ANSI Colors, assume green is new diff so add underline, strikethrough for red */
+.-C-Green {
+    color: #00A000 !important; 
+    text-decoration: underline;
+}
+
+.-C-Red {
+    color: #A40000 !important;
+    text-decoration: line-through;
+}