library_sources/README.md

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.