81 lines
2.4 KiB
Markdown
81 lines
2.4 KiB
Markdown
# Quantum Entanglement Multi-Laboratory Study
|
|
|
|
## Non-local Correlations in Entangled Photon Pairs: A Multi-Laboratory Study of Bell Inequality Violations
|
|
|
|
This repository contains all data, analysis code, and manuscript materials for a collaborative study of Bell inequality violations across 34 quantum optics laboratories in 32 countries.
|
|
|
|
### Project Structure
|
|
|
|
```
|
|
qu-en/
|
|
├── data/
|
|
│ ├── raw/ # Raw experimental data from participating labs
|
|
│ └── base/ # Processed data files
|
|
├── notebooks/ # Jupyter notebooks for analysis and visualization
|
|
│ ├── make_basedata.ipynb # Data processing pipeline
|
|
│ ├── plot_*.ipynb # Visualization notebooks
|
|
│ ├── tab_*.ipynb # Table generation notebooks
|
|
│ └── utils.py # Utility functions
|
|
├── output/
|
|
│ ├── plots/ # Generated figures
|
|
│ ├── tables/ # Generated LaTeX tables
|
|
│ └── manuscript.pdf # Final compiled manuscript
|
|
├── report/
|
|
│ └── manuscript.tex # LaTeX manuscript source
|
|
├── Makefile # Build automation
|
|
└── README.md
|
|
```
|
|
|
|
### Building the Manuscript
|
|
|
|
The entire analysis pipeline and manuscript can be built with a single command:
|
|
|
|
```bash
|
|
make
|
|
```
|
|
|
|
This will:
|
|
1. Process raw experimental data
|
|
2. Generate all plots and tables
|
|
3. Compile the LaTeX manuscript to PDF
|
|
|
|
### Requirements
|
|
|
|
- Python 3.7+ with packages:
|
|
- pandas
|
|
- numpy
|
|
- matplotlib
|
|
- pyprojroot
|
|
- papermill
|
|
- jupyter
|
|
- LaTeX distribution (e.g., TeXLive, MikTeX)
|
|
- Make
|
|
|
|
### Data
|
|
|
|
The `data/raw/experimental_data.csv` file contains measurements from 35 participating laboratories (34 after quality control). Each row represents one experiment with the following key variables:
|
|
|
|
- Bell Parameter (S)
|
|
- Entanglement Fidelity
|
|
- Visibility
|
|
- Detector specifications
|
|
- Environmental conditions
|
|
- And more...
|
|
|
|
### Reproducibility
|
|
|
|
All analysis is fully reproducible. The Makefile ensures correct execution order and dependency tracking. To rebuild from scratch:
|
|
|
|
```bash
|
|
make clean
|
|
make
|
|
```
|
|
|
|
### License
|
|
|
|
Research data and code are provided for academic use. Please cite the accompanying publication if you use this data.
|
|
|
|
### Contact
|
|
|
|
For questions about the data or analysis, please contact the International Quantum Entanglement Consortium.
|