━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
               DATA DESCRIPTION README FILE FOR "QUANTUM
                             RANGEFINDING"

                              Stefan Frick
           ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


                             2020-10-26 


Table of Contents
─────────────────

1. Figure 2 - Joint Spectral Intensity
2. Figure 3 - Model Plots
3. Figure 5 - Coincidence Rates
4. Figure 6 - Typical Measurement
5. Figure 7 - SNR comparison, model vs. experiment
6. Figure S2 - Temperature Controller
7. Figure S3 - Signal and Idler Spectra


Each filename pre-pended with the figure number of the main text that it
contributes to. All files relevant to each figure are included. This
includes already partially processed time tags in the form of (raw) time
correlated histograms for our rangefinding data. Results of the
simulation of our joint spectral amplitudes are also included as comma
separated values.

All numeric data is presented in comma separated variable (`*.csv')
which can be opened with standard spreadsheet or text editing programs, 
with the exception of the Figure 2 dataset (see below).

Gnuplot scripts (`*.gnuplot') are used to generate plots for our models 
and can be executed using the free Linux utility Gnuplot. These scripts 
and are tested to be compatible with Gnuplot version 5.2 running under 
Ubuntu 16.04. The data generated by these scripts are given as gnuplot 
tables (`*.table') which is a tab separated file format. Our model plots 
are directly generated with a Latex package called `pgfplots'.


1 Figure 2 - Joint Spectral Intensity
═════════════════════════════════════

  `Fig2-JSI.csv' contains the full raw data output by our simulation
  software. Columns 1 and 2 describe the signal and idler wavelengths
  respectively and column 3 gives the joint intensity in arbitrary
  units. Note that due to the large number of rows this file will 
  not open in correctly in some common spreadsheet applications, such as 
  Excel. The file can be opened in full on specialist software capable of 
  handling larger data arrays, and is proven to work on Matlab 2016b. 
  
  The code generating this plot is not included in this
  repository but can be requested from the first author.


2 Figure 3 - Model Plots
════════════════════════

  These plots are directly generated from within latex and the analytic
  form of our model is used to generate these. The full Latex script can
  be found in `Fig3-ModelPlot.tex'.


3 Figure 5 - Coincidence Rates
══════════════════════════════

  Figure 5 uses again the joint spectral intensity given in
  `Fig2-JSI.csv'. The measured coincidence rates for the different
  frequency channel combinations are directly readable from the plot.


4 Figure 6 - Typical Measurement
════════════════════════════════

  Figure 6 shows 600 different time correlated histograms and the
  statistics extracted from these. The histograms are contained in the
  files `Fig6-GreenHistogram.table' and `Fig6-RedHistogram.table',
  respectively. The corresponding statistics are given in the files
  `Fig6-GreenNoiseDistr.table', `Fig6-GreenPeakDistr.table', and
  `Fig6-RedNoiseDistr.table' and `Fig6-RedPeakDistr.table'. These files
  are tab separated values generated with the script `Fig6.gnuplot'. The
  input data to this script is a comma separated version of the
  histogram files.


5 Figure 7 - SNR comparison, model vs. experiment
═════════════════════════════════════════════════

  Files `Fig7-Data-1Channel.table', `Fig7-Data-2Channel.table',
  `Fig7-Model-1Channel.table', and `Fig7-Model-2Channel.table' contain a
  tab separated list of SNRs in the second column and background rate in
  the first column again as a gnuplot table. Files labelled `Data'
  contain experimental results and contain two more columns
  corresponding to the error bars in background rate and SNR. Files
  labelled `Model' contain predictions made by our model.


6 Figure S2 - Temperature Controller
════════════════════════════════════

  The file `FigS2.csv' contains tab separated values with the first
  column being time in 150 milliseconds units and the 4th column showing
  the temperature in 0.1 degree Celsius.


7 Figure S3 - Signal and Idler Spectra
══════════════════════════════════════

  Figure S3 shows the signal and idler spectra measured on a single
  photon resolving spectrometer as well as the simulation results for
  the marginal spectral amplitude of signal and idler. The measurement
  data can be found in `FigS3-measurement.csv' as comma separated
  values, where column one gives the wavelength of and columns two and
  three give the signal and idler intensity respectively. Column three
  measures the intensity of background light on our spectrometer.
  Simulation results are given in file `FigS3-simulation.csv' again as
  comma separated values with column one giving the signal wavelength,
  column two the signal intensity in arbitrary units, column three the
  idler wavelength and column four the idler intensity.