Bolidozor wiki

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

FIXME **This page is not fully translated, yet. Please help completing the translation.**\\ //(remove this paragraph once the translation is finished)//

====== Bolidozor network conventions ======

This page contains proposal of conventions for stations' settings and operation in Bolidozor network.

===== Observatory =====

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. 
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 atd.

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
  │   ├── radio-observer.log
  │   └── station
  │       ├── Bolidozor.json
  │       ├── bus_config.py
  │       ├── rmob.cfg
  │       ├── data
  │       ├── meteors
  │       └── snapshots
  ├── repos
  │   ├── pymlab
  │   ├── 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 //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]]

Please fill all the letters into the box to prove you're human. I A X U B Please keep this field empty:

Edit summary

Note: By editing this page you agree to license your content under the following license: GNU Free Documentation License 1.3