Metadata-Version: 2.4
Name: facadescapy
Version: 0.1.0a0
Summary: Tools for street-level facade imagery, rectification, annotation data, and facade-analysis workflows.
Author: Anthony Suppa
License: BSD-3-Clause
Keywords: facades,street-level-imagery,mapillary,rectification,annotation,window-to-wall-ratio
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Scientific/Engineering :: Image Processing
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.24
Requires-Dist: opencv-python>=4.8
Requires-Dist: pandas>=2.0
Requires-Dist: pyproj>=3.6
Requires-Dist: requests>=2.31
Requires-Dist: shapely>=2.0
Provides-Extra: geo
Requires-Dist: duckdb>=0.10; extra == "geo"
Requires-Dist: fiona>=1.9; extra == "geo"
Requires-Dist: fsspec>=2024.0; extra == "geo"
Requires-Dist: geopandas>=0.14; extra == "geo"
Requires-Dist: osmnx>=2.0; extra == "geo"
Requires-Dist: pyarrow>=14.0; extra == "geo"
Requires-Dist: s3fs>=2024.0; extra == "geo"
Provides-Extra: annotation
Requires-Dist: fastapi>=0.110; extra == "annotation"
Requires-Dist: pydantic>=2.0; extra == "annotation"
Requires-Dist: python-multipart>=0.0.9; extra == "annotation"
Requires-Dist: uvicorn[standard]>=0.27; extra == "annotation"
Provides-Extra: training
Requires-Dist: ultralytics>=8.0; extra == "training"
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == "dev"
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: ruff>=0.5; extra == "dev"
Requires-Dist: twine>=5.0; extra == "dev"
Dynamic: license-file

﻿# facadescapy

`facadescapy` is an early-stage Python package for street-level facade imagery workflows: selecting and downloading Mapillary images, rectifying facade views, preparing facade geometry, and generating manifests.

This first alpha release is intentionally focused on stable, model-independent functionality. Deep learning inference and training integrations are kept out of the core dependency set while the model and licensing path is finalized.

## Planned first-release scope

- Mapillary metadata and image download helpers
- Equirectangular-to-perspective rectification for facade imagery
- Facade-oriented geometry utilities, including splitline preparation and street-facing segment helpers
- OSM and EUBUCCO geometry helpers behind optional geospatial dependencies
- Manifest read/write helpers for batch image preparation
- Thin CLI entry points for common batch workflows

## Installation

From a local checkout:

```bash
pip install -e .
```

With optional geospatial functionality:

```bash
pip install -e ".[geo]"
```

With annotation-server dependencies:

```bash
pip install -e ".[annotation]"
```

The `training` extra currently includes Ultralytics and is license-sensitive because Ultralytics YOLO is AGPL-3.0 by default unless a separate license applies.

## CLI

```bash
facadescapy --help
facadescapy build-manifest --help
facadescapy rectify --help
```

## License

BSD 3-Clause. See `LICENSE`.

## Notices

This project is not affiliated with Mapillary, Meta, OpenStreetMap, EUBUCCO, Ultralytics, or any facade product manufacturer. Users are responsible for complying with external data, imagery, model, and software licenses.
