====== 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ř =====

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 [[cs:servers|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 =====

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. 

==== Rádiové detekční stanice ====

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 [[cs:vlf|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í.

==== Datová struktura ====


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 ([[http://cs.wikipedia.org/wiki/CSV|CSV]], [[http://en.wikipedia.org/wiki/FITS|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 na stanici ====

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 [[cs:servers|space.astro.cz]]. 

===== K vyřešení =====


==== Identifikace pozice stanice ====

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

  * Latitude, Longitude
  * [[http://en.wikipedia.org/wiki/Geohash|Geohash]]
  * Lokátor