--------------------------------------------------

  ===  ==  \  |
   |  |__|  \ |    RADARIVAATUR
   |  |\     \|

--------------------------------------------------

Versioon 2023.6.22

Tarmo Tanilsoo, 2023

-----
Programm töötab ainult Python 3'ga.

Probleemidest teatamisel palun saata ka fail, millega probleem esineb, et mul oleks võimalik probleemi diagnoosida.

-----
** KASUTAMINE

Käivitamine 

Linuxi(ja teiste Bashi shelli kasutavate opsüsteemide all) all selles samas kaustas

./run

Windowsi all käivitada fail main.pyw kaustas src (NB! Faililaiendi muutus võrreldes varasemate versioonidega!)

---
Kasutusel on viis režiimi:
* Liikumine
* Suurendamine
* Informatsioon
* PseudoRHI
* Second trip-kajade liigutamine

Liikumisrežiimis saab ainult kaarti hiirega ringi lohistada.

Suurendamisrežiimis saab kaardile hiirega klikkides või lohistades sisse/välja suurendada.
Vasaku hiireklahviga suurendatakse, parema hiireklikiga vähendatakse.
Informatsioonirežiimis saab pildile klikkides infot konkreetse piksli kohta.
Second trip-kajade liigutamise režiimis on võimalik valida manuaalselt andmetes mingi regioon, mis siis maksimaalse selge kauguse(c/2PRF) jagu edasi liigutada. Vajalik on PRF-i defineerimine faili metaandmetes.

Failimenüüst on võimalik parasjagu lahtiolevat pildivaadet eksportida PIL poolt toetavatesse vormingutesse.

Samuti on võimalik luua pseudoRHI'sid(ainult andmed, mis sisaldavad rohkem kui ühe kõrgustaseme andmeid) kasutaja soovitud asimuutidest.

Alates versioonist 2016.1.11 on võimalik JSON failide kaudu kirjeldada dünaamilisi andmepunkte mille väärtused võivad ajas muutuda. Näiteks on võimalik kirjeldada näiteks hetketemperatuure internetileheküljel JSON failina programmile sobival kujul. Detailsem formaadi kirjeldus on kaustas /doc (ingl. k). Samuti on võimalik vaates ära muuta värviskaala - vaikimisi väärtuste tagasi saamiseks tuleb see uuesti menüüst valida.

Vaata ka demovideot, kus näidatakse töö käiku: http://youtu.be/RZOYDvJv434 
(videos on liides inglise keeles, kuid olemas on ka eestikeelne kasutajaliides)

-----
** NÕUDED

* Python 2 või Python 3
* Tkinteri jooksutamise võimalus
* Python Imaging Library, võib olla ka selle Pillow fork(arendusmasinal jooksebki juba see, kuna see tuleb uuemate Ubuntu distributsioonidega kaasa). Muuhulgas peab olema ka ImageTk moodul, vähemalt Ubuntulistel on see eraldi pakis.
* H5Py
* numpy
* netCDF4

Soovitatavalt vähemalt 1 GB RAM'i.

Windowsi kasutajatel peaks olema ilmselt kõige lihtsam paigaldada käsurealt Python Package Index repositooriumi kaudu paketid Pillow ja h5py, sealt peaksid automaatselt kaasa tulema ka muud nõutavad moodulid.
-----
** TOETATUD FORMAADID

* Nexrad Level III - produktid 94, 99, 157, 161, 162, 163, 165
* Nexrad Level II - kõik produktid (alates versioonist EX1 nii MSG1 Kui MSG31)
    NB! NCDC'st saadavad failid on algselt GZipis kokku pakitud, need tuleb enne programmis vaatamist lahti pakkida!
* ODIM HDF5 - Alates H5rad 1.2. PVOL objekt. Produktid DBZ(ka DBZH, DBZV), VRAD, VRADD KDP, PHIDP, RHOHV, WRAD, ZDR, TH, TV, HCLASS, SQI.
* DWD BUFR (nii nagu see väljastatakse nende avaandmetena)
* KNMI HDF5 - samad produktid mis ODIM H5 variandi puhul, suunatud KNMI avaandmete väljundile.
* IRIS RAW - samad produktid, mis ODIM H5 puhul.
* DORADE - väga toores tugi.
* JMA GRIB - polaarkoordinaadistikus andmed. Faili nimi peab järgima JMA struktuuri, kuna seda kasutatakse produkti tüübi tuvastamiseks.
* CfRadial - veel toores, sihitud PyART'i poolt genereeritud failidele

Olen avatud täiendavatele formaatidele toe lisamisele, kuid sellisel juhul vajan formaadi dokumentatsiooni, näidisfaile ning näidet oodatavast väljundist.

Kasutatud allikad:

Kaardikontuurid - Natural Earth - http://www.naturalearthdata.com
Pildiosas kasutatavad fondid - DejaVu Sans Condensed - http://dejavu-fonts.org, Noto Sans JP: https://fonts.google.com/noto/specimen/Noto+Sans+JP
Näidisfail /data kaustas: NEXRAD Level 2 arhiiv(Vaata märget ülalpool!) - www.ncdc.noaa.gov/nexradinv/ (doi:10.7289/V5W9574V)
Näites kasutatud dünaamiline andmefail põhineb USA tormiennustuskeskuse (SPC) tormiraportitel 20. mai 2013 kohta.

-------
Märkused:

* Esimesel käivitamisel võib kuluda kaartide .pyc'sse kompileerimise tõttu rohkem aega 
ning mälu. Edasistel käivitamistel läheb juba ladusamalt.
* Produktivaliku menüüs kasutatakse nüüd allika tüübist hoolimata ODIM H5 lühendeid.
* Vaadete täpsuses võib olla puudusi(nende avastamisel palun lahkesti teada anda).
* Kuna osade tegevuste jaoks kasutatakse endiselt ainult ühte protsessorilõime, näib programm nende tegevuste ajal tarduvat. See peabki nii olema.
* Alates EX1 versioonist (välja antud 26.01.2018) on muudetud pseudoRHI joonistamise metoodikat, seetõttu paistavad andmed senisest natuke kõrgemad.
* ODIM H5 väljund on esialgne ning pigem eesmärgiga salvestada teistest vormingutest pärit andmeid programmile loetaval kujul. Eriti näiteks USA andmete puhul tuleb teha standardist kõrvalekaldeid. Saksa andmete eksportimisega probleemi ei tohiks olla.
* Radiaalkiiruste dealiasingu algoritm on väga algeline ning sõltuvalt failist tuleb manuaalselt rakendada erinevate meetodite kombinatsioone.

---------
Kontakt:

E-mail: tarmotanilsoo@gmail.com
Twitter: @es5nhc