| from __future__ import annotations |
|
|
| from .evidence import make_evidence |
| from .models import EvidenceItem |
|
|
|
|
| def summarize_sun_wind(lat: float, lon: float, wind_direction_deg: float | None = None) -> tuple[dict[str, str], list[EvidenceItem]]: |
| hemisphere = "northern" if lat >= 0 else "southern" |
| sun_side = "southern" if lat >= 0 else "northern" |
| wind_text = _wind_text(wind_direction_deg) |
| summary = { |
| "hemisphere": hemisphere, |
| "sun_side": sun_side, |
| "orientation_note": ( |
| f"At this latitude in the {hemisphere} hemisphere, the sun is generally biased toward the {sun_side} side of the sky across much of the year." |
| ), |
| "east_west_note": "Morning exposure is generally from the east; afternoon heat/glare risk is generally stronger from the west.", |
| "wind_note": wind_text, |
| "limitation": "This is a deterministic orientation summary and does not model shadows from surrounding buildings or terrain.", |
| } |
| evidence = [ |
| make_evidence( |
| category="Sun/wind", |
| finding="A deterministic sun/orientation summary was computed from latitude and longitude.", |
| source_name="Local solar/orientation calculation", |
| source_url="", |
| source_type="computed", |
| resolution_or_scope="anchor coordinate", |
| confidence="medium", |
| limitation="Does not model site obstructions, surrounding-building shadows, or microclimate.", |
| design_implication="Use for early massing, shading, and facade-orientation thinking.", |
| verification_needed="Observe actual shade, adjacent heights, glare, and wind during site visit.", |
| output_label="computed", |
| ) |
| ] |
| return summary, evidence |
|
|
|
|
| def _wind_text(direction: float | None) -> str: |
| if direction is None: |
| return "Wind direction was not available from climate data." |
| return f"Available climate data suggests dominant wind around {round(direction)} degrees ({_bearing_label(direction)}). Treat this as regional/modelled." |
|
|
|
|
| def _bearing_label(deg: float) -> str: |
| labels = ["N", "NE", "E", "SE", "S", "SW", "W", "NW"] |
| return labels[int((deg + 22.5) // 45) % 8] |
|
|
