Rozdíly

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

--- cs:radio-observer [2014/04/10 20:09] – kaklik
+++ cs:radio-observer [2014/11/09 11:18] (aktuální) – [Rádioastronomický pozorovací software radio-observer] kaklik
@@ Řádek 1: / Řádek 1: @@
 ====== Rádioastronomický pozorovací software radio-observer ======
-Jde o program jehož cílem je nahradit živého pozorovatele sledujícího data z radioteleskopu na přítomnost nějaké zajímavé události. Například bolidu.
+Jde o relativně univerzální radioastronomický software, který je určený pro detekci anomálních zajímavých událostí v toku rádiových dat. V případě Bolidozoru jsou to rádiové bolidy.
-V principu by mělo jít o komplementární aplikaci k [[cs:pysdr|PySDR]], která je naopak určena pro vizualizaci měřených dat.
+**Radio-observer nemá žádný interaktivní grafický výstup**. V principu by mělo jít o komplementární aplikaci k [[cs:pysdr|PySDR]], která je naopak určena pro vizualizaci měřených dat včetně událostí detekovaných radio-observerem, které přijímá přes [[http://cs.wikipedia.org/wiki/Musical_Instrument_Digital_Interface|MIDI]].
-===== PySDR a radio-observer =====
+Podrobnější technický popis programu je na [[http://wiki.mlab.cz/doku.php?id=cs:radio-observer|wiki MLAB]].
-Cílem projektu je vytvořit soustavu nástrojů pro radioastronomická pozorování na vzdálených stanicích. Důvody k tomu jsou:
+===== Ovládání radio-observeru =====
-  * Stanice se vyskytují obvykle jinde, než pozorovatelé
+Naprostá většina parametrů radio-observeru je definována v konfiguračním souboru ve formátu JSON. Konfigurační soubor je očekáván v //~/.radio-observer.json//. Případně může být zadán přepínačem při spuštění programu **-c CONFIG_FILE**.
-  * Je výhodné mít možnost spravovat více pozorovacích míst z jednoho pracoviště
-Program radio-observer by měl být nástroj, který bude samostatně vykonávat pozorování, na základě detekčních skriptů napsaných v Pythonu. Tyto skripty by měly běžet i v programu pySDR, který by měl sloužit k vizualizaci jejich funkce na identických datech s těmi, na kterých bude provádět detekci i program radio-observer. PySDR by však kromě možnosti ladit novou verzi skriptů poskytoval i možnost zobrazení stavu radio-observeru zejména z důvodu kontroly jeho funkce. Detekční skripty spuštěné v pySDR by ale neměly generovat datové záznamy. Ale pouze zobrazit detekovanou a ukládanou oblast.
+==== Parametry v příkazové řádce ====
-Důvod toho, proč samotná detekční aplikace má běžet na počítači u přijímače je ten, že zde je konzistentní přístup k získávaným datům. A navíc může být k dispozici i datový tok s větším rozlišením, než které je dostupné přes síťové připojení.
+Radio observer má minimum parametrů nastavitelných z příkazového řádku. Nejpodstatnějším parametrem je zvolený konfigurační soubor, který bude použit pro detekci.
-===== Podobné SDR systémy klient-server =====
+  * **-c CONFIG_FILE**
+  * **-v** - výpis verze
-  * [[http://wiki.spench.net/wiki/BorIP_Server|BorIP Server]]
-  * [[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3|ghpsdr3]]
-==== Jiné softwarové nástroje pro práci s radioastronomickými daty ====
+==== Konfigurační soubor ====
-  * [[http://satorchi.net/specsoft/specsoft.php|List of Radio Astronomy data analysis software]]
+Konfigurační soubor je ve formátu [[http://cs.wikipedia.org/wiki/JavaScript_Object_Notation|JSON]], který je rozšířený o možnost použití komentářů uvozených znakem %%//%%.
+Formát ukázkového souboru je následující:
+  {
+  	"jack_left_port":  "system:capture_1",   // název JACK portu, ke kterému se má radio-observer připojit
+  	"jack_right_port": "system:capture_2",
+  	"configuration": "default",     // název konfigurace která bude použita po spuštění programu.
+  	"configurations": [
+  		{
+  			"key":     "default",   // identifikátor konfigurace
+  			"factory": "pipeline",
+  			"children": [
+  				{
+  					"key":     "backend",
+  					"factory": "waterfall",
+  					"bins":    32768,   // počet binů FFT
+  					"overlap": 24576,   // překryv FFT binů
+  					"origin": "TEST-R0", // nazev stanice
+  					"iq_gain":        0,
+  					"iq_phase_shift": 0,
+  					"children": [
+  						{
+  							"key":     "recorder",
+  							"factory": "snapshot",
+  						    	"output_dir": "~/Bolidozor/TEST-R0/snapshots",   // adresar pro snapshoty
+  							"output_type": "snap", // zobrazovany typ souboru ve jmenu souboru
+  							"snapshot_length": 60,   // délka snímku spektra v sekundach
+  							"low_freq":      10100,  // spodní frekvenční omezení zaznamenávaného spektra.
+  							"hi_freq":       11000,  // horní frekvenční omezení zaznamenávaného spektra.
+  						},
+  						{
+  							"key":     "recorder",
+  							"factory": "met",      // zobrazovany typ souboru s nahledy detekovanych meteoru ve jmenu souboru
+  						    	"output_dir": "~/Bolidozor/TEST-R0/meteors",   // adresar pro ukladani detekovanych meteoru
+  							"output_type": "met",   // zobrazovany typ souboru s metadaty ve jmenu souboru
+  							"metadata_path": "~/Bolidozor/TEST-R0/data", // adresar pro ukladani metadat
+                            				"advance_time":     12,   // doba v sekundach, která bude zaznamenána v záznamu ještě před detekcí meteoru a po detekci.který bude sloučen do jednoho záznamu.
+                            				"jitter_time":      1,   //maximální interval v sekundach mezi dvěma detekcemi, vice meteoru v tomto intervalu bude povazovano za jeden
+  							"low_detect_freq": 10500,  // dolni frekvence, kde budou detekovány meteory
+  							"hi_detect_freq":  10700,  // horni frekvence, kde budou detekovány meteory
+  							"low_noise_freq":  11000,  // dolni frekvnece pásma pro výpočet intenzity šumu
+  							"hi_noise_freq":    11500, // horni frekvence pasma pro vypocet intenzity sumu
+  						},
+  					],
+  				},
+  			],
+  		},
+  	],
+  }
+Do souboru vepsané české komentáře mají pouze dokumentační charakter. Pro vlastní konfigurační soubor prosím využijte [[https://github.com/MLAB-project/radio-observer/blob/dev/Bolidozor.json|příklad souboru]] v repozitáři radio-observeru, který je neobsahuje.
+Každá stanice má specifický konfigurační soubor, který by měl zůstat zachován po dobu její životnosti. Při změně konfigurační souboru vzniká v podstatě nová stanice.. Tj. například stanice OBSUPICE-R2 bude po změně konfigurace OBSUPICE-R3 a tak dále.
+<WRAP info> Radio-oserver je navržený tak, aby jeho konfigurační soubory nebyly závislé na verzi programu. Proto při aktualizaci programu zůstává konfigurační soubor zachován.  </WRAP>
-===== Informace pro vývojáře =====
-[[http://www.mlab.cz/redmine/projects/rao01a|Bug tracking]]
-[[http://mlab-project.github.io/radio-observer/|GitHub]]
-==== FITS soubory ====
-  * [[http://fits.gsfc.nasa.gov/fits_verify.html|Verifikace FITS souboru]]