-------------------
GENERAL INFORMATION
-------------------


1. Title of Dataset:  Continuous recoil-driven lasing and cavity frequency pinning with laser-cooled atoms


2. Authors: Vera M. Schäfer, Zhijing Niu, Julia R.K. Cline, Dylan J. Young, Eric Yilun Song, Helmut Ritsch, and James K. Thompson


3. Contact information: vera.schaefer@mpi-hd.mpg.de


4. Date of data collection: January 2022 - May 2023


--------------------------
SHARING/ACCESS INFORMATION
-------------------------- 


1. Licenses/restrictions placed on the data: In Copyright


2. Links to publications that cite or use the data: https://arxiv.org/abs/2405.20952


3. Import *.npz files in python in same folder as *.npz file:
    import numpy as np
    data = np.load("vrs_waterfall_hysteresis.npz") 
    for key in data.keys():
        exec(f"{key} = data['{key}']")

4. Import *.csv files in python in the same folder as *.csv file:
    import pandas as pd
    df = pd.read_csv("dressed_cavity_calculation.csv")

5. Figures are plotted by Python.


---------------------
DATA & FILE OVERVIEW
---------------------


1. File List:


   Figure 1: Experimental setup
   A. lasing_threshold.npz -- Fig. 1b
   B. lasing_trace.csv -- Fig. 1a inset
   C. looc_linewidth.npz -- Fig. 1a inset, Fig. 2c

   Figure 2: Characterisation of the emitted light
   A. beatnote_linewidth_with_transport.csv -- Fig. 2e
   B. four_zones.npz -- Fig. 2a
   C. lasing_vs_transport.csv -- Fig. 2d
   D. Zone_I.npz -- Fig. 2b
   E. Zone_II.npz -- Fig. 2b
   F. Zone_III.npz -- Fig. 2b
   G. Zone_IV.npz -- Fig. 2b

   Figure 3: Pinning of the cavity frequency
   A. dressed_cavity_hysteresis.npz -- Fig. 3b, Fig. 4b/c
   B. vrs_waterfall_hysteresis.npz -- Fig. 3a

   Figure 4: Phenomenological model
   A. dressed_cavity_calculation.csv -- Fig. 4d
   B. atom_number_calculation.csv -- Fig. 4e




-----------------------------------------
DATA-SPECIFIC INFORMATION 
-----------------------------------------

Figure 1:
    A. lasing_threshold.npz
        atom_numbers: unit/atom number
        normalised_total_light: unit/arbitrary
        total_light_errs: standard deviation to normalised_total_light

    B. lasing_trace.csv
        time_min: time, unit/min
        light_power: unit/arbitrary

    C. looc_linewidth.npz
        freq_vec: beatnote frequency, unit/MHz
        beatnote_data: beatnote amplitude, unit/Power Spectral Density (PSD) (a.u.)
        beatnote_fit: lorentzian fit to beatnote_data



Figure 2:
    A. beatnote_linewidth_with_transport.csv
        freq_0kHz: beatnote frequency, unit/kHz
        amplitude_0kHz: beatnote amplitude, unit/PSD (a.u.)
        freq_10kHz: beatnote frequency, unit/kHz
        amplitude_10kHz: beatnote amplitude, unit/PSD (a.u.)
        freq_30kHz: beatnote frequency, unit/kHz
        amplitude_30kHz: beatnote amplitude, unit/PSD (a.u.)

    B. four_zones.npz
        delta_cav_atoms: cavity detuning, unit/MHz
        light_power: power emitted light, unit/a.u.
        light_power_err: statistical uncertainty light_power
        beatnote_freq: fitted beatnote frequency, unit/MHz
        beatnote_freq_err: fit error beatnote frequency, unit/Hz

    C. lasing_vs_transport.csv    
        lattice_det_kHz: lattice detuning, unit/kHz
        peak_beat_kHz: fitted beatnote frequency, unit/kHz
        peak_beat_err_kHz: fit error beatnote frequency, unit/kHz

    D/E/F/G. Zone_I/II/III/IV.npz
         t_vec: time, unit/us
         g2_vec: g2 correlations



Figure 3:
    A. dressed_cavity_hysteresis.npz
        probe_freq: probe frequency for upwards scanned cavity frequency, unit/Hz
        atom_numbers: atom number for upwards scanned cavity frequency
        atom_number_errs: errors on atom_numbers
        dressed_cavity_freq: fitted dressed cavity frequency for upwards scanned cavity frequency, unit/MHz
        dressed_cavity_freq_errs: errors on dressed cavity frequency, unit/MHz
        probe_freq_down: probe frequency for downwards scanned cavity frequency, unit/Hz
        atom_numbers_down: atom number for downwards scanned cavity frequency
        atom_numbers_down_errs: errors on atom_numbers_down
        dressed_cavity_freq_down: fitted dressed cavity frequency for downwards scanned cavity frequency, unit/MHz
        dressed_cavity_freq_down_errs: errors on dressed_cavity_freq_down, unit/MHz
        f_vrs_up: vacuum Rabi splitting for upwards scanned cavity frequency, unit/Hz
        f_vrs_down: vacuum Rabi splitting for downwards scanned cavity frequency, unit/Hz

    B. vrs_waterfall_hysteresis.npz
        axes_array: array of probe frequencies for different cavity detunings, unit/Hz
        samples_array: Single Photon Counting Module counts of probe transmission through cavity, unit/a.u.
        samples_down_array: samples_array for downwards scanned cavity frequency
        superscan_axis: cavity frequency, unit/Hz
        simulation_array: array of simulated values for samples_array
        bare_cavity_probe: probe frequencies for bare cavity, unit/MHz
        bare_cavity: bare cavity resonance frequencies, unit/MHz
        subscan_scale: unit factor of axes_array/ 1e6
        superscan_scale: unit factor for superscan_axis/ 1e6


Figure 4:
    A. dressed_cavity_calculation.csv
       detuning (MHz): cavity atom detuning, unit/MHz
       Steady state (MHz): stable solution of the dressed cavity frequency, unit/MHz
       Unstable state (MHz): unstable solution of the dressed cavity frequency, unit/MHz
    
    B. atom_number_calculation.csv
       detuning (MHz): cavity atom detuning, unit/MHz
       steady_state_N: stable solution of the atom number, unit/(atom / 1e6)
       unstable_state_N: unstable solution of the atom number, unit/(atom / 1e6)



