Bolidozor wiki

Upravte stránku a stiskněte Uložit. Na stránce syntax se můžete dozvědět více o wiki syntaxi. Prosím upravujte stránky pouze, pokud je můžete vylepšit. V případě, že si chcete něco pouze vyzkoušet, použijte raději pískoviště.

====== 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
  │   ├── 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]]

Vyplňte, prosím, všechna písmena v poli, abyste dokázali, že nejste robot. C U A S O Ponechte prosím toto pole prázdné:

Komentář k úpravám

Poznámka: Tím, že editujete tuto stránku, souhlasíte, aby váš obsah byl licencován pod následující licencí: GNU Free Documentation License 1.3