Metadata-Version: 2.4
Name: geo2scene
Version: 0.1.0.dev0
Summary: Turn real-world geographic data into reusable, simulator-ready scenes.
Project-URL: Homepage, https://github.com/AutonomyOps/geo2scene
Project-URL: Repository, https://github.com/AutonomyOps/geo2scene
Project-URL: Issues, https://github.com/AutonomyOps/geo2scene/issues
Author: Geo2Scene contributors
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: digital-twin,gazebo,geospatial,gis,robotics,simulation
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: GIS
Requires-Python: >=3.11
Provides-Extra: dev
Requires-Dist: mypy>=1.11; extra == 'dev'
Requires-Dist: pytest-cov>=5; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.6; extra == 'dev'
Provides-Extra: gazebo
Provides-Extra: osm
Provides-Extra: terrain
Provides-Extra: web
Description-Content-Type: text/markdown

# Geo2Scene

**Geo2Scene brings real-world geographic environments into simulation.**

An open-source, Python-first SDK and CLI that transforms real-world geospatial
data (lat/lon, center + radius, bounding box, GeoJSON polygons, or local
datasets) into reusable, **simulator-neutral** scenes — with **Gazebo** as the
first production-quality exporter and a stable internal scene model that keeps
the core free of simulator lock-in.

> *Terraform for simulation environments generated from real-world geographic data.*

## Status

Pre-alpha (`0.1.0.dev0`). The engineering backlog is tracked in
[GitHub issues](https://github.com/AutonomyOps/geo2scene/issues) and organized
into milestones M0–M10.

## Install (development)

```bash
git clone https://github.com/AutonomyOps/geo2scene.git
cd geo2scene
python -m pip install -e ".[dev]"
geo2scene version
```

## How it works

See **[ARCHITECTURE.md](ARCHITECTURE.md)** — the system, design principles, and
the provider → scene → exporter lifecycle.

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for developer setup and pull-request
guidelines.

## License

[Apache-2.0](LICENSE). Note: the code license does **not** govern upstream data
licenses (e.g. OpenStreetMap / ODbL) — you are responsible for complying with
each data source's terms.
