source: ammosreader/doc/html/_modules/PDW.html@ 4125513

AmmosSource guix
Last change on this file since 4125513 was 1e781ba, checked in by recknagel <recknagel@…>, 3 years ago

former radardex-project
  • Property mode set to 100644
File size: 41.1 KB
RevLine 
[1e781ba]1
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
5<html xmlns="http://www.w3.org/1999/xhtml">
6 <head>
7 <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
8 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
9 <title>PDW &#8212; RadarDex 0.314 documentation</title>
10 <link rel="stylesheet" href="../_static/alabaster.css" type="text/css" />
11 <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
12 <script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
13 <script type="text/javascript" src="../_static/jquery.js"></script>
14 <script type="text/javascript" src="../_static/underscore.js"></script>
15 <script type="text/javascript" src="../_static/doctools.js"></script>
16 <script type="text/javascript" src="../_static/language_data.js"></script>
17 <link rel="index" title="Index" href="../genindex.html" />
18 <link rel="search" title="Search" href="../search.html" />
19
20 <link rel="stylesheet" href="../_static/custom.css" type="text/css" />
21
22 <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
23
24 </head><body>
25
26
27 <div class="document">
28 <div class="documentwrapper">
29 <div class="bodywrapper">
30 <div class="body" role="main">
31
32 <h1>Source code for PDW</h1><div class="highlight"><pre>
33<span></span><span class="kn">import</span> <span class="nn">struct</span>
34<span class="kn">import</span> <span class="nn">math</span>
35<span class="kn">import</span> <span class="nn">datetime</span>
36
37<span class="c1"># TODO: Use BitArray module in future versions</span>
38
39
40<div class="viewcode-block" id="PDW"><a class="viewcode-back" href="../PDW.html#PDW.PDW">[docs]</a><span class="k">class</span> <span class="nc">PDW</span><span class="p">():</span>
41
42 <span class="sd">&quot;&quot;&quot;</span>
43
44<span class="sd"> I store information from a single ppdw data block</span>
45
46<span class="sd"> .. automethod:: __init__</span>
47
48<span class="sd"> &quot;&quot;&quot;</span>
49
50<div class="viewcode-block" id="PDW.from_bytes"><a class="viewcode-back" href="../PDW.html#PDW.PDW.from_bytes">[docs]</a> <span class="nd">@classmethod</span>
51 <span class="k">def</span> <span class="nf">from_bytes</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">byte_string</span><span class="p">):</span>
52
53 <span class="sd">&quot;&quot;&quot;</span>
54
55<span class="sd"> I create an instance of class PDW from data body (8 * 32 bits)</span>
56
57<span class="sd"> :param byte_string: a byte string containing a single data body read from a ppdw file</span>
58<span class="sd"> :type byte_string: byte string</span>
59
60<span class="sd"> :return: an instance of class PDW with attributes set according to the data of a data body</span>
61<span class="sd"> :rtype: PDW</span>
62
63<span class="sd"> &quot;&quot;&quot;</span>
64
65 <span class="k">assert</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">byte_string</span><span class="p">)</span> <span class="o">==</span> <span class="mi">32</span><span class="p">)</span>
66
67 <span class="n">parts</span> <span class="o">=</span> <span class="n">struct</span><span class="o">.</span><span class="n">unpack</span><span class="p">(</span><span class="s1">&#39;Q4s4s4s4s4s4s&#39;</span><span class="p">,</span> <span class="n">byte_string</span><span class="p">)</span>
68 <span class="n">seconds</span> <span class="o">=</span> <span class="p">(</span><span class="n">parts</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
69 <span class="n">time_of_arrival</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">datetime</span><span class="o">.</span><span class="n">utcfromtimestamp</span><span class="p">(</span><span class="n">seconds</span> <span class="o">/</span> <span class="mi">1000000000</span><span class="p">)</span>
70
71 <span class="n">third_entry</span> <span class="o">=</span> <span class="nb">bin</span><span class="p">(</span><span class="nb">int</span><span class="o">.</span><span class="n">from_bytes</span><span class="p">(</span><span class="n">parts</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">byteorder</span><span class="o">=</span><span class="s1">&#39;little&#39;</span><span class="p">))</span>
72 <span class="n">padding</span> <span class="o">=</span> <span class="mi">32</span><span class="o">-</span><span class="nb">len</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">third_entry</span><span class="p">)[</span><span class="mi">2</span><span class="p">:])</span>
73 <span class="n">third_entry_bit_string</span> <span class="o">=</span> <span class="s2">&quot;0&quot;</span> <span class="o">*</span> <span class="n">padding</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="n">third_entry</span><span class="p">)[</span><span class="mi">2</span><span class="p">:]</span>
74 <span class="n">pdw_format_identifier</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">third_entry_bit_string</span><span class="p">[</span><span class="mi">0</span><span class="p">:</span><span class="mi">6</span><span class="p">],</span> <span class="mi">2</span><span class="p">)</span>
75 <span class="n">center_frequency</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">third_entry_bit_string</span><span class="p">[</span><span class="mi">5</span><span class="p">:</span><span class="mi">32</span><span class="p">],</span> <span class="mi">2</span><span class="p">)</span>
76
77 <span class="n">fourth_entry</span> <span class="o">=</span> <span class="nb">bin</span><span class="p">(</span><span class="nb">int</span><span class="o">.</span><span class="n">from_bytes</span><span class="p">(</span><span class="n">parts</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span> <span class="n">byteorder</span><span class="o">=</span><span class="s1">&#39;little&#39;</span><span class="p">))</span>
78 <span class="n">padding</span> <span class="o">=</span> <span class="mi">32</span><span class="o">-</span><span class="nb">len</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">fourth_entry</span><span class="p">)[</span><span class="mi">2</span><span class="p">:])</span>
79 <span class="n">fourth_entry_bit_string</span> <span class="o">=</span> <span class="s2">&quot;0&quot;</span> <span class="o">*</span> <span class="n">padding</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="n">fourth_entry</span><span class="p">)[</span><span class="mi">2</span><span class="p">:]</span>
80 <span class="n">is_valid</span> <span class="o">=</span> <span class="nb">bool</span><span class="p">(</span><span class="nb">int</span><span class="p">(</span><span class="n">fourth_entry_bit_string</span><span class="p">[</span><span class="mi">0</span><span class="p">]))</span>
81 <span class="n">is_pulse</span> <span class="o">=</span> <span class="nb">bool</span><span class="p">(</span><span class="nb">int</span><span class="p">(</span><span class="n">fourth_entry_bit_string</span><span class="p">[</span><span class="mi">1</span><span class="p">]))</span>
82 <span class="n">level_unit</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">fourth_entry_bit_string</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>
83 <span class="n">signal_start_missing</span> <span class="o">=</span> <span class="nb">bool</span><span class="p">(</span><span class="nb">int</span><span class="p">(</span><span class="n">fourth_entry_bit_string</span><span class="p">[</span><span class="mi">3</span><span class="p">]))</span>
84 <span class="n">signal_end_missing</span> <span class="o">=</span> <span class="nb">bool</span><span class="p">(</span><span class="nb">int</span><span class="p">(</span><span class="n">fourth_entry_bit_string</span><span class="p">[</span><span class="mi">4</span><span class="p">]))</span>
85 <span class="n">pulse_width</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">fourth_entry_bit_string</span><span class="p">[</span><span class="mi">7</span><span class="p">:</span><span class="mi">33</span><span class="p">],</span> <span class="mi">2</span><span class="p">)</span>
86
87 <span class="n">fifth_entry</span> <span class="o">=</span> <span class="nb">bin</span><span class="p">(</span><span class="nb">int</span><span class="o">.</span><span class="n">from_bytes</span><span class="p">(</span><span class="n">parts</span><span class="p">[</span><span class="mi">3</span><span class="p">],</span> <span class="n">byteorder</span><span class="o">=</span><span class="s1">&#39;little&#39;</span><span class="p">))</span>
88 <span class="n">padding</span> <span class="o">=</span> <span class="mi">32</span><span class="o">-</span><span class="nb">len</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">fifth_entry</span><span class="p">)[</span><span class="mi">2</span><span class="p">:])</span>
89 <span class="n">fifth_entry_bit_string</span> <span class="o">=</span> <span class="s2">&quot;0&quot;</span> <span class="o">*</span> <span class="n">padding</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="n">fifth_entry</span><span class="p">)[</span><span class="mi">2</span><span class="p">:]</span>
90 <span class="n">frequency_shift_or_bandwidth</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">fifth_entry_bit_string</span><span class="p">[</span><span class="mi">0</span><span class="p">:</span><span class="mi">20</span><span class="p">],</span> <span class="mi">2</span><span class="p">)</span>
91 <span class="c1"># FIXME: You have to scale me to the range from -200.0 to 200.0 in 0.1 steps</span>
92 <span class="n">pulse_level_or_pulse_field_strength</span> <span class="o">=</span> <span class="n">math</span><span class="o">.</span><span class="n">ceil</span><span class="p">(</span><span class="nb">int</span><span class="p">(</span><span class="n">fifth_entry_bit_string</span><span class="p">[</span><span class="mi">20</span><span class="p">:</span><span class="mi">32</span><span class="p">],</span> <span class="mi">2</span><span class="p">))</span> <span class="o">/</span> <span class="mi">10</span>
93
94 <span class="n">sixth_entry</span> <span class="o">=</span> <span class="nb">bin</span><span class="p">(</span><span class="nb">int</span><span class="o">.</span><span class="n">from_bytes</span><span class="p">(</span><span class="n">parts</span><span class="p">[</span><span class="mi">4</span><span class="p">],</span> <span class="n">byteorder</span><span class="o">=</span><span class="s1">&#39;little&#39;</span><span class="p">))</span>
95 <span class="n">padding</span> <span class="o">=</span> <span class="mi">32</span><span class="o">-</span><span class="nb">len</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">sixth_entry</span><span class="p">)[</span><span class="mi">2</span><span class="p">:])</span>
96 <span class="n">sixth_entry_bit_string</span> <span class="o">=</span> <span class="s2">&quot;0&quot;</span> <span class="o">*</span> <span class="n">padding</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="n">sixth_entry</span><span class="p">)[</span><span class="mi">2</span><span class="p">:]</span>
97 <span class="n">region_of_interest</span> <span class="o">=</span> <span class="nb">bool</span><span class="p">(</span><span class="nb">int</span><span class="p">(</span><span class="n">sixth_entry_bit_string</span><span class="p">[</span><span class="mi">0</span><span class="p">]))</span>
98 <span class="c1"># FIXME: You have to scale me to a range from 0.0 to 6.2 in steps of 0.1 - 6.3 means unknown</span>
99 <span class="n">azimuth_confidence</span> <span class="o">=</span> <span class="n">math</span><span class="o">.</span><span class="n">ceil</span><span class="p">(</span><span class="nb">int</span><span class="p">(</span><span class="n">sixth_entry_bit_string</span><span class="p">[</span><span class="mi">1</span><span class="p">:</span><span class="mi">7</span><span class="p">],</span> <span class="mi">2</span><span class="p">))</span> <span class="o">/</span> <span class="mi">10</span>
100 <span class="n">modulations</span> <span class="o">=</span> <span class="p">{</span><span class="mi">0</span><span class="p">:</span> <span class="s1">&#39;Unknown&#39;</span><span class="p">,</span> <span class="mi">1</span><span class="p">:</span> <span class="s1">&#39;Unmodulated&#39;</span><span class="p">,</span> <span class="mi">2</span><span class="p">:</span> <span class="s1">&#39;FM&#39;</span><span class="p">,</span> <span class="mi">3</span><span class="p">:</span> <span class="s1">&#39;LFM&#39;</span><span class="p">,</span> <span class="mi">4</span><span class="p">:</span> <span class="s1">&#39;PSK-2&#39;</span><span class="p">,</span> <span class="mi">5</span><span class="p">:</span> <span class="s1">&#39;PSK-3&#39;</span><span class="p">,</span> <span class="mi">6</span><span class="p">:</span> <span class="s1">&#39;PSK-4&#39;</span><span class="p">,</span>
101 <span class="mi">7</span><span class="p">:</span> <span class="s1">&#39;PSK-m&#39;</span><span class="p">,</span> <span class="mi">8</span><span class="p">:</span> <span class="s1">&#39;NLFM&#39;</span><span class="p">,</span> <span class="mi">9</span><span class="p">:</span> <span class="s1">&#39;SFM&#39;</span><span class="p">,</span> <span class="mi">10</span><span class="p">:</span> <span class="s1">&#39;TFM&#39;</span><span class="p">,</span> <span class="mi">11</span><span class="p">:</span> <span class="s1">&#39;Pulse too short&#39;</span><span class="p">}</span>
102 <span class="n">modulation</span> <span class="o">=</span> <span class="n">modulations</span><span class="p">[</span><span class="nb">int</span><span class="p">(</span><span class="n">sixth_entry_bit_string</span><span class="p">[</span><span class="mi">7</span><span class="p">:</span><span class="mi">12</span><span class="p">],</span> <span class="mi">2</span><span class="p">)]</span>
103 <span class="n">sector</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">sixth_entry_bit_string</span><span class="p">[</span><span class="mi">28</span><span class="p">:</span><span class="mi">32</span><span class="p">],</span> <span class="mi">2</span><span class="p">)</span>
104
105 <span class="n">seventh_entry</span> <span class="o">=</span> <span class="nb">bin</span><span class="p">(</span><span class="nb">int</span><span class="o">.</span><span class="n">from_bytes</span><span class="p">(</span><span class="n">parts</span><span class="p">[</span><span class="mi">5</span><span class="p">],</span> <span class="n">byteorder</span><span class="o">=</span><span class="s1">&#39;little&#39;</span><span class="p">))</span>
106 <span class="n">padding</span> <span class="o">=</span> <span class="mi">32</span><span class="o">-</span><span class="nb">len</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">seventh_entry</span><span class="p">)[</span><span class="mi">2</span><span class="p">:])</span>
107 <span class="n">seventh_entry_bit_string</span> <span class="o">=</span> <span class="s2">&quot;0&quot;</span> <span class="o">*</span> <span class="n">padding</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="n">seventh_entry</span><span class="p">)[</span><span class="mi">2</span><span class="p">:]</span>
108 <span class="n">polarities</span> <span class="o">=</span> <span class="p">{</span><span class="mi">0</span><span class="p">:</span> <span class="s1">&#39;Horizontal/Unknown&#39;</span><span class="p">,</span> <span class="mi">1</span><span class="p">:</span> <span class="s1">&#39;Vertical&#39;</span><span class="p">,</span> <span class="mi">2</span><span class="p">:</span> <span class="s1">&#39;Counter clockwise&#39;</span><span class="p">,</span> <span class="mi">3</span><span class="p">:</span> <span class="s1">&#39;Clockwise&#39;</span><span class="p">}</span>
109 <span class="n">polarity</span> <span class="o">=</span> <span class="n">polarities</span><span class="p">[</span><span class="nb">int</span><span class="p">(</span><span class="n">seventh_entry_bit_string</span><span class="p">[</span><span class="mi">0</span><span class="p">:</span><span class="mi">2</span><span class="p">],</span> <span class="mi">2</span><span class="p">)]</span>
110 <span class="n">df_quality</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">seventh_entry_bit_string</span><span class="p">[</span><span class="mi">2</span><span class="p">:</span><span class="mi">9</span><span class="p">],</span> <span class="mi">2</span><span class="p">)</span>
111 <span class="c1"># FIXME: You have to scale me from -90 to 90 in 0.1 degree steps</span>
112 <span class="n">elevation</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">seventh_entry_bit_string</span><span class="p">[</span><span class="mi">9</span><span class="p">:</span><span class="mi">20</span><span class="p">],</span> <span class="mi">2</span><span class="p">)</span>
113 <span class="c1"># FIXME: You have to check me for a range from 0.0 to 359.9 in steps of 0.1</span>
114 <span class="n">azimuth</span> <span class="o">=</span> <span class="mf">0.1</span> <span class="o">*</span> <span class="p">(</span><span class="nb">int</span><span class="p">(</span><span class="n">seventh_entry_bit_string</span><span class="p">[</span><span class="mi">20</span><span class="p">:</span><span class="mi">32</span><span class="p">],</span> <span class="mi">2</span><span class="p">))</span>
115
116 <span class="n">eighth_entry</span> <span class="o">=</span> <span class="nb">bin</span><span class="p">(</span><span class="nb">int</span><span class="o">.</span><span class="n">from_bytes</span><span class="p">(</span><span class="n">parts</span><span class="p">[</span><span class="mi">5</span><span class="p">],</span> <span class="n">byteorder</span><span class="o">=</span><span class="s1">&#39;little&#39;</span><span class="p">))</span>
117 <span class="n">padding</span> <span class="o">=</span> <span class="mi">32</span><span class="o">-</span><span class="nb">len</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">eighth_entry</span><span class="p">)[</span><span class="mi">2</span><span class="p">:])</span>
118 <span class="n">eighth_entry_bit_string</span> <span class="o">=</span> <span class="s2">&quot;0&quot;</span> <span class="o">*</span> <span class="n">padding</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="n">eighth_entry</span><span class="p">)[</span><span class="mi">2</span><span class="p">:]</span>
119 <span class="n">channel</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">eighth_entry_bit_string</span><span class="p">[</span><span class="mi">0</span><span class="p">:</span><span class="mi">4</span><span class="p">],</span> <span class="mi">2</span><span class="p">)</span>
120
121 <span class="k">return</span> <span class="n">PDW</span><span class="p">(</span><span class="n">time_of_arrival</span><span class="p">,</span> <span class="n">pdw_format_identifier</span><span class="p">,</span> <span class="n">center_frequency</span><span class="p">,</span> <span class="n">is_valid</span><span class="p">,</span> <span class="n">is_pulse</span><span class="p">,</span> <span class="n">level_unit</span><span class="p">,</span>
122 <span class="n">signal_start_missing</span><span class="p">,</span> <span class="n">signal_end_missing</span><span class="p">,</span> <span class="n">pulse_width</span><span class="p">,</span> <span class="n">frequency_shift_or_bandwidth</span><span class="p">,</span>
123 <span class="n">pulse_level_or_pulse_field_strength</span><span class="p">,</span> <span class="n">region_of_interest</span><span class="p">,</span> <span class="n">azimuth_confidence</span><span class="p">,</span> <span class="n">modulation</span><span class="p">,</span>
124 <span class="n">sector</span><span class="p">,</span> <span class="n">polarity</span><span class="p">,</span> <span class="n">df_quality</span><span class="p">,</span> <span class="n">elevation</span><span class="p">,</span> <span class="n">azimuth</span><span class="p">,</span> <span class="n">channel</span><span class="p">)</span></div>
125
126<div class="viewcode-block" id="PDW.__init__"><a class="viewcode-back" href="../PDW.html#PDW.PDW.__init__">[docs]</a> <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">time_of_arrival</span><span class="p">,</span> <span class="n">pdw_format_identifier</span><span class="p">,</span> <span class="n">center_frequency</span><span class="p">,</span> <span class="n">is_valid</span><span class="p">,</span> <span class="n">is_pulse</span><span class="p">,</span>
127 <span class="n">level_unit</span><span class="p">,</span> <span class="n">signal_start_missing</span><span class="p">,</span> <span class="n">signal_end_missing</span><span class="p">,</span> <span class="n">pulse_width</span><span class="p">,</span> <span class="n">frequency_shift_or_bandwidth</span><span class="p">,</span>
128 <span class="n">pulse_level_or_pulse_field_strength</span><span class="p">,</span> <span class="n">region_of_interest</span><span class="p">,</span> <span class="n">azimuth_confidence</span><span class="p">,</span> <span class="n">modulation</span><span class="p">,</span>
129 <span class="n">sector</span><span class="p">,</span> <span class="n">polarity</span><span class="p">,</span> <span class="n">df_quality</span><span class="p">,</span> <span class="n">elevation</span><span class="p">,</span> <span class="n">azimuth</span><span class="p">,</span> <span class="n">channel</span><span class="p">):</span>
130
131 <span class="sd">&quot;&quot;&quot;</span>
132
133<span class="sd"> :param time_of_arrival: nanoseconds since 1970-01-01 00:00:00</span>
134<span class="sd"> :type time_of_arrival: Integer</span>
135<span class="sd"> :param pdw_format: format code</span>
136<span class="sd"> :type pdw_format: Integer</span>
137<span class="sd"> :param center_frequency: center frequency in KHz</span>
138<span class="sd"> :type center_frequency: Integer</span>
139<span class="sd"> :param is_valid: flag to mark if pdw data body is valid</span>
140<span class="sd"> :type is_valid: Boolean</span>
141<span class="sd"> :param is_pulse: flag to mark if pdw data body contains a pulse or a continuous wave signal</span>
142<span class="sd"> :type is_pulse: Boolean</span>
143<span class="sd"> :param level_unit: 0 means dBµV - 1 means dBµV/m</span>
144<span class="sd"> :type level_unit: Integer</span>
145<span class="sd"> :param signal_start_missing: signal started before time of arrival</span>
146<span class="sd"> :type signal_start_missing: Boolean</span>
147<span class="sd"> :param signal_end_missing: signal stops after time of arrival</span>
148<span class="sd"> :type signal_end_missing: Boolean</span>
149<span class="sd"> :param pulse_width: pulse width in nanoseconds - Zero if no valid pulse detected</span>
150<span class="sd"> :type pulse_width: Integer</span>
151<span class="sd"> :param frequency_shift_or_bandwidth: Value in KHz - Value set to 1048575 means Unknown</span>
152<span class="sd"> :type frequency_shift_or_bandwidth: Integer</span>
153<span class="sd"> :param pulse_level_or_pulse_field_strength: Pulse level or Pulse Field Strength depending on level_unit \</span>
154<span class="sd"> (-200.0...200.0) in 0.1 steps / minus 204.8 means no valid level detected</span>
155<span class="sd"> :type pulse_level_or_pulse_field_strength: Float</span>
156<span class="sd"> :param region_of_interest: Marks if signal is from region of interest</span>
157<span class="sd"> :type region_of_interest: Boolean</span>
158<span class="sd"> :param azimuth_confidence: degree in steps of 0.1 (0.0-6.2) / 6.3 means confidence unknown</span>
159<span class="sd"> :type azimuth_confidence: Float</span>
160<span class="sd"> :param modulation: type of modulation (e.g. PSK-2, PSK-4, FM etc.)</span>
161<span class="sd"> :type modulation: String</span>
162<span class="sd"> :param sector: reference antenna sector (0-15)</span>
163<span class="sd"> :type sector: Integer</span>
164<span class="sd"> :param polarity: Horizontal, Vertical, Clockwise, Counter clockwise</span>
165<span class="sd"> :type polarity: String</span>
166<span class="sd"> :param df_quality: Direction finding quality in percent (0-100) - Zero means unknown</span>
167<span class="sd"> :type df_quality: Integer</span>
168<span class="sd"> :param elevation: elevation of incoming signal (from -90 to 90 degree) in steps of 0.1 degree \</span>
169<span class="sd"> minus 102.4 means unknown</span>
170<span class="sd"> :type elevation: Float</span>
171<span class="sd"> :param azimuth: azimuth of incoming signal (from 0 to 359.9 degree) in steps of 0.1 degree \</span>
172<span class="sd"> plus 409.5 means unknown</span>
173<span class="sd"> :type azimuth: Float</span>
174<span class="sd"> :param channel: detecting channel (0-16) - Zero means unknown</span>
175<span class="sd"> :type channel: Integer</span>
176<span class="sd"> :return: An instance of class PDW with attributes set according to the data of a data body</span>
177<span class="sd"> :rtype: PDW</span>
178
179<span class="sd"> &quot;&quot;&quot;</span>
180
181 <span class="bp">self</span><span class="o">.</span><span class="n">time_of_arrival</span> <span class="o">=</span> <span class="n">time_of_arrival</span>
182 <span class="bp">self</span><span class="o">.</span><span class="n">pdw_format_identifier</span> <span class="o">=</span> <span class="n">pdw_format_identifier</span>
183 <span class="bp">self</span><span class="o">.</span><span class="n">center_frequency</span> <span class="o">=</span> <span class="n">center_frequency</span>
184 <span class="bp">self</span><span class="o">.</span><span class="n">is_valid</span> <span class="o">=</span> <span class="n">is_valid</span>
185 <span class="bp">self</span><span class="o">.</span><span class="n">is_pulse</span> <span class="o">=</span> <span class="n">is_pulse</span>
186 <span class="bp">self</span><span class="o">.</span><span class="n">level_unit</span> <span class="o">=</span> <span class="n">level_unit</span>
187 <span class="bp">self</span><span class="o">.</span><span class="n">signal_start_missing</span> <span class="o">=</span> <span class="n">signal_start_missing</span>
188 <span class="bp">self</span><span class="o">.</span><span class="n">signal_end_missing</span> <span class="o">=</span> <span class="n">signal_end_missing</span>
189 <span class="bp">self</span><span class="o">.</span><span class="n">pulse_width</span> <span class="o">=</span> <span class="n">pulse_width</span>
190 <span class="bp">self</span><span class="o">.</span><span class="n">frequency_shift_or_bandwidth</span> <span class="o">=</span> <span class="n">frequency_shift_or_bandwidth</span>
191 <span class="bp">self</span><span class="o">.</span><span class="n">pulse_level_or_pulse_field_strength</span> <span class="o">=</span> <span class="n">pulse_level_or_pulse_field_strength</span>
192 <span class="bp">self</span><span class="o">.</span><span class="n">region_of_interest</span> <span class="o">=</span> <span class="n">region_of_interest</span>
193 <span class="bp">self</span><span class="o">.</span><span class="n">azimuth_confidence</span> <span class="o">=</span> <span class="n">azimuth_confidence</span>
194 <span class="bp">self</span><span class="o">.</span><span class="n">modulation</span> <span class="o">=</span> <span class="n">modulation</span>
195 <span class="bp">self</span><span class="o">.</span><span class="n">sector</span> <span class="o">=</span> <span class="n">sector</span>
196 <span class="bp">self</span><span class="o">.</span><span class="n">polarity</span> <span class="o">=</span> <span class="n">polarity</span>
197 <span class="bp">self</span><span class="o">.</span><span class="n">df_quality</span> <span class="o">=</span> <span class="n">df_quality</span>
198 <span class="bp">self</span><span class="o">.</span><span class="n">elevation</span> <span class="o">=</span> <span class="n">elevation</span>
199 <span class="bp">self</span><span class="o">.</span><span class="n">azimuth</span> <span class="o">=</span> <span class="n">azimuth</span>
200 <span class="bp">self</span><span class="o">.</span><span class="n">channel</span> <span class="o">=</span> <span class="n">channel</span></div>
201
202 <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
203 <span class="n">output</span> <span class="o">=</span> <span class="p">(</span><span class="s2">&quot;Time of arrival: &quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">time_of_arrival</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span> <span class="o">+</span>
204 <span class="s2">&quot;PDW Format identifier: &quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">pdw_format_identifier</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span> <span class="o">+</span>
205 <span class="s2">&quot;Center frequency: &quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">center_frequency</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot; KHz</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
206
207 <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_valid</span><span class="p">:</span>
208 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;Signal: Valid</span><span class="se">\n</span><span class="s2">&quot;</span>
209 <span class="k">else</span><span class="p">:</span>
210 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;Signal: Invalid</span><span class="se">\n</span><span class="s2">&quot;</span>
211
212 <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_pulse</span><span class="p">:</span>
213 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;Signal type: Pulse</span><span class="se">\n</span><span class="s2">&quot;</span>
214 <span class="k">else</span><span class="p">:</span>
215 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;Signal type: Continuous wave</span><span class="se">\n</span><span class="s2">&quot;</span>
216
217 <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">level_unit</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
218 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;Pulse level: &quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">pulse_level_or_pulse_field_strength</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot; dbµV</span><span class="se">\n</span><span class="s2">&quot;</span>
219 <span class="k">else</span><span class="p">:</span>
220 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;Pulse field strength: &quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">pulse_level_or_pulse_field_strength</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot; dbµV/meter</span><span class="se">\n</span><span class="s2">&quot;</span>
221
222 <span class="n">output</span> <span class="o">+=</span> <span class="p">(</span><span class="s2">&quot;Pulse width: &quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">pulse_width</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot; nanoseconds</span><span class="se">\n</span><span class="s2">&quot;</span> <span class="o">+</span>
223 <span class="s2">&quot;Frequency shift or bandwidth: &quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">frequency_shift_or_bandwidth</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot; KHz</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
224
225 <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">region_of_interest</span><span class="p">:</span>
226 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;Region of interest: Yes</span><span class="se">\n</span><span class="s2">&quot;</span>
227 <span class="k">else</span><span class="p">:</span>
228 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;Region of interest: No</span><span class="se">\n</span><span class="s2">&quot;</span>
229
230 <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">azimuth_confidence</span> <span class="o">==</span> <span class="mf">6.3</span><span class="p">:</span>
231 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;Azimuth confidence: Invalid</span><span class="se">\n</span><span class="s2">&quot;</span>
232 <span class="k">else</span><span class="p">:</span>
233 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;Azimuth confidence: &quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">azimuth_confidence</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot; degree</span><span class="se">\n</span><span class="s2">&quot;</span>
234
235 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;Modulation: &quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">modulation</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span>
236
237 <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">sector</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
238 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;Sector: Unknown</span><span class="se">\n</span><span class="s2">&quot;</span>
239 <span class="k">else</span><span class="p">:</span>
240 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;Sector:&quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">sector</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span>
241
242 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;Polarity: &quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">polarity</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span>
243
244 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;DF quality: &quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">df_quality</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot; %</span><span class="se">\n</span><span class="s2">&quot;</span>
245
246 <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">elevation</span> <span class="o">==</span> <span class="mi">1024</span><span class="p">:</span>
247 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;Elevation: Unknown</span><span class="se">\n</span><span class="s2">&quot;</span>
248 <span class="k">else</span><span class="p">:</span>
249 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;Elevation: &quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">elevation</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot; degree</span><span class="se">\n</span><span class="s2">&quot;</span>
250
251 <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">azimuth</span> <span class="o">==</span> <span class="mf">409.5</span><span class="p">:</span>
252 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;Azimuth: Unknown</span><span class="se">\n</span><span class="s2">&quot;</span>
253 <span class="k">else</span><span class="p">:</span>
254 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;Azimuth: &quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">azimuth</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot; degree</span><span class="se">\n</span><span class="s2">&quot;</span>
255
256 <span class="n">output</span> <span class="o">+=</span> <span class="s2">&quot;Channel: &quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">channel</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span>
257
258 <span class="k">return</span> <span class="n">output</span></div>
259
260
261<span class="k">if</span> <span class="vm">__name__</span> <span class="o">==</span> <span class="s1">&#39;__main__&#39;</span><span class="p">:</span>
262 <span class="k">pass</span>
263</pre></div>
264
265 </div>
266 </div>
267 </div>
268 <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
269 <div class="sphinxsidebarwrapper">
270<h1 class="logo"><a href="../index.html">RadarDex</a></h1>
271
272
273
274
275
276
277
278
279<h3>Navigation</h3>
280<ul>
281<li class="toctree-l1"><a class="reference internal" href="../PDW.html">PDW module</a></li>
282</ul>
283
284<div class="relations">
285<h3>Related Topics</h3>
286<ul>
287 <li><a href="../index.html">Documentation overview</a><ul>
288 <li><a href="index.html">Module code</a><ul>
289 </ul></li>
290 </ul></li>
291</ul>
292</div>
293<div id="searchbox" style="display: none" role="search">
294 <h3>Quick search</h3>
295 <div class="searchformwrapper">
296 <form class="search" action="../search.html" method="get">
297 <input type="text" name="q" />
298 <input type="submit" value="Go" />
299 <input type="hidden" name="check_keywords" value="yes" />
300 <input type="hidden" name="area" value="default" />
301 </form>
302 </div>
303</div>
304<script type="text/javascript">$('#searchbox').show(0);</script>
305 </div>
306 </div>
307 <div class="clearer"></div>
308 </div>
309 <div class="footer">
310 &copy;2020, Enrico Schwass.
311
312 |
313 Powered by <a href="http://sphinx-doc.org/">Sphinx 1.8.5</a>
314 &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.8</a>
315
316 </div>
317
318
319
320
321 </body>
322</html>
Note: See TracBrowser for help on using the repository browser.