Merge pull request #45 from ldeo-glaciology/edit_apres_theory

Edit apres theory

Author: jkingslake

src/_config.yml

@@ -28,7 +28,7 @@ html:
   use_multitoc_numbering    : true   # Continuous numbering across parts/chapters
   extra_navbar              : Powered by <a href="https://jupyterbook.org">Jupyter Book</a>  # Will be displayed underneath the left navbar.
   extra_footer              : ""  # Will be displayed underneath the footer.
-  google_analytics_id       : ""  # A GA id that can be used to track book views.
+  google_analytics_id       : "G-4GXWLSDF9Y"  # A GA id that can be used to track book views.
   home_page_in_navbar       : true  # Whether to include your home page in the left Navigation Bar
   baseurl                   : ""  # The base URL where your book will be hosted. Used for creating image previews and social links. e.g.: https://mypage.com/mybook/
   comments:

src/_toc.yml

@@ -34,7 +34,6 @@ parts:
   - file: sections/radar/apres/apres-intro
     sections:
     - file: sections/radar/apres/theory_1.ipynb
-    - file: sections/radar/apres/beat-frequency
     - file: sections/radar/apres/apres_data_1.ipynb
 
 - caption: Appendix

src/references.bib

@@ -16,3 +16,58 @@ @article{brennan_phase-sensitive_2014
 	pages = {776--786},
 	file = {Full Text PDF:/Users/jkingslake/Zotero/storage/7YHSEPTX/Brennan et al. - 2014 - Phase-sensitive FMCW radar system for high-precisi.pdf:application/pdf;Snapshot:/Users/jkingslake/Zotero/storage/NDCHEJ9K/iet-rsn.2013.html:text/html},
 }
+
+@article{Nicholls_Corr_Stewart_Lok_Brennan_Vaughan_2015, 
+	title={A ground-based radar for measuring vertical strain rates and time-varying basal melt rates in ice sheets and shelves}, 
+	volume={61}, 
+	DOI={10.3189/2015JoG15J073}, 
+	number={230}, 
+	journal={Journal of Glaciology}, 
+	author={Nicholls, Keith W. and Corr, Hugh F.J. and Stewart, Craig L. and Lok, Lai Bun and Brennan, Paul V. and Vaughan, David G.}, 
+	year={2015}, 
+	pages={1079–-1087}} <div></div>
+
+@article{kingslake2014full,
+  title={Full-depth englacial vertical ice sheet velocities measured using phase-sensitive radar},
+  author={Kingslake, Jonathan and Hindmarsh, Richard CA and A{\dh}algeirsd{\'o}ttir, Gu{\dh}finna and Conway, Howard and Corr, Hugh FJ and Gillet-Chaulet, Fabien and Mart{\'\i}n, Carlos and King, Edward C and Mulvaney, Robert and Pritchard, Hamish D},
+  journal={Journal of Geophysical Research: Earth Surface},
+  volume={119},
+  number={12},
+  pages={2604--2618},
+  year={2014},
+  publisher={Wiley Online Library}
+}
+
+@article{brisbourne2019constraining,
+  title={Constraining recent ice flow history at Korff Ice Rise, West Antarctica, using radar and seismic measurements of ice fabric},
+  author={Baird, AF and Kendall, JM and Kingslake, J},
+  journal={Journal of Geophysical Research: Earth Surface},
+  volume={124},
+  number={1},
+  pages={175--194},
+  year={2019},
+  publisher={Wiley Online Library}
+}
+
+@article{young2021rapid,
+  title={Rapid and accurate polarimetric radar measurements of ice crystal fabric orientation at the Western Antarctic Ice Sheet (WAIS) Divide ice core site},
+  author={Young, Tun Jan and Mart{\'\i}n, Carlos and Christoffersen, Poul and Schroeder, Dustin M and Tulaczyk, Slawek M and Dawson, Eliza J},
+  journal={The Cryosphere},
+  volume={15},
+  number={8},
+  pages={4117--4133},
+  year={2021},
+  publisher={Copernicus Publications G{\"o}ttingen, Germany}
+}
+
+@article{vavnkova2022ocean,
+  title={Ocean variability beneath the Filchner-Ronne ice shelf inferred from basal melt rate time series},
+  author={Va{\v{n}}kov{\'a}, Irena and Nicholls, Keith W},
+  journal={Journal of Geophysical Research: Oceans},
+  volume={127},
+  number={10},
+  pages={e2022JC018879},
+  year={2022},
+  publisher={Wiley Online Library}
+}
+

src/sections/radar/apres/apres-intro.md

@@ -1,10 +1,19 @@
 (page:apres-intro)=
 # Autonomous phase-sensitive Radio Echo Sounder
 
-The Autonomous phase-sensitive Radio-Echo Sounder (ApRES) is a frequency-modulated continuous-wave radar. Like all ground-penetrating radar, it emits radio waves and records radio waves which have travelled into the subsurface and been reflected back towards the radar. Reflection typically occurs at discrete locations in the subsurface, which are interpreted as interfaces between materials with different dielectric properties. We refer to these as reflectors.
+The Autonomous phase-sensitive Radio-Echo Sounder (ApRES) is a frequency-modulated continuous-wave radar. Like all ground-penetrating radar systems, it emits radio waves in to the subsurface and records what is reflected back towards the radar. Reflection typically occurs at discrete locations in the subsurface, which are interpreted as interfaces between materials with different dielectric properties. We refer to these as reflectors.
 
 ApRES is primarily designed to measure changes over time in the separation of sub-surface reflectors. When ApRES is used on an ice sheet, these reflectors can be internal to the ice ('englacial') reflectors or the ice base. Englacial reflections originate from contrasts in the density or chemistry of the ice, while basal reflections originate from the strong contrast between the ice and the underlying sediment, bedrock, or water. 
 
-ApRES has most commonly been used to estimate melt rates at the base of ice shelves (the floating extensions of ice sheets), by tracking the separation between the ice-water interface and the englacial reflectors (REF). ApRES, along with it predecessor, pRES, have also been used to measure englacial deformation on grounded ice (REF) and constrain ice crystal fabric (REF).
+ApRES has most commonly been used to estimate melt rates at the base of ice shelves (the floating extensions of ice sheets), by tracking the separation between the ice-water interface and the englacial reflectors {cite:p}`brennan_phase-sensitive_2014, Nicholls_Corr_Stewart_Lok_Brennan_Vaughan_2015, vavnkova2022ocean`. ApRES, along with it predecessor, pRES, have also been used to measure englacial deformation on grounded ice {cite:p}`kingslake2014full`) and constrain ice-crystal fabric {cite:p}`brisbourne2019constraining, young2021rapid`.
 
-In the following pages we describe some the theory behind ApRES. 
+```{figure} figures/apres_at_JIRP.png
+---
+name: fig:apres_on_JIRP
+---
+ApRES being deployed on the Juneau Icefield as part of the Juneau Icefield Research Program (JIRP). Photo credit: Elizabeth Case. 
+```
+
+
+
+The following page describes the theory behind one aspect of the ApRES system: how the so-called 'coarse' range is computed using fourier transform of  the signal recorded by ApRES. The following page applies this theory to real data collected in Antarctica. 

src/sections/radar/apres/apres-range-frequency.ipynb

@@ -2071,7 +2071,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "full_py_env",
+   "display_name": "xapres",
    "language": "python",
    "name": "python3"
   },
@@ -2085,7 +2085,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.6"
+   "version": "3.12.4"
   }
  },
  "nbformat": 4,

src/sections/radar/apres/apres_data_1.ipynb

@@ -420,7 +420,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3",
+   "display_name": "full_py_env",
    "language": "python",
    "name": "python3"
   },
@@ -435,11 +435,6 @@
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
    "version": "3.11.6"
-  },
-  "vscode": {
-   "interpreter": {
-    "hash": "d30c63c32c419ea9f0bba7809c4e773ec43b1ff3bce90afeee7dfc4932bbd9b5"
-   }
   }
  },
  "nbformat": 4,