Spaces:
Sleeping
Sleeping
File size: 1,545 Bytes
4595db8 333dd2f 4595db8 5ae5432 4595db8 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 | # Local Image Library
Place satellite / drone images here **by year**. The app reads directly from this folder — no web upload needed.
## Folder structure
```
library_sources/
2024/
your_image.tif
optional_subfolder/
another_image.tif
2025/
site_a.tif
2026/
```
## Supported formats
- `.tif` / `.tiff` (GeoTIFF — preferred)
- `.png`, `.jpg`, `.jpeg` (for testing)
## How to use
1. Copy your images into the correct **year** folder:
```
change_detection_webapp/library_sources/2025/your_image.tif
change_detection_webapp/library_sources/2026/other_image.tif
```
2. Start the app locally: `python run.py` (DDA mode is enabled automatically).
3. Open **Image Library** → click **Refresh**.
4. Select **2025** or **2026** in the sidebar to filter by year.
> **Hugging Face dev Space:** large `.tif` files are **not** uploaded via git. Run locally, or copy files into the Space persistent `data/library_sources/` folder.
## Troubleshooting
| Problem | Fix |
|---------|-----|
| Images not showing | Use `python run.py` locally; click **Refresh** |
| Wrong page (simple upload UI) | Set `APP_MODE=dda` on HF, or run locally |
| Filename has spaces | Supported (e.g. `Grid no. 54_ORI-005.tif`) |
| Check scan | Open `/api/dda/local/debug` in browser |
## Large files
GeoTIFF files up to **5 GB** are supported when read from disk. Copy files via Explorer/Finder — much faster than browser upload.
## Custom location
Set environment variable `LOCAL_LIBRARY_ROOT` to use a different folder path.
|