no way to compare when less than two revisions

Differences

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

@@ 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)//
+====== Radioastronomical observation software radio-observer ======
+Radio-observer is a relatively universal radioastronomical software that is intended to detect anomalous / interesting events in a radio data flow. In case of Bolidozor these are mainly radio bolides.
+**Radio-observer does not have any interactive graphical output**.
+In principle, it should work as an application complementary to [[en:pysdr|PySDR]], which is intended to visualise measured data, including events detected by radio-observer. PySRD receives data via [[http://en.wikipedia.org/wiki/Musical_Instrument_Digital_Interface|MIDI]].
+For a more detailed technical description of the software, see [[http://wiki.mlab.cz/doku.php?id=cs:radio-observer|wiki MLAB]].
+===== Radio-observer controll =====
+Majority of radio-observer’s parameters is defined in a configuration file in JSON format. The config file is expected in //~/.radio-observer.json// or it can be specified when starting the software by **-c CONFIG_FILE** parameter.
+==== Command line parameters ====
+The radio-observer has minimum configurable parameters from a command line. The most important is the config file chosen for a detection.
+  * **-c CONFIG_FILE**
+  * **-v** - version
+==== Config file ====
+The configuration file is in [[http://en.wikipedia.org/wiki/JavaScript_Object_Notation|JSON]] format, which has an extended option to use commentaries beginning with %%//%% sign.
+What follows is an example of the file’s format.
+  {
+  	"jack_left_port":  "system:capture_1",   // a name of a JACK port that the radio-observer connects to
+  	"jack_right_port": "system:capture_2",
+  	"configuration": "default",     // a name of a configuration that will be used when starting the programme
+  	"configurations": [
+  		{
+  			"key":     "default",   // configuration identificator
+  			"factory": "pipeline",
+  			"children": [
+  				{
+  					"key":     "backend",
+  					"factory": "waterfall",
+  					"bins":    32768,   // a number of FFT bins
+  					"overlap": 24576,   // FFT bins overlap
+  					"origin": "TEST-R0", // station’s name
+  					"iq_gain":        0,
+  					"iq_phase_shift": 0,
+  					"children": [
+  						{
+  							"key":     "recorder",
+  							"factory": "snapshot",
+  						    	"output_dir": "~/Bolidozor/TEST-R0/snapshots",   // directory for snapshots
+  							"output_type": "snap", // a displayed file type in the file’s name
+  							"snapshot_length": 60,   // a spectrum snapshot’s length in seconds
+  							"low_freq":      10100,  // lower frequency limit of the recorded spectrum
+  							"hi_freq":       11000,  // upper frequency limit of the recorded spectrum
+  						},
+  						{
+  							"key":     "recorder",
+  							"factory": "met",      // a displayed type of file with previews of detected meteors in the file’s name (?? zobrazovany typ souboru s nahledy detekovanych meteoru ve jmenu souboru)
+  						    	"output_dir": "~/Bolidozor/TEST-R0/meteors",   // directory for saving detected meteors
+  							"output_type": "met",   // a displayed type of file with metadata in the file’s name
+  							"metadata_path": "~/Bolidozor/TEST-R0/data", // directory for saving metadata
+                            				"advance_time":     12,   // a time in seconds that will be recored in the record before and after meteor detection (??.který bude sloučen do jednoho záznamu.)
+                            				"jitter_time":      1,   // a maximum interval in seconds between two detections - more meteors within this interval will be considered as one
+  							"low_detect_freq": 10500,  // lower frequency where meteors will be detected
+  							"hi_detect_freq":  10700,  // upper frequency where meteors will be detected
+  							"low_noise_freq":  11000,  // lower frequency limit for calculation of noise intensity
+  							"hi_noise_freq":    11500, // upper frequency limit for calculation of noise intensity
+  						},
+  					],
+  				},
+  			],
+  		},
+  	],
+  }
+The commentaries written in the file have only documentary character. For your own config file please use an [[https://github.com/MLAB-project/radio-observer/blob/dev/Bolidozor.json|example]] in radio-observer repository, which does not include the commentaries.
+Every stations has its own specific config file that should be kept during the lifetime of the station. When changing a config file, in fact, a new station is created - e.g. OBSUPICE-R2 station will change to OBSUPICE-R3 station after changing its configuration file, etc.
+<WRAP info> Radio-oserver is designed in such way that its config files are not dependent on programme version. Therefore, upon programme update, the config file is retained. </WRAP>