Minor format and reference fix up

* scale convolutional code figure smaller
* Rename randomizer -> decorrelator
* Add cross references for interleaver and decorrelator tables
* update interleaver QPP equation to be more explicit
* Hopefully fix LFSR figures being split up

docs/conf.py

@@ -140,6 +140,7 @@ latex_documents = [
      latex_author, 'manual'),
 ]
 latex_elements = {
+    'figure_align': 'H',
     'preamble': r'''
 \newcommand{\sphinxlogo}{\sphinxincludegraphics[height=1in]{m17_logo_shadow_400.png}\par}
 \newcommand{\sphinxbackoftitlepage}{Published \today

docs/data_link_layer.rst

@@ -168,7 +168,7 @@ LICH message and understand how to receive the in-progress stream.
      c0[label="conv coder"]
      p0[label="Puncture P1"]
      i0[label="interleave"]
-     w0[label="whitening"]
+     w0[label="decorrelator"]
      s0[label="add sync"]
      chunker_48[label="chunk 48 bits"]
      golay_24_12[label="golay(24, 12)"]
@@ -176,7 +176,7 @@ LICH message and understand how to receive the in-progress stream.
      c1[label="conv coder"]
      p1[label="Puncture P2"]
      i1[label="interleave"]
-     w1[label="whitening"]
+     w1[label="decorrelator"]
      s1[label="add sync"]
      fn[label="Add FN"]
      chunker_128[label="chunk 128 bits"]

docs/decorrelator.rst

@@ -1,7 +1,9 @@
-Data randomizing sequence
-=========================
+Decorrelator sequence
+=====================
 
-.. csv-table:: randomizing sequence
+.. _sec-decorr-seq:
+
+.. csv-table:: Decorrelator scrambling sequence
    :header-rows: 1
 
    Seq. number, Value, Seq. number, Value

docs/index.rst

@@ -15,7 +15,7 @@ Welcome to M17 Protocol Specification's documentation!
    data_link_layer
    application_layer
    address_encoding
-   data_randomizer
+   decorrelator
    interleaving
 
 

docs/interleaving.rst

@@ -1,6 +1,8 @@
 Interleaving
 ============
 
+.. _sec-interleaver:
+
 .. csv-table:: Interleaving table
    :header-rows: 1
 

docs/physical_layer.rst

@@ -161,7 +161,7 @@ The output from the encoder must be read alternately.
           Sub-part A: Common Air Interface
 
 .. figure:: ../images/convolutional.svg
-   :scale: 50%
+   :scale: 30%
 
    Convolutional coder diagram
 
@@ -252,8 +252,8 @@ Interleaving
 ~~~~~~~~~~~~
 
 For interleaving a Quadradic Permutation Polynomial (QPP) is used. The
-polynomial :math:`45x+ 92x^2` is used for a 368 bit interleaving
-pattern [QPP]_. See appendix for example code.
+polynomial :math:`\pi(x)=(45x+92x2)\mod 368` is used for a 368 bit interleaving
+pattern [QPP]_. See appendix :numref:`sec-interleaver` for pattern.
 
 .. [QPP] Trifina, Lucian, Daniela Tarniceriu, and Valeriu
          Munteanu. "Improved QPP Interleavers for LTE Standard." ISSCS
@@ -261,13 +261,13 @@ pattern [QPP]_. See appendix for example code.
          Systems (2011): n. pag. Crossref. Web. https://arxiv.org/abs/1103.3794
 
 
-Data Randomizer
-~~~~~~~~~~~~~~~
+Data Decorrelator
+~~~~~~~~~~~~~~~~~
 
 To avoid transmitting long sequences of constant symbols
 (e.g. 010101…), a simple algorithm is used. All 46
 bytes of type 4 bits shall be XORed with a pseudorandom, predefined
 stream. The same algorithm has to be used for incoming bits at the
-receiver to get the original data stream.
+receiver to get the original data stream. See :numref:`sec-decorr-seq` for sequence.
 
 .. todo:: add diagram