Documentation

Signals.IQ

The sideband sign used by a receiver's carrier mixer.

Instances For
    @[instance_reducible]
    @[instance_reducible]
    Instances For

      The orientation of the quadrature channel relative to the in-phase channel.

      Instances For

        A receiver convention for carrier, quadrature, and principal-phase choices.

        Instances For

          The standard positive-carrier, positive-quadrature convention.

          Instances For

            One pair of in-phase and quadrature samples from a coherent receiver.

            • inPhase : ℝ
            • quadrature : ℝ
            Instances For
              def Signals.IQ.Convention.orient (convention : Convention) (sample : Sample) :

              Apply the selected quadrature orientation to a sample.

              Instances For

                Embed an I/Q sample in the complex baseband plane.

                Instances For
                  noncomputable def Signals.IQ.Sample.magnitude (sample : Sample) :
                  ℝ

                  The envelope magnitude of an I/Q sample.

                  Instances For
                    noncomputable def Signals.IQ.Sample.phase (sample : Sample) :
                    ℝ

                    The principal phase represented by an I/Q sample.

                    Instances For
                      @[simp]
                      theorem Signals.IQ.Sample.asComplex_re (sample : Sample) :
                      sample.asComplex.re = sample.inPhase

                      The real projection of the complex I/Q representation is the I sample.

                      @[simp]
                      theorem Signals.IQ.Sample.asComplex_im (sample : Sample) :
                      sample.asComplex.im = sample.quadrature

                      The imaginary projection of the complex I/Q representation is the Q sample.

                      theorem Signals.IQ.Sample.normSq_eq (sample : Sample) :
                      Complex.normSq sample.asComplex = sample.inPhase * sample.inPhase + sample.quadrature * sample.quadrature

                      The squared envelope is the sum of the squared I and Q components.

                      theorem Signals.IQ.Sample.normSq_nonneg (sample : Sample) :
                      0 ≤ Complex.normSq sample.asComplex

                      The squared envelope of an I/Q sample is nonnegative.

                      theorem Signals.IQ.Sample.zero_magnitude_iff (sample : Sample) :
                      sample.magnitude = 0 ↔ sample.inPhase = 0 ∧ sample.quadrature = 0

                      An I/Q sample has zero envelope exactly when both channels are zero.

                      theorem Signals.IQ.Convention.orient_magnitude (convention : Convention) (sample : Sample) :
                      (convention.orient sample).magnitude = sample.magnitude

                      Reversing the quadrature sign preserves the I/Q envelope.

                      theorem Signals.IQ.Sample.phase_mem_principal_range (sample : Sample) :
                      sample.phase ∈ Set.Ioc (-Real.pi) Real.pi

                      The complex principal phase uses the half-open interval (-pi, pi].

                      noncomputable def Signals.IQ.heightFromPhase (waveNumber phase : ℝ) :
                      ℝ

                      The phase-to-height conversion for a round-trip wave-number model.

                      Instances For
                        noncomputable def Signals.IQ.heightFromSample (waveNumber : ℝ) (sample : Sample) :
                        ℝ

                        Convert an I/Q phase to height under the round-trip model.

                        Instances For
                          theorem Signals.IQ.heightFromSample_phase (waveNumber : ℝ) (sample : Sample) (waveNumber_ne_zero : waveNumber ≠ 0) :
                          2 * waveNumber * heightFromSample waveNumber sample = sample.phase

                          The height conversion is the inverse of the round-trip phase relation.

                          Phase and coherence observables #

                          theorem Signals.IQ.Sample.magnitude_eq_norm (sample : Sample) :
                          sample.magnitude = ‖sample.asComplex‖

                          The I/Q envelope equals the complex norm of the baseband sample.

                          theorem Signals.IQ.Sample.magnitude_mul_cos_phase (sample : Sample) :
                          sample.magnitude * Real.cos sample.phase = sample.inPhase

                          The in-phase sample is the envelope times the cosine of its phase.

                          theorem Signals.IQ.Sample.magnitude_mul_sin_phase (sample : Sample) :
                          sample.magnitude * Real.sin sample.phase = sample.quadrature

                          The quadrature sample is the envelope times the sine of its phase.