summaryrefslogtreecommitdiff
path: root/gr-radio-astronomy/src/python/usrp_psr_receiver.help
blob: 5801f3fbbcd928624f608f3ea7d760e83bff84e4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
This program is used to analyse pulsars of known parameters.  It contains
  both a post-detector spectral display, and a "pulse profile" display.
  It has a built-in de-dispersion filter that will work up to DM=100 for
  21cm observing, and up to DM=5 for 327Mhz observing.

The program takes the following options:

  --rx-subdev-spec     which USRP Rx side?  A or B

  --decim              USRP decimation rate use either 64 or 128

  --freq               USRP daughtercard frequency

  --observing          Actual observing frequency (default is to use the
                       setting for --freq)

  --avg                Averaging setting for spectral display--higher numbers
                       equal more averaging.  25 to 40 is typical.

  --favg               Pulse folding averaging.  2 to 5 is typical.

  --gain               USRP daughtercard gain control

  --reflevel           Reference level on pulse profile display

  --lowest             Lowest spectral bin that is considered valid, in Hz

  --longitude          Observer longitude: West is negative

  --latitude           Observer latitude:  South is negative

  --fft_size           Size of FFT for post-detector spectrum: default is 1024

  --threshold          Threshold (dB) to be considered a spectral "peak"
                       This is relative to the average spectral level

  --lowpass            Low pass frequency for post-detector spectral display
                       20-100 is typical

  --prefix             Filename prefix to use for recording files
                       Default is ./

  --pulsefreq          The frequency of the expected pulses
                       For sentimental reasons, this defaults to 0.748Hz

  --dm                 The DM

  --doppler            The doppler shift, as a ratio

  --divbase            The base of the Y/Div menu in pulsar display

  --division           The initial Y/Div in pulsar display

DM, Doppler, Gain, Frequency, and the averaging parameters can all be
  changed using the GUI at runtime.

If latitude and longitude are set correctly, and the system time is
  correct, then the current LMST is displayed below the frequency
  input, updated once per second.

Moving the mouse in the post-detector spectrum display shows you that
  point in the post-detector spectrum, both frequency and signal level.

The post-detector spectrum is analysed, with results shown below
  "Best freq".  It shows the spectral peaks, and computes their relationship.
  It shows the harmonic compliance among the peaks, as well as the average
  peak-to-peak distance.


Here's a complete example for observing a pulsar with a frequency of
  1.35Hz, at 431.5Mhz, using an IF of 10.7Mhz, and a DM of 12.431, using
  1Mhz observing bandwidth:

./usrp_psr_receiver.py --freq 10.7e6 --decim 64 --dm 12.431 --avg 35 \
  --pulsefreq 1.35 --fft_size 2048 --lowest 1.00 --gain 75 --threshold 11.5 \
  --observing 431.5e6 --reflevel 200 --division 100 --divbase 10 --favg 3 \
  --lowpass 20 --longitude -76.02 --latitude 44.95

Since the observed pulsar is at 1.35Hz, a lowpass cutoff for the
  post-detector spectral display of 20Hz will be adequate.  We
  tell the spectral analyser to use a threshold of 11.5dB above
  average when analysing spectral data, and set the epoch folder
  averager (pulse profile display) to use an average from 3 samples.
  Notice that our actual USRP/Daughtercard frequency is 10.7Mhz, while
  our observing frequency is 431.5Mhz--this is important in order for
  the DM de-dispersion calculations to be correct. We also set our
  latitude and longitude, so that logfiles and the LMST display
  will have the correct LMST in them.

The entire complex baseband can be recorded, if the "Recording baseband"
  button is pressed.  Filenames are generated dynamically, and a header
  file is produced giving observation parameters.  The baseband data are
  recorded as octet pairs: one for I and one for Q.  Pressing the button again
  turns off baseband recording.  This baseband is "raw", so it will
  not have been de-dispersed.  The data rate will be whatever the
  USRP was programmed to at the time (based on --decim).

  The files are:  YYYYMMDDHHMM.pdat  and YYYYMMDDHHMM.phdr

  The .phdr file contains ASCII header information describing the
  contents of the .pdat file.

Similarly the raw, pre-folded, band-limited post-detector "audio" data can be
  recorded using the "Record Pulses" button.  The data rate for these is
  currently 20Khz, recorded as short integers.  Just like baseband recording,
  pressing the button again turns off pulse recording.

  The files are: YYYYMMDDHHMM.padat  and YYMMDDHHMM.pahdr

  The .pahdr file is ascii text providing information about the contents
  of the corresponding .padat file.