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 PySDR, která je naopak určena pro vizualizaci měřených dat.

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

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.

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 je ve formátu 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 příklad souboru v repozitáři radio-observeru.