Konvence v síti Ionozor

Na této stránce najdete návrh konvencí nastavení a používání stanic v síti Ionozor.

Observatoří se ve smyslu sítě Ionozor myslí lokalita, kde je potenciálně možné, že by mohlo být realizováno více pozorování. Typickým příkladem jsou hvězdárny, nebo soukromé pozorovatelny.

Observatoř je také z pohledu struktury na datovém úložišti také místo, kde jsou uložena data od jednotlivých stanic. Zatím je uživatelské jméno pro přihlášení na datový server identické s názvem observatoře.

V budoucnu je možné, že jedna observatoř bude mít více uživatelských účtů.

Stanice je z pohledu sítě Ionozor měřící zařízení v definované podobě. Na pozorovacím místě/Observatoři může pak existovat více různých stanic měřících odlišné veličiny.

Pro rádiové detekční stanice je navržena jmenná konvence Stanice-Observatoř-RX. Kde observatoř odpovídá názvu observatoře, na které je stanice umístěna. Přípona RX je pořadové číslo stanice v této observatoři např. OBSUPICE-VLF-R4, což je 4. verze stanice pro VLF měření na pozorovacím místě OBSUPICE. Pořadové číslo stanice se zvedá při každé změně stanice, která může mít vliv na přijímaná data. Např. přesunutí antény, výměna kabelů, změna konfigurace detekčního softwaru, změna formátu výstupních dat a podobně.

Speciálním případem je stanice s revizí R0, která je rezervována pro testovací účely a data ze stanic s revizí R0 nejsou pokládána za validní.

Příklad názvu datových souborů TIME_NAME_TYPE.EXTE Delka celého názvu souboru je omezena na 50 znaků.

• TIME je časový údaj s rozlišením alespoň ms, případně ns.
• NAME je indentifikátor stanice a může mít délku do maximální povolené délky celého názvu. Název by měl obsahovat i verzi konfigurace stanice. Např. SVAKOV-VLF-R1
• TYPE je identifikátor dat například je „snap“ nebo „meta“podle typu zaznamenávaných dat
• EXTE je přípona souboru, označující jeho formát (CSV, FITS)

Podmínkou přispívání do databáze je splnění následujícího regulárního výrazu pro název souboru:

({0-9}{4})([0-9]{2})([0-9]{2})([0-9]{2})([0-9]{2})([0-9]{2})([0-9]{3})([A-Z]{1})?_[A-Z0-9]{1,20}(_([A-Z0-9]{1,4}))?(\.[0-9a-zA-Z]{1,4})?

Konkrétní příklady souborů:

20140815131105154_OBSUPICE-VLF-R1_snap.fits
20140808100000_OBSUPICE-VLF-R1_meta.csv

Adresářová struktura správně nakonfigurované stanice Ionozor vypadá následovně.

User_Name
├── ionozor
│   ├── radio-observer.log
│   └── station
│       ├── Ionozor.json
│       ├── data
│       └── snapshots
├── repos
│   ├── pysdr
│   ├── python-mlab-utils
│   ├── radio-observer
│   ├── data-uploader
│   ├── sdr-widget
│   ├── signal-piping-tools
│   └── station-supervisor
├── resize_fs.sh
└── setup_reverse_tunnel.sh

Všechna měřená data včetně metadat jsou ukládána do složky ionozor. Ta obsahuje podsložku station, kde jsou v hierarchické adresářové struktuře uložena měřená data a v nejvyšším adresáři jsou společné meta datové soubory pro vnořená data.

• Ionozor.json - Nastavení stanice a měření.

Složka ionozor tím pak částečně kopíruje datovou strukturu stanice na serveru space.astro.cz.

Pozice stanic je potřeba označit jednoznačným identifikátorem. Jsou následující možnosti, jak to řešit:

• Latitude, Longitude
• Geohash
• Lokátor