README.md

---
title: ArchEGraph Visualizer
colorFrom: blue
colorTo: green
sdk: gradio
app_file: app.py
pinned: false
---

# ArchEGraph Visualizer

This Space visualizes sample files from:

- https://huggingface.co/datasets/ArchEGraph/ArchEGraph-demo

The UI flow is:

- Select weather city first
- Select a matched building id for that city
- Optionally enable a custom time window for weather and energy curves

For the selected weather/building pair, the app fetches:

- `geometry/<building_id>.npz`
- `building/<building_id>.npz`
- `weather/<weather_id>.npz`
- `energy/<energy_file from manifest.csv>`

The energy file can live under nested subfolders such as `energy/00/00017__Anchorage.npz`.

Then it renders five views:

- Geometry polygons
- Building graph
- Graph/geometry overlap
- Weather curves (selected time window)
- Energy curves (selected time window)

## API

The Gradio API endpoint is exposed as:

- `/gradio_api/call/render_sample`

Input data format:

```json
{
  "weather_id": "Anchorage",
  "building_id": "17",
  "max_energy_zones": 6,
  "use_custom_window": false,
  "window_start_hour": 1,
  "window_hours": 24
}
```

See `agents.md` for curl examples.