Documentation

Signals.Homodyne

A classical local oscillator with a selectable phase reference.

  • amplitude : ℝ
  • amplitude_nonnegative : 0 ≤ self.amplitude
  • phase : ℝ
Instances For

    Convert the local oscillator amplitude and phase to an I/Q reference.

    Instances For
      noncomputable def Signals.Homodyne.beamSplitterPlus (signal reference : IQ.Sample) :

      The normalized plus output of an ideal 50:50 beam splitter.

      Instances For
        noncomputable def Signals.Homodyne.beamSplitterMinus (signal reference : IQ.Sample) :

        The normalized minus output of an ideal 50:50 beam splitter.

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

          The squared I/Q envelope used as the finite classical detector signal.

          Instances For
            noncomputable def Signals.Homodyne.differentialPhotocurrent (signal : IQ.Sample) (oscillator : LocalOscillator) :
            ℝ

            The differential signal produced by the two balanced detector outputs.

            Instances For

              A complete finite classical balanced-homodyne observation.

              Instances For
                theorem Signals.Homodyne.beamSplitter_energy_conserved (signal reference : IQ.Sample) :
                sampleEnergy (beamSplitterPlus signal reference) + sampleEnergy (beamSplitterMinus signal reference) = sampleEnergy signal + sampleEnergy reference

                The ideal beam splitter conserves the finite I/Q energy.

                theorem Signals.Homodyne.differentialPhotocurrent_eq_interference (signal : IQ.Sample) (oscillator : LocalOscillator) :
                differentialPhotocurrent signal oscillator = 2 * (signal.inPhase * oscillator.amplitude * Real.cos oscillator.phase + signal.quadrature * oscillator.amplitude * Real.sin oscillator.phase)

                The detector difference is the interference term of signal and reference.

                noncomputable def Signals.Homodyne.rotatedQuadrature (signal : IQ.Sample) (phase : ℝ) :
                ℝ

                The finite quadrature selected by a local-oscillator phase.

                Instances For
                  theorem Signals.Homodyne.differentialPhotocurrent_eq_rotatedQuadrature (signal : IQ.Sample) (oscillator : LocalOscillator) :
                  differentialPhotocurrent signal oscillator = 2 * oscillator.amplitude * rotatedQuadrature signal oscillator.phase

                  The balanced detector difference is twice the reference amplitude times the selected finite quadrature.

                  A balanced homodyne record exposes its differential-current law.

                  Calibrated common-mode rejection data for a balanced detector.

                  Instances For

                    A finite detector channel response with efficiency, bandwidth, and dark current.

                    Instances For

                      A detector observation with an explicit optical-power-to-current law.

                      Instances For

                        Shot, electronic, and local-oscillator intensity-noise data.

                        Instances For

                          Common-mode noise leakage after a calibrated rejection factor.

                          Instances For

                            A bounded rejection factor preserves nonnegative noise density.

                            Common-mode noise leakage cannot exceed the supplied noise density.

                            The two calibrated current channels of a balanced detector.

                            Instances For

                              Equal detector currents cancel in the balanced differential channel.

                              Raw-current calibration with a measured residual and explicit tolerance.

                              Instances For

                                A calibrated photocurrent is accepted when its residual is in tolerance.

                                Instances For

                                  The calibrated photocurrent exposes its raw-data preservation invariant.

                                  theorem Signals.Homodyne.CalibratedPhotocurrent.consistent_iff (measurement : CalibratedPhotocurrent) :
                                  measurement.consistent ↔ |measurement.residual| ≤ measurement.tolerance

                                  The calibrated photocurrent exposes its residual tolerance condition.

                                  noncomputable def Signals.Homodyne.signBin (threshold outcome : ℝ) :
                                  Bool

                                  Bin a measured quadrature against an explicit finite threshold.

                                  Instances For

                                    A quadrature outcome with its threshold classification recorded.

                                    Instances For
                                      structure Signals.Homodyne.DualHomodyneTrace (sampleCount : ℕ) :

                                      A finite pair of homodyne quadrature traces and their summary statistics.

                                      Instances For
                                        theorem Signals.Homodyne.DualHomodyneTrace.mean_a_holds {sampleCount : ℕ} (trace : DualHomodyneTrace sampleCount) :
                                        trace.meanA = (∑ index : Fin sampleCount, trace.outcomesA index) / ↑trace.validSampleCount

                                        The first finite trace mean follows its supplied sample average.

                                        theorem Signals.Homodyne.DualHomodyneTrace.mean_b_holds {sampleCount : ℕ} (trace : DualHomodyneTrace sampleCount) :
                                        trace.meanB = (∑ index : Fin sampleCount, trace.outcomesB index) / ↑trace.validSampleCount

                                        The second finite trace mean follows its supplied sample average.

                                        theorem Signals.Homodyne.DualHomodyneTrace.covariance_holds {sampleCount : ℕ} (trace : DualHomodyneTrace sampleCount) :
                                        trace.covariance = (∑ index : Fin sampleCount, (trace.outcomesA index - trace.meanA) * (trace.outcomesB index - trace.meanB)) / ↑trace.validSampleCount

                                        The finite covariance follows its supplied centered-product average.

                                        The normalized finite correlation follows its supplied scale.

                                        theorem Signals.Homodyne.DualHomodyneTrace.missing_samples_bounded {sampleCount : ℕ} (trace : DualHomodyneTrace sampleCount) :
                                        trace.missingSamples ≤ sampleCount

                                        The finite dual trace records a bounded count of missing samples.

                                        theorem Signals.Homodyne.DualHomodyneTrace.residual_within_tolerance {sampleCount : ℕ} (trace : DualHomodyneTrace sampleCount) :
                                        |trace.residual| ≤ trace.residualTolerance

                                        The finite dual trace exposes its residual acceptance condition.

                                        structure Signals.Homodyne.HomodyneGrid (width height : ℕ) :

                                        A finite spatial homodyne sensor grid with a shared local oscillator.

                                        Instances For
                                          theorem Signals.Homodyne.HomodyneGrid.pixel_photocurrent_holds {width height : ℕ} (grid : HomodyneGrid width height) (column : Fin width) (row : Fin height) :
                                          grid.pixelPhotocurrent column row = differentialPhotocurrent (grid.signal column row) grid.localOscillator

                                          A grid pixel follows the shared-LO differential photocurrent law.

                                          theorem Signals.Homodyne.HomodyneGrid.phase_map_holds {width height : ℕ} (grid : HomodyneGrid width height) (column : Fin width) (row : Fin height) :
                                          grid.phaseMap column row = (grid.signal column row).phase

                                          A grid pixel phase follows the source I/Q phase map.

                                          A typed sample format for downstream homodyne runtime consumers.

                                          Instances For

                                            A trace sample preserves the raw detector difference law.

                                            A trace sample preserves its affine calibration result.

                                            A dispersive readout composed with balanced detection and current calibration.

                                            Instances For

                                              The composed record exposes agreement between dispersive phase and homodyne signal.

                                              The composed record preserves the detector pair's raw differential current.