Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

--- cs:convention [2014/10/30 13:50] – vytvořeno kaklik
+++ cs:convention [2017/01/28 09:32] (aktuální) – [Rádiové detekční stanice] kaklik
@@ Řádek 1: / Řádek 1: @@
 ====== Konvence v síti Bolidozor ======
+Na této stránce najdete návrh konvencí nastavení a používání stanic v síti Bolidozor.
+===== Observatoř =====
+Observatoří se ve smyslu sítě Bolidozor 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ě Bolidozor 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-R4//, což je 4. stanice pro detekci meteorů na pozorovacím místě OBSUPICE.
+<WRAP center round important 80%>
+Pořadové číslo stanice se zvedá při každé změně v konfiguraci 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 atd.
+</WRAP>
+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í.
+V některých případech je možné stanice odlišovat ještě podle typu měření předponou v názvu. Zatím ale v Bolidozoru neexistují jiné rádiové stanice než [[cs:rmds|RMDS]], proto takové rozlišení ještě nebylo zavedeno.
+==== 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ř. //RADIO-SVAKOV-R1//
+  * TYPE  je identifikátor dat, obvykle je "met", "raws", "snap" a tak dále 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-R1_snap.fits
+  20140815150803480_OBSUPICE-R1_raws.fits
+  20140815150948269_OBSUPICE-R1_met.fits
+  20131215115954558_SVAKOV-R2_fb.jpg
+  20131215115955002_SVAKOV-R2_nomet.jpg
+  20140808100000_OBSUPICE-R1_meta.csv
 ==== Adresářová struktura na stanici ====
+Adresářová struktura správně nakonfigurované stanice Bolidozor vypadá následovně.
   User_Name
-  ├── Bolidozor
+  ├── bolidozor
-  │   └── ObservatoryName
+  │   ├── radio-observer.log
-  │       └── StationName
+  │   └── station
-  │           ├── data
+  │       ├── Bolidozor.json
-  │           ├── meteors
+  │       ├── bus_config.py
-  │           ├── snapshots
+  │       ├── rmob.cfg
-  │           └── Sort
+  │       ├── data
-  │               ├── data
+  │       ├── meteors
-  │               ├── meteors
+  │       └── snapshots
-  │               └── snapshots
+  ├── repos
-  ├── Desktop
+  │   ├── pymlab
-  ├── git
-  │   ├── jack2
   │   ├── pysdr
+  │   ├── python-mlab-utils
   │   ├── radio-observer
-  │   └── RMDS-data-uploader
+  │   ├── data-uploader
-  └── svn
+  │   ├── sdr-widget
-      ├── Host_controller
+  │   ├── signal-piping-tools
-      └── qjackctl-svn
+  │   └── station-supervisor
+  ├── resize_fs.sh
+  └── setup_reverse_tunnel.sh
+Všechna měřená data včetně metadat jsou ukládána do složky //bolidozor//. 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.
+  * **rmob.cfg** - Parametry stanice, umístění, poloha, verze HW. Tento soubor je potřebný pro export dat do sítě [[cs:rmob-export|rmob.org]].
+  * **Bolidozor.json** - Nastavení stanice a měření.
+Složka bolidozor 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
+  * Adresa [[https://en.wikipedia.org/wiki/What3words|What3words]]