Gee Ntl Date Boundary Handling

Execution Checklist

1. Confirm event local time and timezone.
2. Determine first-night date using overpass rule.
3. Build period windows:
   • baseline: event-14d to event-7d
   • first-night: D+1 (or short fallback window D+1..D+3)
   • recovery: event+7d to event+14d
4. Use inclusive-end helper for all date windows.
5. Use validated AOI (admin boundary / confirmed geometry).
6. Run reductions with explicit safety parameters.
7. Return structured logs for image counts and no-data periods.

Reusable Snippets

1) Inclusive date helper

from datetime import datetime, timedelta

def to_exclusive_end(date_str: str) -> str:
    return (datetime.strptime(date_str, "%Y-%m-%d") + timedelta(days=1)).strftime("%Y-%m-%d")

# Example: single day 2025-03-29
# filterDate("2025-03-29", to_exclusive_end("2025-03-29"))

2) Timezone-aware first-night calculation

from datetime import datetime, timedelta