Bolidozor wiki

Máte načtenou starší verzi dokumentu! Pokud ji uložíte, vytvoříte tím novou aktuální verzi.

====== 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. Program běží na detekčních stanicích a zpracováním signálu z přijímače detekuje zajímavé události, například meteory.

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.

===== PySDR a radio-observer =====

Cílem projektu je vytvořit soustavu nástrojů pro radioastronomická pozorování na vzdálených stanicích. Důvody k tomu jsou:

* Stanice se vyskytují obvykle jinde, než pozorovatelé
  * 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.

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

===== Ovládání radio-observeru =====

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

==== Parametry v příkazové řádce ====

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.

* **-c CONFIG_FILE**
  * **-v** - výpis verze

==== Konfigurační soubor ====

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/radio-observer.json|příklad souboru]] v repozitáři radio-observeru.

Vyplňte, prosím, všechna písmena v poli, abyste dokázali, že nejste robot. S L L G U 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