# Cirkulace – TerraChronia 1.11.26 / TS-08

Offline klimatologický výukový model. Není to aktuální počasí, hydrodynamická simulace ani předpověď. Všechny dráhy jsou zjednodušené; skutečné proudy tvoří proměnlivé pásy, větve a víry. Animace vyjadřuje směr a relativní charakter, nikdy měřenou rychlost v m/s.

## Zdroje, licence a varianta

Odborné stránky ověřeny 9. 10. 2026. NOAA/NWS/NOS federální vzdělávací podklady jsou public domain; vlastní české texty a geometrická schémata nejsou oficiálním produktem ani schválením NOAA. Distribuované masky hlavních proudů byly již součástí projektu; žádná nová externí knihovna ani velký dataset se nepřidává.

| Obsah | Zdroj | Použití |
|---|---|---|
| Povrchové proudy | [NOAA/NWS JetStream Max: Major Ocean Currents](https://www.noaa.gov/jetstream/ocean/circulations/jetstream-max-major-ocean-currents) | 25 původních maskových obrázků `tools/data/current-labels/curr_*.png`, 840×420; převod os proudů do 44 větví / 1 556 bodů. Směr podle šipek původního schématu. Teplá/studená klasifikace převzata z původních metadat. |
| Buňky, větry, tlak | [NOAA/NWS Global Atmospheric Circulations](https://www.noaa.gov/jetstream/global/global-atmospheric-circulations) | Vlastní analytické výukové oblouky, pásy a uzavřené buňky; průměrné zeměpisné šířky, nikoli vzorky pozorovaných větrů. |
| Jet streamy | [NOAA/NWS Jet Streams](https://www.noaa.gov/jetstream/global/jet-stream) | Schematické zvlněné východní proudění kolem ±30° a ±60°. Zvlnění není konkrétní meteorologická situace. |
| ITCZ | [NOAA/NWS Convergence Zone](https://www.noaa.gov/jetstream/tropical/convergence-zone) | Průměrný rovníkový pás, bez sezónního posunu. |
| Hlubinná cirkulace | [NOAA/NOS Global Conveyor Belt](https://oceanservice.noaa.gov/education/tutorial_currents/05conveyor2.html) | Vlastní zjednodušené koridory podle popsaného propojení oceánů; **nejde o digitalizovaný měřený proudový dataset**. Samostatná hlubinná a návratová větev. |
| Vertikální voda | [NOAA/NOS Upwelling and Downwelling](https://oceanservice.noaa.gov/education/tutorial_currents/03coastal4.html) | 8 reprezentativních oblastí; poloha a hloubka jsou schematické. Kalifornský upwelling označen jako sezónní. |
| Podmínky NOAA | [NOAA FAQ: Using NOAA Content](https://www.noaa.gov/office-education/outreach-communication/faq#using-noaa-content) | Atribuce, upravené podklady, bez použití loga a bez tvrzení o schválení NOAA. |
| Maska pevnin | Existující Natural Earth / CountryPolygons.js | Public domain. Vlastní 1024×512 PNG pouze pro rozlišení průhledného oceánu a neprůhledné pevniny. |

## Aktuální oceánská síť 1.11.23

202 autorských povrchových větví a 29 hlubinných/podpovrchových koridorů (včetně navzájem výlučných sezónních variant). Regionální rozšíření 1.11.26 popisuje PATCH-OCEAN-1.11.26.md. `tools/prepare_ocean_network.py` s modulem `tools/ocean_regions.py` sestavuje pojmenované proudy ze sdílených uzlů a mořských mezibodů; neextrahuje nové trasy z původních maskových šipek. `tools/prepare_circulation.py` volá tento generátor a obnovuje dosavadní masku pevnin. `tests/ocean-network.cjs` kontroluje směrovanou topologii, rozdělení, kontinuitu i vykreslené mořské osy proti polygonům. Původní NOAA masky a statická vrstva v běžném glóbu zůstávají původním samostatným podkladem. Historické řádky zdrojové tabulky výše popisují původní 1.11.0; aktuální data už nejsou digitalizací těchto masek.

Odborné popisy níže podporují směr a charakter sítí. Konkrétní souřadnice, počet větví a jejich sdílené uzly jsou vlastní generalizace, nikoli data převzatá od institucí. Žádný nový externí obrázek ani mapa nebyly přebaleny.

| Podklad | Použití |
|---|---|
| https://www.noaa.gov/jetstream/ocean/circulations/jetstream-max-major-ocean-currents | Základní povrchové systémy a gyry |
| https://uhslc.soest.hawaii.edu/ocn620/notes/surface-currents.html | Rovníkové větve a rozdělení Kurošio/Mindanao |
| https://uhslc.soest.hawaii.edu/ocn620/lectures/winds-and-currents.html | Mindanao, protiproud a indonéská výměna |
| https://www.aoml.noaa.gov/phod/altimetry/cvar/nbc/index.php | Severobrazilská retroflexe |
| https://www.aoml.noaa.gov/phod/altimetry/cvar/agu/index.php | Agulhaský návrat a únik víry do Atlantiku |
| https://oceanexplorer.noaa.gov/explorations/07philippines/background/edu/purpose.html | Indonéský průtok přes Celebeské moře a Makassar |
| https://www.pmel.noaa.gov/public/pmel/publications-search/search_abstract.php?fmContributionNum=4972 | Indonéské průlivy a sezónní proměnlivost |
| https://www.csiro.au/en/news/All/News/2015/May/Measuring-an-ocean-of-change | Východoaustralský/Tasmanův systém |
| https://www.csiro.au/en/news/all/articles/2015/may/the-good-news-el-nino-story-for-western-australias-oceans | Leeuwinův proud |
| https://nettarkiv.npolar.no/www.arcticsystem.no/en/outsideworld/oceancurrents/index.html | Špicberské, grónské a transpolární větve |
| https://npolar.no/en/projects/a-twain/ | Větvení atlantského přítoku u Špicberků |
| https://www.geomar.de/en/discover/ocean-and-climate/ocean-observation/ocean-currents | Hlubinný atlantický tok a cirkumpolární výměna |

Somálský a monzunový tok je označený jako letní varianta; není propojen se simulovaným datem. Přenos Mosambikem i agulhaský únik probíhá reálně víry a proměnlivými filamenty. Zobrazené uzly nepředstavují pevné body rozdělení ani poměry objemového transportu. U některých konfluencí karty pouze uvádějí související větve, ne přímou kontinuitu.

## Atmosférické pole 1.11.25

`tools/prepare_atmosphere.py` používá `tools/atmosphere_field.py`. Přízemní proudnice jsou integrací RK4 jednoho souvislého analytického pole na kouli: pasáty, západní a polární větry, široké klimatologické tlakové anomálie, sezónně posunutá ITCZ a regionální monzunové složky. Prostorové proudnice střední cirkulace používají analytickou převracející proudovou funkci a zonální složku; propojují spodní a horní větev se vzestupem a sestupem. Hadleyův tropický okraj následuje schematickou ITCZ. Normální detail zobrazuje 258 přízemních a 108 prostorových proudnic po celé kouli, nikoli počet meteorologických systémů. Podrobnosti a omezení: PATCH-ATMOSPHERE-1.11.25.md.

Původní meridionální graf zůstává jen pro řez a jeho jednotlivě vybraný výklad. Původní řídké větrné příklady a rovné tlakové pásy se na globusu nezobrazují. Obvyklé výše a níže mají vlastní obrysy a popisky V/N. Roční schéma, severní léto a severní zima jsou nezávislé na astronomickém datu. Tlakové obrysy nejsou izobary; nejsou načtena data reanalýzy ani GFS. Převracející pole je oddělenou idealizací střední cirkulace, nikoli plně dynamickým nebo hmotnostně uzavřeným modelem regionálních větrů.

| Odborný podklad | Použití |
|---|---|
| https://www.noaa.gov/jetstream/global/global-atmospheric-circulations | Směr středních meridionálních větví a tlakové pásy |
| https://weather.metoffice.gov.uk/learn-about/weather/atmosphere/global-circulation-patterns | Převládající větry a klimatologické buňky |
| https://www.noaa.gov/jetstream/global/jet-stream | Západní subtropické/polární jety |
| https://www.noaa.gov/jetstream/upper-air-charts/longwaves-and-shortwaves | Výukové zvlnění jetů; pohyb vzduchu není pohyb celé vlny |
| https://www.climate.gov/news-features/blogs/enso/walker-circulation-ensos-atmospheric-buddy | Walkerův systém, námořní kontinent, vedlejší vzestup v Africe a Jižní Americe; archivovaný odborný popis |
| https://www.climate.gov/comment/19646 | Pacifický vzestup na západě, sestup na východě, horní tok východně a dolní západně |
| https://weather.metoffice.gov.uk/learn-about/weather/types-of-weather/wind/monsoons | Monzunová sezónnost, zimní asijský odtok a regionální monzuny |
| https://weather.metoffice.gov.uk/learn-about/weather/atmosphere/intertropical-convergence-zone | ITCZ a sezónní přesun srážkových oblastí |
| https://www.metoffice.gov.uk/binaries/content/assets/metofficegovuk/pdf/services/government/west-africa-climate-risk-report-final.pdf | Západoafrická letní monzunová oblast |
| https://epic.noaa.gov/wp-content/uploads/2023/08/11.-2023_07_24_WINGS_Shreyas_Dhavale.pdf | Rozlišení nízkoúrovňového somálského a výškového tropického východního jetu |

Podklady podporují obecné mechanismy, nikoli konkrétní nakreslené koridory. Žádné nové externí fotografie, mapy ani ilustrace nejsou distribuované. Označení „public domain“ původních NOAA maskových obrázků se nevztahuje na materiály Met Office; do aplikace jsou přidané vlastní texty a geometrie, bez kopírování těchto materiálů.

Další podklady pro klimatologické tlakové útvary, sezónnost a princip souvislé vizualizace:
- NOAA CPC Atlas 3: https://www.cpc.ncep.noaa.gov/products/precip/atlas3/cont_chp4.html a https://www.cpc.ncep.noaa.gov/products/precip/atlas3/cont_chp3.html
- https://github.com/cambecc/earth
- https://media.bom.gov.au/social/blog/1989/the-wet-and-the-dry-seasons-in-the-topics/
- https://doi.org/10.1175/JCLI-D-21-0518.1
- https://journals.ametsoc.org/doi/10.1175/JCLI-D-17-0229.1

## Prostorová geometrie

- Hlubinné větve používají reprezentativní −3 km; skutečné vodní hmoty mají proměnlivý hloubkový rozsah. Návratové větve mají 0 km. Ukázky pobřežního upwellingu používají zvětšený hloubkový odstup pro demonstraci směru, nikoli přesnou hloubku pobřežního zdroje vody.
- Větry 1 km, spodní/vrchní větev buněk 0,5/12 km, jet streamy 10–12 km: pouze reprezentativní výukové hladiny. Tropopauza a skutečná výška proudění se mění. Tříbuněčný model je průměrný a idealizovaný. Ferrelova buňka je výslovně tepelně nepřímá a poháněná transportem víry.
- Při vypnutí zvýraznění je geometrický poloměr `1 + h/6371`, povrchové čáry mají nepatrný technický odstup 1,006. Zvětšené výšky a hloubky jsou vždy označené. Průhledný je pouze oceán; kontinenty zůstávají neprůhledné. Bez zvětšení mohou být hlubinné či atmosférické hladiny opticky velmi blízko povrchu.
- Řez od rovníku k severnímu pólu používá stejné datové buňky převedené do zvětšeného poledníkového výukového řezu. Otáčení, zoom, výběr a pauza zůstávají společné. Současný globální model obsahuje obě polokoule.

## Renderování a ovládání

Stejný Three.js renderer, scéna, kamera, gesta a hlavní requestAnimationFrame. Geometrie vznikne až při prvním otevření. Čáry jsou sloučené podle barev, vybraný proud má vlastní zvýraznění. Animaci vytváří shader s pohybujícími se filamenty a šipkami; nemá DOM ani CPU částice. Výpočet geometrie a projekce není součástí každého animačního kroku. Geometrie se drží pouze pro právě zvolenou sezónu; při změně se staré buffery uvolní. Vypnuté větve nejsou vykreslované ani animované. Po opuštění režimu se zastaví jeho aktualizace a obnoví původní kamera, mapa a vrstvy. Geometrie zůstává v malé cache pro další otevření; při změně měřítka se korektně dispose/rebuild.

Povrchový shader v režimu Cirkulace přeskočí výpočty noci, politických a astronomických překryvů; původní režimy používají původní výpočet. Popisky se přepočítají při změně kamery, zoomu, rozměrů, názvů nebo výběru, s limitem 4/6/10 podle pohybu a množství vrstev. Picking se provádí až při klepnutí, má toleranci 18 CSS px a skrývá odvrácené dráhy. Dostupný je také seznam jevů. Karty mají zavření a skládací podrobnosti.

Předvolby povrch / hlubina / atmosféra / převládající větry / jet streamy / oceán + atmosféra nastavují jen relevantní vrstvy. Výchozí jsou pouze povrchové proudy. Rychlost a hustota částic jsou ovladače vizualizace; nesouvisí se simulačním astronomickým časem. Pauza ponechá čáry a šipky. Existující landscape drawer a focus mode fungují beze změny architektury.

## Omezení a ponechané části

Žádné rychlosti v m/s bez podloženého měření. Žádné živé API, sezónní meteorologie, monzuny, ENSO ani fluidní model. Hlubinná cirkulace a vertikální pohyb jsou názorná schémata, ne globální aktuální měření. Volitelné samostatné 3D řezy upwellingu a termohalinní cirkulace ani zvláštní vrstva přenosu tepla nejsou přidány; příčiny a klimatické vazby jsou v kartách. Datové ID, vrstvy a prostorové body umožňují pozdější doplnění sezónních variant.


## Zobrazení 1.11.2
Barevné prostorové pásy a větší pohyblivé šipky; výchozí názvy i při oddálení. Hlubina má neprůhledné podloží a odvrácené proudy jsou shaderem skryté. Jemné oceánské překrytí slouží jen k lokální hloubkové názornosti. Podrobnosti a testy: PATCH-CIRCULATION-1.11.2.md.


## Zobrazení 1.11.3 (nahrazuje 1.11.2)
Hladké ploché stuhy a barevně sladěné šipky přímo na jejich povrchu. Atmosférické buňky mají oválné smyčky. Vnitřní podloží/koule a průhledná oceánská okna odstraněny; hlubinné dráhy jsou výukově zviditelněny na přivrácené straně přes neprůhlednou mapu. Ostatní strana zůstává skryta. Detaily: PATCH-CIRCULATION-1.11.3.md.


## Oprava návazností 1.11.4
Sedm jasných návazností spojuje společný bod a okraje stuh bez zúžení u spojů; včetně přechodu 180° a Golfský→Severoatlantský proud. Původní data nebyla upravena. Detaily: PATCH-CIRCULATION-1.11.4.md.

## Povrchové proudění 1.11.5

Měkký poloprůhledný koridor, pět jemných animovaných proudnic a decentní doplňkové chevrony nahrazují plošně barevnou stuhu u povrchových proudů. Shader vytváří pohyb i bez zapnutých šipek; Pause zmrazí celý tok. Hloubkové a atmosférické vrstvy ponechávají dosavadní vzhled. Podrobnosti a omezení měření: PATCH-CIRCULATION-1.11.5.md.

## Jednotný vzhled oceánského toku 1.11.7

Měkké koridory, pět animovaných proudnic a decentní chevrony jsou nově i u hlubinných a návratových větví. Hloubková geometrie a oříznutí odvrácené hemisféry zachovány, žádná průhledná ani druhá koule. Detaily: PATCH-CIRCULATION-1.11.7.md.

## Lehké vzdušné proudění 1.11.8

Atmosférické proudy zobrazují tři jemné shaderové proudnice, velmi průsvitný koridor a decentní směrové chevrony. Jet streamy jsou užší, fialové a rychlejší; ITCZ/tlakové pásy jemné. Výukové výšky buněk a jetů sníženy, přízemní větry výše než oceán. Model i oceánský shader zachovány. Detaily a testy: PATCH-CIRCULATION-1.11.8.md.

## Regionální oceánská síť 1.11.26

Severní moře, Balt, Středomoří, Karibik, Baffinův záliv, Beaufortův gyr, Beringovo a Ochotské moře, Japonské a východočínské moře, Jihočínské moře, Nový Zéland, Lombocká větev, severní Indický oceán, Rudé moře a Perský záliv; také rovníkové podpovrchové proudy. Sdílené souřadnice a směrové tečny propojují skutečně související koridory. Protikladné sezónní varianty mají oddělenou geometrii a tečny; zobrazena je jen zvolená oceánská sezóna. Podpovrchové návraty mají samostatné hloubkové uzly a související odkazy v kartách.

Nové regionální osy jsou mořské polylinie s místně zaoblenými ohyby. Generátor zachovává odborné mezibody, dovoluje jen místní geografické obchvaty a odmítá vyhlazení přes pevninu. Šířka pásu se zmenšuje podle vzdálenosti k pobřeží; u společných uzlů je pro všechny incidentní větve stejná. Maska a polygony pevnin se nemění. Generování potřebuje Python, NumPy a Matplotlib; běžné sestavení APK používá hotová data bez těchto závislostí.

Oceánská sezóna je nezávislá na atmosférické sezóně a datu aplikace. Výchozí letní oceánský scénář navazuje na dříve zobrazený somálský/monzunový příklad. Volba „Bez sezónních příkladů“ ukazuje jen nespecifikované střední koridory, nikoli skutečný číselný roční průměr. Přepínač oblasti filtruje oceánskou síť; odkazy v kartách mohou přejít do navazující oblasti nebo sezóny.

Test `tests/ocean-regions.cjs` ověřuje všechny letní i zimní nové mořské osy a oba okraje pásů proti polygonům aplikace, sdílené konce/okraje ve třech scénářích, návazné regionální trasy, směr Beaufortova oběhu a skutečné obsluhy ovládání. Řešení není navigační mapa, hydrodynamický model ani předpověď počasí/oceánu.

## TS-08 — El Niño a jednotný výklad (1.11.27)

`CirculationEducation.js` vytváří sjednocené karty na pracovních kopiích původních dat a dodává kvalitativní scénář El Niño. Výchozí datové soubory jsou nezměněné. `modelRows(oceanSeason, elNino)` upraví pouze pacifické větve a doplní teplotní/transportní ilustrace; `setElNino` obnovuje předchozí vrstvy a oběhy. Pasátový efekt se v shaderových atributech omezuje plynulou geografickou maskou na tropický Pacifik. Profil používá stejné parametry stavu pro Walkerovu smyčku a sklon termokliny; hloubky jsou pouze reprezentativní. Podrobnosti, primární podklady a výsledky testů v `PATCH-TS-08-1.11.27.md`.