maszyna/pr-reviews/PR-227.md

Review PR #227 — simulationenvironment: Adjust turbidity values

Autor: @dos1 · base: master · 1 plik, +6/−6 https://github.com/MaSzyna-EU07/maszyna/pull/227

Werdykt: Approve po uzupełnieniu opisu

Podsumowanie

Zmiana mapowania zachmurzenia (Global.Overcast) na mętność atmosfery (fTurbidity): minimum 3 → 4 (bo 3 psuje model w nocy) i wyższe wartości w środkowym/wysokim zakresie.

Uwagi

1. Pierwsze dwa progi są teraz identyczne (<= 0.10 ? 4 i <= 0.20 ? 4), podobnie 0.30/0.40 → 5, 0.50/0.60 → 6 i 0.90/else → 9. Drabinka 10 zagnieżdżonych ?: z powtórzonymi wartościami to dobry moment, żeby ją uprościć — np. tablica std::array progów albo krótka funkcja. Przy okazji zniknie zgłoszenie Sonara S3358 (zagnieżdżony operator ?:), które i tak dotyczy zmienianych linii.
2. „Turbidity 3 breaks the model at night” — warto w opisie dodać 1–2 zdania, jak się psuje (NaN? czarne/świecące niebo?) i ewentualnie zrzut ekranu. Jeśli problem jest w samym modelu Preetham (znane ograniczenie dla T < ~2–3 przy słońcu pod horyzontem), lepszym miejscem na poprawkę może być clamp w modelu nieba, a nie w mapowaniu pogody — wtedy wartość 3 zostałaby dostępna w dzień.
3. Zmiana wyglądu istniejących scenerii — przy bezchmurnej pogodzie niebo będzie bardziej mgliste niż dotąd. To uzasadniona poprawka, ale wg CLAUDE.md należy to wprost opisać w PR (najlepiej porównanie przed/po dla 0.0, 0.5 i 0.9 overcast, dzień i noc).
4. Do przetestowania razem z #228 (sRGB) i #230 (rozmiar Słońca/Księżyca) — wszystkie trzy zmieniają odbiór nieba.