unitaryfund · nathanshammah · Sep 22, 2023 · Jul 10, 2023 · Jul 10, 2023 · Jul 10, 2023
diff --git a/AUTHORS b/AUTHORS
@@ -17,6 +17,7 @@ Nick Gardner
 Nathaniel T. Stemen
 Nathan Shammah
 Will J. Zeng
+Min Li
 
 L-P-B
 Paul Chung

diff --git a/dev_requirements.txt b/dev_requirements.txt
@@ -33,5 +33,6 @@ pyscf==2.3.0; sys_platform != 'win32'
 openfermion==1.5.1; sys_platform != 'win32'
 openfermionpyscf==0.5; sys_platform != 'win32'
 bqskit[ext]==1.0.4
+seaborn~=0.12.2
 stim==1.12.0
 stimcirq==1.12.0
diff --git a/docs/source/_thumbnails/rshadow_protocol.png b/docs/source/_thumbnails/rshadow_protocol.png
diff --git a/docs/source/_thumbnails/shadow-tutorial.png b/docs/source/_thumbnails/shadow-tutorial.png
diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -353,6 +353,8 @@ def get_incollection_template(self, e):
     "examples/learning-depolarizing-noise": "_static/learn-depolarizing.png",
     "examples/pec_tutorial": "_static/pec-tutorial.png",
     "examples/scaling": "_static/scaling.png",
+    "examples/shadows_tutorial": "_static/shadow-tutorial.png",
+    "examples/rshadows_tutorial": "_static/rshadow_protocol.png",
     "examples/ddd_tutorial": "_static/ddd-tutorial.png",
     "examples/ddd_on_ibmq_ghz": "_static/ddd_qiskit_ghz_plot.png",
     "examples/calibration-tutorial": "_static/calibration.png",

diff --git a/docs/source/examples/examples.md b/docs/source/examples/examples.md
@@ -25,6 +25,8 @@ ZNE with BQSKit compiled circuits <bqskit.md>
 ZNE on Stim backend with Cirq: Logical randomized benchmarking circuits <zne_logical_rb_cirq_stim.md>
 PEC on a Braket simulator: Mirror circuits <pec_tutorial.md>
 PEC with Cirq: Learning representations <learning-depolarizing-noise.md>
+Classical Shadows with Cirq: State Reconstruction and Observable Estimation <shadows_tutorial.md>
+Robust Shadow Estimation with Cirq: Pauli Twirling Calibration of Classical Shadows <rshadows_tutorial.md>
 DDD with Cirq: Mirror circuits <ddd_tutorial.md>
 DDD with Qiskit: GHZ circuits <ddd_on_ibmq_ghz.md>
 GGI Summer School ZNE Hands-On Tutorial <ggi_summer_school_unsolved.md>

diff --git a/docs/source/examples/rshadows_tutorial.md b/docs/source/examples/rshadows_tutorial.md