Differences

This shows you the differences between two versions of the page.

--- en:convention [2017/01/10 20:36] – created fluktuacia
+++ en:convention [2019/04/24 13:34] (current) – [Data structure] fluktuacia
@@ Line 1: / Line 1: @@
-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.
+This page contains proposal of conventions for stations' settings and operations within 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.
+In the context of Bolidozor network an observatory represents a locality where there is a potential to realise more observations. Typical examples include private or public observatories.
-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.
+From the perspective of structure at [[en:servers|data storage]], an observatory is a place that stores data from individual stations. At the present time, the data server login id is the same as the name of the observatory.
-V budoucnu je možné, že jedna observatoř bude mít více uživatelských účtů.
+It is possible that in the future one observatory will have more user accounts.
+===== Stations =====
-===== Stanice =====
+In the context of the Bolidozor network a station is a defined measuring device. Different stations, each measuring different quantities, can therefore exist at one observation spot / Observatory.
-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.
+==== Radio detection stations ====
-==== Rádiové detekční stanice ====
+Radio detection stations have a following name convention: **Station-Observatory-RX**, where the observatory corresponds to the name of observatory where the station is located. The suffix RX is an ordinal number of the station in the observatory. For example //OBSUPICE-R4// means the 4th station for meteor detection at OBSUPICE observation spot.
-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ě 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.
+The ordinal number increases at every change of the station configuration that may influence the recorded data - e.g. moving the antenna, changing cables, changing the configuration of detection software, changing the format of output data etc.
+</WRAP>
+A special case is a station with R0 revision - it is reserved for test purposes and the data from R0 stations are not considered valid.
-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í.
+There are cases when there is possible to distinguish stations according to the type of measurement using a suffix in their names. However, as there are so far no other types of radio stations apart from [[en:rmds|RMDS]] in Bolidozor networ, such differentiation has not been implemented yet.
-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.
+==== Data structure ====
-==== Datová struktura ====
+Example of name of data files: //TIME_NAME_TYPE.EXTE//
+The length of the file name is limited to 50 characters.
-Příklad názvu datových souborů //TIME_NAME_TYPE.EXTE// Delka celého názvu souboru je omezena na 50 znaků.
+  * TIME represents a timestamp with resolution of at least ms or ns
+  * NAME represents the station's id and can have a length of a maximum allowed length of the name. The name should also include version of the current station's configuration, e.g. //RADIO-SVAKOV-R1//
+  * TYPE represents the data identification. It is usually 'met', 'raws', 'snap', etc. according to the type of the recorded data
+  * EXTE represents file's suffix, denoting its format ([[https://en.wikipedia.org/wiki/Comma-separated_values|CSV]], [[http://en.wikipedia.org/wiki/FITS|FITS]])
-  * TIME  je časový údaj s rozlišením alespoň ms, případně ns.
+In order to contribute to the database it is required that the file name has a form of the following regular expression:
-  * 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ů:
+Examples of files:
   20140815131105154_OBSUPICE-R1_snap.fits
   20140815150803480_OBSUPICE-R1_raws.fits
@@ Line 50: / Line 51: @@
-==== Adresářová struktura na stanici ====
+==== Station's directory structure ====
-Adresářová struktura správně nakonfigurované stanice Bolidozor vypadá následovně.
+Directory structure of a correctly configured Bolidozor station looks as follows.
   User_Name
@@ Line 76: / Line 77: @@
   └── 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.
+All measured data, including metadata, are stored in //bolidozor// directory. This directory has a subdirectory called 'station' that contains recorded data in a hierarchical directory structure. The uppermost directory contains shared metadata files for nested 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]].
+  * **rmob.cfg** - Station's parameters, its location, position, HW version. This file is necessary in order to export data to [[en:rmob-export|rmob.org]] network.
-  * **Bolidozor.json** - Nastavení stanice a měření.
+  * **Bolidozor.json** - Configuration of station and measurements.
-Složka bolidozor tím pak částečně kopíruje datovou strukturu stanice na serveru [[cs:servers|space.astro.cz]].
+Bolidozor directory thus partially copies the data structure of the station at [[en:servers|space.astro.cz]] server.
+===== Problems to solve =====
-===== K vyřešení =====
+==== Identification of station's position ====
+It is necessary to label the position of station by some unambiguous identification mark. There are several options:
-==== 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
+  * Locator
-  * Adresa [[https://en.wikipedia.org/wiki/What3words|What3words]]
+  * Address [[https://en.wikipedia.org/wiki/What3words|What3words]]