From f8849b7fb6a34074e938da732b3173e296eadc73 Mon Sep 17 00:00:00 2001
From: Mark Koch <mark.koch@quantinuum.com>
Date: Thu, 11 Apr 2024 14:11:09 +0100
Subject: [PATCH] docs: Add compiler API docs

---
 .github/workflows/docs.yml                    |  65 +++
 docs/_static/Quantinuum_logo_black.png        | Bin 0 -> 18245 bytes
 docs/_static/Quantinuum_logo_white.png        | Bin 0 -> 16704 bytes
 docs/_static/custom.css                       |  38 ++
 docs/api-docs/.gitignore                      |   3 +
 .../_templates/custom-class-template.rst      |  38 ++
 .../_templates/custom-module-template.rst     |  70 +++
 docs/api-docs/conf.py                         |  41 ++
 docs/api-docs/index.rst                       |  22 +
 docs/build.sh                                 |   5 +
 poetry.lock                                   | 455 +++++++++++++++++-
 pyproject.toml                                |   8 +
 12 files changed, 744 insertions(+), 1 deletion(-)
 create mode 100644 .github/workflows/docs.yml
 create mode 100644 docs/_static/Quantinuum_logo_black.png
 create mode 100644 docs/_static/Quantinuum_logo_white.png
 create mode 100644 docs/_static/custom.css
 create mode 100644 docs/api-docs/.gitignore
 create mode 100644 docs/api-docs/_templates/custom-class-template.rst
 create mode 100644 docs/api-docs/_templates/custom-module-template.rst
 create mode 100644 docs/api-docs/conf.py
 create mode 100644 docs/api-docs/index.rst
 create mode 100755 docs/build.sh

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
new file mode 100644
index 00000000..bf111066
--- /dev/null
+++ b/.github/workflows/docs.yml
@@ -0,0 +1,65 @@
+name: Build and publish docs
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+  # Temporary: Run on PR to test the CI
+  pull_request:
+    branches:
+      - main
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run
+# in-progress and latest queued.
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: Build docs.
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Run sccache-cache
+        uses: mozilla-actions/sccache-action@v0.0.4
+      - name: Install poetry
+        run: pipx install poetry
+      - name: Set up Python '3.10'
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+          cache: "poetry"
+
+      - name: Install Guppy
+        run: poetry install --with docs
+      - name: Build docs
+        run: |
+          cd docs
+          ./build.sh
+          cd ..
+      - name: Upload artifact.
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./docs/build/
+
+  publish:
+    name: Publish docs.
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+      - name: Deploy to GitHub Pages.
+        id: deployment
+        uses: actions/deploy-pages@v4
diff --git a/docs/_static/Quantinuum_logo_black.png b/docs/_static/Quantinuum_logo_black.png
new file mode 100644
index 0000000000000000000000000000000000000000..5569581b8e420f14eee561cbf1bf78ca0c96882f
GIT binary patch
literal 18245
zcmeIa`8$-~{{Vd3_mHw?s}PcX-^r3}VF+1Dma(Pm36u3*C@r?^+t{*Y#+tooQ5gH!
zQy~T=L&or&yZ8HhJ^#UTJwJTry1LALpL1U4wQuK44=l}%SQvR3AqZl*WPH&If~av2
zM8!@|3*Ly2W*dP&3<1XWfe>`z4E&EGtW-M$f`p(;7j<pIa@J=zZ}S;7DlZVndlU~Z
z&eE5s=-i<$IwQkRQ9(bD(iKE~*~nEQChfG$$!;t5YjQDm2PGF4W9N8p^>U&Als(9z
zXf4Yxdni&nK}n~%z_#718riY`>)U0pEd&V=mDi}?FONA&D8L^bT3ufF@h02<9{<OU
z|DPyBLZ{<d2zC2>>xMi1qW#^vSS+1p^A5}Y(f79;ovVp#J^hYH8#f5~(j!Mlw|SOI
ztr;Pij@piUe{R@QKyqMNIDO%f1C2)&Y8_FywyQ-BuO}{#$@Nw73vfU>SZX8$HGx_7
zj319#1rT2^)cIOR#!n+EZ*tU8{A&rH9D`<c89zCrYsrQaUp=I*lE{PZ$xYLjD4-W2
z##GRYr<I?^V;fo!FH#6<G(KG7SFN$Mkiz9uT4=zzQbpZ#amrfx&+;I(52Vuo_Ul?N
zsch)QZut({=M5yDsBCxY3#%`7gP=)9V1F`vNi}P+4NGi2yPtoU|BiUs?!+{{UJGD7
z6k>tO@kML<4_=6g>sW`|riY4O<*1~98iW8AmCq{&&6%0X6D+~3Jb0=hp0ut)<3;*>
zEzN(N65CWQO$%9afh{awpD4&JktSqs4_iQ*o1Lad)Q~p}<6#<6Tb)Jtl<MV%-3v6{
zm7@^q1_KU4eW4$E(O7Av-jD$n^TH6ArE+F|p;>LPk(5v=>@Ezh2F+GLDG{$N?&ITW
zD4~!`fc*8*qP1frB`s@}_gli)dwGuMAy+P#1Lh@>L;E^k)8xB2oXQv#@AE=+h!_RP
zwQ8KGOM3r7K2?VWnv?(=)hQ;`s2d}^@G3md;CFvH)M67q&dRYj>@8oYWvQ<89D*`o
z-ef+PPzdRIZUMO-hhZJB96HyPeWKh+l?UqLhId`zblR0e6t>s3o>*9B>zR`4du&b%
z$-J3=DFDf!4JP;#*)GI+ohZp?i^y`$h9ExcC$v!VY3!Z6c(z9`&(W;yTBzIig{_{Y
zfGl9a(~f+&6px9Zge*kiC;On;>x{$1muJ&jjtQU2-e7>f9tWJ^1L|{$e$mA?^+WsR
z`!9YdKnuDserEt>O@h4gcb@fNn#?7j06{?S)>&jZsv>6~4W8y4-Jk&J)EG=?auvx2
z&L^_f;O3$sD7xr03-s=(XrME<gpPg`gK$ozITd6JQ&=45rSLL;J-j*jCoTzshVTrK
z#yM;=!?4#_6#b$$QcnsRQaK4GwsSg#p3>VJW9;6XEBm2Pod*q_1KS6P3G>dZipB*L
zjB!Bt5-bO_#{}N^SX7BYn9BwLKQTRpcf<>E0WaYR!hr0<x|P;gww_zI)UP6qufMRh
zfV@!S=FmcDQcVPpUYL*K!X@Y5)_x;Fj*#nj7)ObVZN?;R3X74WnS<#LBqS5<piWV6
z8%*caTbafY9bK5XyR+Ss`#Fz8-(f9cxh#w~@V21p8{W(gaiyn#1|EYAyrx^&SPYx+
z%7oHV8dNxY358BEAc|9OZ|+axCHfJ_H3954RA4Z%6QM$0ndvPdn*OFnh1VPLLJECx
z=93R5K5`FAX+ooBfUXla_z;rF<}OEJUf<c;isL7s@=TyojDWZfD|fyK@tt|kdDX<+
zJw@_MDku#H7^~jMIGiqP&RZhYx^XscOM00vWaE>Z;TRIKEbLTALUnu<pMIS-+a>vb
zh&3h^F$@<l8zt2+^(a8)F#ePG9fk32?#W!%{095Z`1b|pjqn;21zJEgCSN%UJ8a(k
zaz@38<gB9_2O#nQ;rI^o3*!era@V5OVt}&7u|)+vD!dBA`{z0pR40PWf3=NeBZ$Ur
z-Q!v67k?xaACiF%(mTm41fdwYl_1D5RS(l~-0v2lE!X^HQMG`}KeS^qC<u}$0171<
zVx;c5d6#EtyP_k|d-dQ`OZ<;=Qz}%<)EO`sWbqHD6?XFZ=N!9oE0?VA%Ulp6Fagv9
z4Ys14F|TKS7dlqdtknwrwJ)@qBLF{*f#5j8gf22!+ZIc;*4*OKylq~1x07)MD$pQ;
zg$(CgYgmV!XMeu4-b@*{Yvorhli{0}a(f-1Mp3{lfrDIciVw6(US#61E9R#kb`6<B
zS9C%;6gDLkUH=GF&}X;u5;`PQ3jCFY<1zqGa*Uu!DWKUhPciw!`X{ejALCZxEb8_p
zlzzZ?n#)4#=?@hk?rz|Z^y!bH7M|=se7gLRTid*T4!B!M1Tpt=CU*BDH*3xfXp$d>
zV~OuvsrPQ!X3)pD3G*r}BD@9Zppc6|SC~^BsxQdLyo@%j@4T{qXjier<kh?8o=m9-
zO;W&12d0zR2(xk7aryMa1*)BB@ph;y9r#gKePHq*XBMKLet2S&67uCh_u2j;)iW~+
zT4)1!5EM&E<ol?By=<VE^X8bo#LD3Ud(m*pu4D8#XyE}a;C{nEr{Xs)!!iynCCd&j
zi)Ky==nQbaT^uDp9&d};#F&kZBdx@S)J-O+AXg?+0yRqPYLL@B`cLHd`ISWGQ|9#@
zNi}W2Dfx7On1j@XTpa+Xg{&+0-?0qqy;xCgRj9W3hxTQI3(&UvK>y`5Zo6RSKFRe}
z5RK$3IGX*Uzi9GM6ol&n=}zUnl6J_f<0bszsQQ8mxp%8m0m@7Viv;RdS{oGjH^oI6
za5lvhk5w+8#6Vrt%zO}vu7vz9D&h<8j$iJxbp&Rm^|8gvWGejjb)I4wpk=TgZah)i
zn7cVxSb<l29Pg!*zy)}QwS;7}fCbEK2KBCHT4RF+%zrm`9UMHD@TNeqBLSW2zLPi}
zwD+2+KJ8)XdOwW^K`n0U4$qQN84uJ~2*CRD4B@8QGQBhr#S|9Ud<h>4)DxJkwMu@g
z%p8ru0u}(`YjXKp4ydmf_`PvvuhnaR^6RI|F~O8n$e+}xC*?py+Uk6D0)nEgSH{K}
zm<z#V!_(mH&Ea4%;W#d;akonHFqp5uBb6szeHvnhAsyc8>O#<8ztwg3UQ_bzQ5iEw
zF`1$cZ`({-hzbUIq{hcx6ko58xd;Z*0l6bz7$7Quo0l`MOn^cF|C|NpQH+ACsaOT>
zBs7Tv98O^2zRJ_iD}~MO;3eI@k0zu9eWF4Ec0*nuKX^oUjQeU<QT4WKOh5IW7UByC
zP-l&)3hXPs_`D>?ToAizq}<wN^SSywq>(Gcf=bVgV<Q@c9g@$!e$4T*m^_TCSeI_y
zc=Lm@YXnBas?v~eP4v!hZw!WKk6T!<E7E)f%LcuJVIs<qBLvw=L6-92xqk=*Xown!
z>C>e#XYEIOuL+N7M}PDOnNdS>2eYRsh6=7o$^ehaUecbkAe+_qsaj^IgYhltkQ`Zv
zJmS5Ioki}rn|Km$Qlm6nBLDn)Yeg}XY!m*o^NiMf)KFJ>p&h<q<tXJ(Ci5??xGmXu
z_bP1?6#OuK&Pb}&|74wJ=g!WZHzDr$?b#aV5y+AQm?Fkwos6<6{$wPW=~Nnsk9GnM
zMuIS<X-m-pq81iK&{5>eGRHor>RJN9Lg5Uem_Oy<UKzc^%z*i(KI6xI#+;82@PVOU
zYATCtzU|4iH`+#5I=jtQX~iMZXdzZmHw`@%M~|4@9;rC(cP}!47$T)YQfU&~OZ|OM
zdfcT}{HoSfrU~a0;ak4XDixrxI8DIN9_onV>I1iRVyD4`6Y?$J`dulNHZLia={MD`
zgf5>td!h*yiVkLd56JdRlJfhaYCdvz@{(k^oR%}TJ@zXbwzYI5Z{KRbmlV>{Azv(2
zjZYK{Z)V6=f`t)aVP-o<dvuICLeEULzM=Cz*>9jfrzN!F*Lrnj!)i%>Veju9^0j=i
zXiGrEZXJk-QYu+qZad;J*~=Un-)DZOd3yFV5H79F*pYIX#$LGADnQNs^XHi%7L~je
zaq}zn!p3cmoy${$NQ+kBeFx*c+J<W*9FDY%N%?F&YaRS`Z?T#6b`@%zP_scQZP!Z>
zBb#5Djm*A2w4ZPN(<|2poUa8T(l#AySsgulcqTq~qPq5@sj2KYZm81pu>$1bHyoS+
zY>Gp(e|VSOA!s%}WwzJMdsc%hXAC(UoLF((X3cZfFyDk3!h$rd%eS;5);iwH8mW45
zO)|?_+U*{C|D`{0r0DTML>k^~&Bsa{frJ8*fWoV)XYI8x-0l0Rh1lI8WG@GX=^fY!
zCZH{U+v6{rO?x^$;&k$yH-xU9F{W}&$KC8M7SEraJZa71ztPS(bga++NvQ@>8msmE
z&*y-cN>jy`G*Bfl2G^RIgS5-2@w&sDvPEi2teUCQ6cdC1nTd>@_549(=7Ow?`BtU~
zd%@2{tPWwCt%pz2`enNUnHzcmXT<|oyr0bE?^Q$s>&Q0)6IXWM?(3rZoYG~TFSu#g
z7TPKR3Q}S5o*CnCUlCJ0lxJZNo8G^%B_ow@5b*>pM5VJ012W;23uumCRxmKY=OnNk
z9M@Z+!Zc7mihuZ$##=k{m;DI<M?o3}RH$`vdb($%_4k(+YnMyE337eU+>@>2QWT16
zZ<tzZ9c5MWO;s2F)}?_I%zzwcyw+w?v{u4$iMkweaxZMg_B0TxuN<e#i8QDp;C?bw
zK)R(oU7Isp9g%@o8RUzY^S$IUJ87qiX2>U6O!E_RAq5KnC}-4J>gQ{eTiC;Fg_Lbe
zKC$Uk(R%`3yE8ocbdVP)Ur?$Q?bU&uD7SamN<I0MXVs2AyZ1bIn#@TWkQp#L8K#Qr
z?f3>&RfN|GVQho|dNr?dq_JNM5C$W9t+^$8E&}28T(n&PQRX*zShRNS7KIlGPpFp3
zkhWojTWwDM$VGFo+9()54tq{`><6K|x*<)dnpFf2kPcn-U9sbpBc{Y0c+dkTFxF{i
z6f4u>KlUNqzN=m*-6ps3#rk^%A|{k_2rgIx>yr3dJ>{dnd3`JKM!s5Z5{~onyaN{`
zFJOP^4YCcYYP-*0y!LHBPdKP%#oCzt!3o7&g01~2*aY8_#b@EtGGbSlJNS*E8!r@-
zpY4)-8@Wkca0vkM4wWgEZ~lmk72N;8Pb!qPtN8Fs-CENK<YEP?@VIgrUyD=x)mv5~
zFUUigSdd><jBUrtYd%zsOr?PAfp*yV3<r~0e&)%myo0lBJq3sQ<ew5WIz%%*e{H8k
ziUJ-OPUA=Ke^gBg>xqn~xB^bqA$&+^@{MnFBXbNo)&R(;Z-#OJ*6#XiB^%VZl$*wC
zG^c}0;(aip0PJ1olk=zbbtm7&h~IqGM?x24k4&_gw7K=_>OpwR){nmc-2_%)S!ysb
z^>u&MA7^>L3CpiyDo!>%ML(kS{VubPJiLeZgtGsjSlEEL@_`HRFfW)H4K8c*^<X}E
z0dD-o61yhk7ah}|Bk}ckk#53odE937UiV$i2O!sb0g96X+rVi-KM6gBuo(AbJ8|yg
z=x@_5L9-_it&rs@AgnQQ_h<~mBe(Us%m2{wUG3Yul1aQ-2_z8%B*ELBvt)l+dDD%(
zs2l3Rh{3)dj&6z)-xB;D+M;*QXnuac#*)B})_i|ndjUdC!#I~e=WDbQ3+-_33)AXZ
z(%FtfPC3Kv1(AM6h!23UObaSjdi!R;%#^)^rTR2SQTMy?9t@ukNeI~F0Ic}<=NQ((
z6T0{@R42*sAKDQ%w0pe;FVr9g=ur|uXqetUpG}L5{3k@?S3Tr|>xk{akYLT!1h`?v
z#f_)=NE8{e&c0g{`|a80eOjCgwN{xSUdRnl&Y`AY6tau_M>(C84QTqTl@vQSs&uTT
zdFp7yx1#*2k8a!=4z|X;rqYoG)Yuf)=~79yol+TU%HU@lb|vAW;ySPHcY?6d^%Cq^
ze(8a-R~s|V+$x)=j_M;fDgB4?_@M<@Iq(8d^5S_|tdfC`r@0ETfg#s2?wMGl+aR2A
z*uz*nJH9)|Lq^NGEp(CGlgr$qT^3fYe0B;i<we60sR3lf1)?IhYNps0A}QjKjD2w5
zG98F9>cY`hQR)(ef^DY!QiYVh^{I(S1Tuk1=f0K5s&;PnJY6r)5Z6Xn9ye=;+-7Z4
zi59&y1=m2N(xczZISstfKnB1=;(V+BLo;%}+<yIRy#>B4=-IL71Qo1nlPO5^8(^E_
z9Awn`T;b1aM=EhD%ML6E@ad&<K%ZtoO@S=hGU=)0DWWKzW5sWOd$PmJ^6_ZQ?5`*!
zupbZ5{n3#!sWE1<#)P6HaZw$`pE%B4^M2cLYky+~WUQ`@a340Qfl22lr_)5@rCP90
z6l=rybPEc!Jl3?KW{EJ%4>!|gqZCKVXmyrA-D8==DTzZpEKOe*-Br#hpXG-_%;8;}
zPekQd6Q0r9`0}`QPAs<34qjgsjDorh0sS%p2xOPjekCTm&(;w5#q&UF=jMvmycx==
zkzFnd_%9WDTqt`$OjlS(Q+k&ZuRln2?P2STUB>1B3(cBgm{~3<<g_>mqzZc|UK@@Q
z;EpyLfY*o%7=K3z3dDaQGy^1e9s0s}^_m;?AWJdWSjs_O6g?d5@B)>HkqIk6uPH${
zVd=->{ogrcf2Pyumg`HRrDa{`3Sfq0)WDKtiwLo;Ob$tEXa}ItwFf*at4S<fRHMni
z-7Cd%+2^=91`TxnLbzKRR3HGmt2(<yd-$ansC-YLKjA=~_nH#Q<OA?bi*Ie7KvO(k
zjm7v>QA5FS!4w3DkF`SJD-e_@HK0bWYM?Za@QA#hc-~FJ4kSf?XJMH6p*!UurD6nA
z&VkI@J7=<Gqa;V4!lYD!1^NM6W(7gmCc};FYjii&nk*qpC3ru8e`+y|Tq#s=4Ir24
ztR1w_5=<-bR5UEl{w#D3s2<d)kKj$!j}U`Sn1Whr`u3}pR{U-Rm1rZ()vZ1?DxEAK
zzB>MhN*u}*4;mzv0McY0hYyQ}2hS2{g~rBHqJF`sM-aK3$|P9c6#|qPL5x8W)Ub0p
z2_W$BG0{Nouqay}%d6`HKt@t-2bnzzP=OEt_As5u_<|3C)Om!TR$nIS(nBybI-638
z$0mYjuT8XC$&-bsQGGyTT$RCFRlp5Y3_R!W)A}=7i003aj~UXR=^z8p<GL1Yzr*n-
zugvT%#RjPCIt+dp_*DTVsiHha1sRqCo8g@q_<f!b&t}f3a;(62`7<l@92Al|EZ<*W
z-+5oOmUlAXlunDc@8&(1E?Lm6gXwpSP~xByc=eYl-KQzKHehUaL4FpxpaHQC%`reU
zK%SPdoJvdDQVZOuJ7eQ>s>|v3AYRyg&`Qmuwu9X9Hbp<hiF4RcXS*PO(=)WL=>W9l
zBl%c56y2yw5CnO^F^i>!SM@S2E5zDT?iGv)p_I7{nB+ZVlFG>}00C{UM?X}k295*R
z0Q4cS<}F8aKgom>UCOEhdHn<11!nv-=GH^8fX5Pe^^pK-D3c#(!&}F`$s0*Sj~z7b
ztB<mk%$|VNoB<4AoBg*;L0x%xlgEuk_k}JMGyo?V4wy;Nzfcl!yO-p>p#L0=?e6qy
zS(pGP;E<|Gt;yev7k0n~ANlNdrSb-u07sci>5#N6kc=aY_wb$gUT6A6KS25O!ryC!
z0QA2uYkYSmynaQER7z2GsZWH}br{dk<qLz-6M6OnO)MtkP$i>vKSXIFp?^7WXUUh`
z;e!82`G{(=+A3CI%<Dhz-mFX7j6z0c5?`X+C_>6cC7dRZkO#=Vbj)T7$P-Cgrjm;~
zs9f=2{peU)C{qy-t#~_@7~KIvFjAb3%6CGp&#E?2YYTE62Lc&=!-CHz1I<}_dW?Ru
za<^2fsapmbfaAprdfefUfh`IzTO<N0$fyFKJqNG7&$}IP>ote;9hL}c1qhqQil%Xv
z{Hde*H_GuTdq=xJ6~k0u)(Y3;|BIjgqZ`E22sFb;0ly$q1iEGr8kn<l>9}`0oua%C
zI1N4ePF1(vyPe5D3x?dN3>#NkZ_EuyyB$=bdO^Uc06L{4As|5X9u8g>5fqZS4EX&w
zDL}{u2z`7a!}8*a2`cystiE4il8h1fr8wkJf)()+aC-ly4|jUgjWTJsLlN)fgPdp!
z7+`6AO_0i$VfkJiCj^Xlma1zV7RYBg!|Gg%Gp1DN-{U_hhv3#X_U`6@<^wRZBJQCA
zq6bpY2i&fnY1VWSM7KKy%{JhVoofE;UO@j19`O54iXy}zyNtC!jgCqO)?1E~>(erB
zyG>O3rI$&Y{3a2!L;t31GhKc)tRpp`NB(MD3_9?i=(S_!g$l%B{6vlUJfsn5{_%se
z1@7wpRj)6NbwfkUutcpHWUmRL$q~cB{a9^w*R^Z06kd;D;YhiymyJ28#}@Ae18&KO
z33L(54gbqh%TC|W03NqZAr5-?b)QKm5N4LS!JB4gVd&25>7R$bP#p)@xUw<1zV@Hy
z+nh#Yo7u#CgNfXM6;+BQs}x$DXJE;|{Ynh-0OYf`uy-j#17>Od=E&c5+}{LsunJ%E
z-k~19XWZ)y{Y{O(>!d1GlShAqt1XK$+*EI{fiNb3NjtcNiOrn%?_teL0<HG^Kikv-
z-+P(<p6$3^n3?qJuNwV<WTU{m$CyJefLn3BK#iPk$e?8}H;*MYk5djQ06sJnv<HgW
zl<7M9r_1K4FGCpM*1K}bpHFt|{7`tNd42Ah8->?jRYOLCqlza66OpEi$J%}dY7Y+z
znAB+|)l84`?QeooPX+t$;+LR9dP`mHj&0}<wYY#+$yat5ec}FP<Il)AF9^gQR}ZU*
z#ps-g)9{&#`x+Ak)TIFgoS6%{3h`{j+^HL{!P&qCx7Xg0!VpxR4VuIQ!&wau&x;ji
zw}Xa*2OV6PA?OF}nWrvY|8x}SkrebS#+-@)Ook<BFBeo02AY~s<-c|CiMIKi*)I&E
zU^oE`Pk~{HDjmX%B_#xzxKBb*V91YkTQ}*rEo=J4Xj0>h!9=@nq%H)Vdkpe%4@nmO
zW)oqSo$!2#(a*W+U=2*eILLmQm=0IY+Ywq>M={_ysm=!o9xnd}Ng=wP;Yv0Y6i}T!
z{H}IBP%<vytLdPLcFuy|5jOd!-&zu&Is~S=9dnx;owGXC>dZ8D;V)%qfOY``TyUk^
zeI~9~*np;}9DwuUzY~kkA%S!8Y!|HRJS@TKcPs$nl~9TK?o?(;*p==EC*klRPXSLQ
zuG#(MODCcW(T)mQkc9yhNu(IvyGrBZLoscXL<{MF5H!S#K>9Aghl81wlQE1+5Q+!`
zd{n7mNED{=6||mge8o8DZ~YCN!HENX`E(_Xw(jJ7#SFEp|Kay!%AprQZo8i!&_Ph1
z9?;4v^PF%9;;5sn`@g#Y3*tcG6_7kj2>Qj823F|r;nL8nX9`c)A!y+Wj8>YcSY9{{
zIKWqhr~2_MA?X)ecY?tS0Z=@k*dA2_I=8st-5vYF*!99D_SL{3+{NmO=FtFOHQ=`W
zQME~%To`x?17Qt%st~piy91s!;7+Hudc6Pybvc0z>O@%t_TIh#BTc|tE!6IF4*IMC
zRd@-5lLEc<1h63!1l55g6$%{!O-*P9?sAi|;I9X83wihN+rJB_faWK#9U@ZzJb<9a
z4W1=?`o;EON(j{mzzYptr(f)Ipn!DRz}Bh4gp3fcY6vQD0(8H_B>y}ex7Dx%<|@Ic
zFaQ%wV4Jg-haj)VfP}mamAC-ESukA+Ob;u<l5xy}5QItq5^@D)i?lwy*!VH%?|BxA
z1yr-j_W%~~=@yCtw{>56oDG7$gRTYC3;Mc(FTp*HfouSl)})v2SR6P%mbnGMa_cgV
zJTm)54Wa(P*|ah4>>$;3phN@Dz*NKMJs5o-a0_G`=p^b1=t9y9zizAnOQpfm%r3dU
zz`t`rcM1|cZAu0GJ<#fk`wLwVo{|ar<Is1QX^ukh_&y-i^)ftesSNn#3t|tjW%x)&
ziUSSUlndBYN7bVMj1^`<$VJd@hJxXQ`WV9q-~^mCPs+lZj>14`jIZNELB_ZY?t^@Q
zlSsYuFpi)c2Xjrq+;i{b`aYgOJE=>99XY{{Cq(0sfN_F3e89jH!4`}_3~rUC5z7bQ
z?gS6m-m+ZF6zCbZ-riePAevdA7dneTG;wUs>J~sR;5?-qkiN~<(<FMA66)Fj@+df-
z0Jz=d56CMx4bF9NY%$88!4|%7RFim?z;-H;?QnGlSUqfC1y-P>!*w7hJ_8SD3XABZ
z<Fqm%cbgu9Mt~S}zFAc*7lJd%e@`YnZd8wr*uYP47v1A5_Ab#{Gy1kO1?2iSQO^R=
z;ke$Oa9qIB0l-HE5Fuj?dWZ>Zd3+avN-V*(Lvl6CY0F%|O)3~iib}vCR~5hzg&Wms
zgf_Mw>^4v(3s}y5e|h+tS@>Xmh6>VwPcRhDA<A+S*g9B*U+)6mqxxYO*MSOV$O-_y
z`0N7xNd)gu;9z?KoFM--PN)+!zYdIm-6JR<ls4ca6b({hZ=R*wFE)@zK*q)Z)2`h8
z)jZ@8M$3}qng%o<Bu-G6CF7_wuQ3qF8knJz9wh|It!3D!I{;OI@-7wt?^OjaHUu{W
z1eryEv}u4?TvOeXZ%rf|f87A=dms%!;x^zl2>_x5SeOAz{6GoGh`|$WfQ-^*1rpiz
z8waEDMl2Aj1uzME2AV10HikXk$ZT2+g2rH+pS6t<D@?!)37Ej@OMdxP64+aWQh<UP
zjDk5}*ZQuNW8dESxUJZ6ASM&wwxAGyo~7y0{Xg2maT9s~bCcg=8PYB}+)#lEd~`Pk
za<;@(pF#VW%6k)=k5`^k{6(yQF{#Ee-kY2+ouhaTZmUfFX#-b7MulcmkD{zQR$7;R
z#=Pk&$H1)%T2R^Q?7(*eXuRoS6wf8V(aH$u(!ghjxA@D|1^-4LBOftHMjeo=N58x_
zC`qU%%0=$zPD^?UK&Ud9X0xmFZhj)zI4u{Z$vg%S51Zk0UX&w%>??KE@kpK?FO&`5
z{Dob2AHzDm{abk=wlOVMU0^4RjQ?9jOaT)Gnx>P`2`WYK3CjV@2Ol}0?cgI6`@hHk
zapQl=@IPDle_a7MTdjXk+jc7tIN@4Pa2<kG<4r$XkNf`e$HAW?Mob_aL8B{G(k>k;
zw>4JQHnO$OsT<$7Kiavm@UY!t(cvigr)pH|9r#8n3dexkO9HU=B^r8vkI{KWaMa?0
z1<T{v=As_u&wVB*-<ypLtbadGI;G8@9Ien+zsURhWQtf|*rB9L=zI=3zh3rK6Sqk;
zm^GulOTjAJHZkT0k7!z{-phXm@cBj?y(!+W^!wmvbmO6exgaLjZ_92_yWe7&;}p*D
znvsCAYl>*+qZ#+EpPW1RQ$=5Wj{H8`1uy%I_#C;JgL!<jVxNZJ?J`I<97STK9Mu2x
zPRuGNu4YW`Iy$G3*?O)V?F8?BG7~J{;aYZj{S*JxPCnAvV)%f!gt(G#c<<eaA=QIr
zDi@2|eO6Yjev3fowhX?S;Rc3B-x>>-AJ5)xT>K+RFnk~U^>%j6uu{#L(5c^H%RwA2
zzpzJ2%T+bo*j4P2tTnX};>Cj2{U<z1L(PXNF8LvV<Pp192N86_c)tj78<K?!_PJJJ
zjH(*{A65QRmsa1#kcPdBe3LvA?5OL`r9H>c6?<+MV=#u*lo+-igh|^j)3pbO&mOsu
zQY{Mla!Q`=6*J^L&2IkG!a$pFho6EQ{RdhF!i%MR=ol6!RIS@YiK*Dt=If1O9KA3S
zPvfmTmK|poWk`FQgPA$_`CRRKWhr}s2MI7A(~&qa=_F~YlRBPyNUM$w7(ZSxJ8r>5
zCIEO%a|KpaCxXmc#Gbo!^wN)@3io#<x#p@M->;alHP0VCuR?uksF5tjemP{?!_JfV
zo<BB`6>Dh%cO?{qhe{><RIc;NJeOf{m5=N;szM;O*lOd1{J!IyO*7=z8#bitj%;%c
z%^EFJ8oy+01#~7NYoxoN9tG5=gHb$N^(am)u_!~79_MkMEOY4jT|0HYOu0guNrf|P
zppo(d0=cAe2helYlxoscUXZzLo?VN+_8%cXw3Q>SlQ+DzO1Z*8Q+%AWYS{KbP9QPc
z)%6_UZ<)IHO6=k@lU<ox=|X-UxG1lTil;>)Rknjm<1SPue5Sk8D=|Nt|7C1g>r}K%
zj>A>Qd>aRTU3_whvM1N-Cx@!2ljtii_-%@-%T4$m{~zG+F`bFw3UAE*LHiC(W)gqA
z*CuH-YgH1Q!wZgR??$9+I+B)`9W@%YOqueR#H@GEy{)0Fp0C0IP2+NAD84#Nz3a1o
zn`xdkQxHZ}l}Y$@?$V3W$PUM~v)MGdcxGSOixC+egKwAjR)0M?B7WxEwaFTBkvS$-
zGsKR*631RS>|7?~KT;@6o*(<7DxlomWm$6u`a>iM-_2htYv8GwI+btDL5<v&asOxB
zE;sk_N#oKFnTKoVX;6t3V)q^{aiOoo2#<M9kk^```FCrVSp=7MpY8$6Jg@zJnq9ej
zNwsq`HiKVfdMk7|H2zfQ#0{rwM$oTZV(;(oLG3e(<I>4GskSW&xq%Paewamf@1N3k
zazAL|yTsLVxHmWw|1~Hk>5?GY$-`!-dj%I2sqZ|}nHV5$%4e0PH2rjs{|<*n%x`s%
zSM%}~KY^hdE?-$wplW^ueVw}emMai{WT)uxmYJ{os>>HOU5jAB0`gMeL6C;~KOv6M
zXMU+hsTt?5cMASl^jrT}!(3zNNSfCd@R?_ObZJuM6!(W<YA=K6$Dx`FEr-uVuh~ks
zOAA^tZztuym_1&Cknl6zt7U(Ds4sZKPhF?YPs(y_H@=l;_4+QOH-8cPD%V%^$(!xk
zG%n&ce80Z;QV(kLt?hpi<^Buy?GS57RkU_?&5nLvf6DGoo0xHx<^CdHgV|aJVBW{4
zcxx-Kt$S~NV7Mw2k2Si#TO*J)wI5gF`T}#bbhu-)UA;!6VM*ag)55!<M##$rFLId=
z>c|5j5DaT1wf*V%4wA?Ur1<Q(U16tA$q!7v(cO3XRw9C?-f`X-bt-uTvUooeoz==f
ztEBig_$w~rr0e&Dxd>ZQlv2CJsb2@Rglbz_T?cn7%A+NEquI_?_44aa=Yc8(y|K06
z(3naPuN<~but}>haeSur2^5Na*$Zl~@@vlYD1eI&Y|YA4dDEL5tCCLHBN)O^U$l#&
z1E}P7c+Su}#CwgIzA{Zyp*s_YbkN8ewHfo0JoEfb1i6+SO`&fVz&{1R$t(XRdj%ux
zk(NEFF`2AQv`^~wV=xa(ATO`W%Mur>F1$DIp69-fe~^7mRKZ;l|F9ir2y8pyIGW<?
z<z7O9@4WRAX{vD1<;k=x)+E*T0sDT1{*Q_pxr>gMuH%QS<}};CnO^_ljX4QCL-sk-
zHsBlxY-kFN_fuVz4;mb_Fs9S;k=hHwceH&yF9Xa~cqT1oT}qBE4_W74I9*GpHE>0u
zHeS}RnAgt$fqyqcO{L!gRPWNnN8wG+U5QE@@4j%OH>QUkCm~~{h`((XQKTullgK(%
zB3J(5y6JSKq2rY_C6@oJE*x03CzTj3|GD$2C$wi?^KP--`W_^x%@u=DJH`6akW`wm
zn!~5UvnRUqPQWl(xcyP1eM+MoM#3yJgzi5WQwb-M*AZKbTd7j<{`dBrM0Fkb6RusW
zS>Er>m@7HvXJIY+k=vZsw%G5t+NnZ`PYWp#|L3@_N$hd|iXxVeu6?2Bm-Ix+P{p&C
zoV<`0bL`KedR}jb*X||vnoj00deTMNcl6a0`X8~5Q;s**#(VY)pT*eCQ0u$JAtCz&
z&Zra0#usMKFjpJO3)Nc2V1BV=S^hykSrsUw@(<b_IdO7wbVyeyc21?-B-@rzl@&CU
z(O@O(<xS7T^=NWsS43;~E`8vIe=2f?s$EyV6TQ0Fm4+>HFUaWQ?t;G9%@S{n><4V(
zhE$;hfdc5-x$C@L#R+q5c^R+XAfcWDLKaSl7F;NmoKCfge98CQA%~^;J-^kC(R7GI
zO5@X*JmLH=6($jJGA!ICnY00&L7V&AC=t9x#M88epasns))po)crmK1VpV{u3P*g+
z@U4Oo2&>)>{{~=dxk~;}xJKWVn{dMD_vaAuVgR_)hC>jwSX>KSV=%A$9G(z6hF1mj
zKZGMnf7%!TuV0cMjzDq%oz^d1!-Az!tGx+$?Nb8y8+aRC(`ssDyveNurQC6Q)95{=
zQf2g}(m^`yvDE6Wzsd<WX%b#+seOsnE$~L(s#~KNTs(`2_jBS6+w$((jhuK_*Y$$|
z_d)S%LghEBA+vl^Dw6;~yz;MF65%K;+WP3Atw1vdQc?^`9j~cuO*lrsRTv^djr@lH
z?eW8D$?cBvG4>`Ex$t*l=hv@x19PmzHG(z|vtoB}$!?VlOSwJ%47mPQ7Jwn_TCcW}
zZglBml+M?A$6)UG?Z?gsiF+}!E9WL)tCRdjxZX+8rd#t^rG&@_Tb4=?j+#O{`>*h?
z3ZMq(@K%@dC;9FNP}i{wovu4|Uzjq0THx=On3L@1FS>Gc8}OXZFTrv7^ON{%na_Cb
zOnZLrT&}PpWbAka-CbEd+?k#wiI`Ho0y?AaUiIPC*!9q~@XpvlcCX8+N={fu7D7c$
zG;Q&EskHkI%?_1Y!rLODjb#sqeG&K$I)Mfy*G!M&%#y;UJ{wIRxUS*!a5;zR`1&XD
zoix%z{r1<h-Yy!E9J;hsH1KCXD{m52j0)Iw@zm~>x;KOxL$JE|(b&pTW=?OakK*?l
zmEU_~+No_=DsdfxYpLTcyyr}<uTV;!Hub3t(Q7R+_*g0BafUz0S-sEEDgtrx%1c*C
z*G37yt;>77r$~3MvqwZxBS&mVrKwX!9cQsF=SYmlyy=)Ox7cHd+nPTl%&0HVi#gwz
zmo&@%dUIfGI`rmo=9{ZVhE4w%l$?}GkUDML5EkA>&**a2`AZlp*=7H@+?W^W3OaHg
zL4k<ytUEJpS4k2`KOq(3Lr3CFY<rEu+paU)>WET=3<K?}-)F)fR8}s<-`gE~g!LZe
zF~5YFXisaJaCms`^HcKTl;!eK-|}Yvo6Fa(xi}qjRy2x;!6093k2h6#sqXn!ht$cC
z9%A;6SG9lgzzF#zjCn;LIwO!I&%a2%C~p^uWKf5`H+$KW>?fR=xZG9-zHFs7;XM04
z^o7Wa7-x$jgu)SpU-JAVUy^ZacC+Suof(l;QAcNTr|K1}yfM|ZRICVOnrY1a^JHTO
z0_FBhzk}14Tik(HoFisuC1Nlej}HT$(f7ACr**7mDqWC!cOKKpA0DL-ZrmJtZxNo=
zf2$!TxmN4q&pEQRhT9dB|Bw)+DZOX8-{BsYjMB=_Zy>J+v(>LSL^zLRKHJC7SGSL!
ziI9w3ll3F+Bvd|iW2HvQJo<rXYB|PvI(5JCm$qGs?Ii@h`CpW<1C!T352E+mA7A5d
z7$?41^G|6{YIq~J+_U3`7d7Cxl42V?;vJTzGLg-|R?@BVSu%PpHR2#KJ$$~H`2?qB
z3UQfanWmJ-eGXeAdJ^6JkbY$2f?fiCS@C1N?VaH}qp@qx3Wsv0t3q=AwEmpVN?Omv
zj8TRXV<5M+ERK?H7lPz(V;0WuwrQMH@%Zlj#I>rA_yt)>pzyLGig-9JeM`NFTv9%5
z8her*jd(vZr`o^#l&2|KalExc>6C+8MD;J<YHka6y*EZz%xtB!eEJ_`gs~fuW!$1C
z!nRyU67>Z2!Pws7&@|<%{#Cf|n5XrZa*kv^bk*o8;z{(Hd>vKKefL^#H&~i?iU@15
zb}HPPiaI{iqQ*a7C|LI9?3US=h#l+88%CcwPC9tfB^oVrRGdGmq@~NZ5H@zSj?lcO
z6Or;Q{7WFtK+%4T^7aY&o1A4v+QfJzU>BpTkD^|Nc{XTz1wvVxYot5rnU+V~vGMOW
ztMh+$T_B0<dWq)uT16u8mz$Wr0XKL4x<kuK;GjhQ2r=MSi!a|mvg4dtiQadO!$*o3
zyYKV(X+=8)1KplMrwPrfdk^L%xg|+$%kQH?<umFsq#Lk-_OzY1pQ1lMo0b>Vo=ibx
z50GASyE%HATFOZ}UH+z#NPA<!BU{Xp(5Ez*z8`h70)fQlxi{S>^mZ=}qwi$&jz51?
zH012!xw!sV7U>}n95PXS=gUz(gEuKW#TygPR$^vNV2qVdKIDrTom>;HVxeVX^^jSJ
z%+k<zec5T@igDb(#&8I{{VU)>W*^_{?2?fp<wj|J3)Evh_Sjr9^p$U9=2ej!N?w_F
zBXZA9uj$d;eYPF#b0MIrI(<g2^C}zgR3aw9kC#K}$vWPW+kNL6K82K%QK3&o)@9iS
zZGuzoB<RGhz0CM5RKR|nH&xM6`&GG&RNq+ETU-SDXH)-V{$*eHX>Y5Oa_nr<E$y$=
zrECR@{G42z{J-3(br`&?KSAp$)_D?jAxX%ubq>)XKX!U&&~<Y;<?X@-;+K2W3;Y|^
zp7wzZvrXR;d1`6{7qmomAw{o3zS~uX>kdzR^CxfhM#z^2i0WmntA<-^?p=!@d@tA^
zbk~yH-PoG<%x}9r1@a|yRinfw>QF;n2e09Jb2Os}?VPrVi=iSO!^5ngFm!gWKRz#*
zdR@qr^s4#Xa_}#AQI5|FjP9-MTvDCq@RAW<9}*qzuaM;O(>9AE{l^y8zcyW1a}dzQ
z2aP4DRUN|>oq0)q$}3`=REf#wdp%m7NWDvywnv^a!I&%JzgC#|4E*&G_Yg_NGW!AF
zn`+HoC!Sy`lhVsddSIuFy(*Na7m?fOT|4>V-SVr!Z$3xIUe#{COQAVlVrJ*(O?Lf2
z=ewcnXA~^^OA$AvdFTivut}A`C+R1phY59KK4DWlo7H{IP2VggvgW!b?Yfa@xWJmz
z8<kCi*bKEtCS~nf&#u<3iyd?-(7WFqEW0*48c-O%PTaRECLZsbDbjtrTFvx^{hDXr
zm0H6*H#s2oiy|MjEx5=59WRNOJx1?LbHBsv$86foM-c{%d0TVHeL{;9Ulr$+Qxq-P
zm}gTeF%--S479d43!+L4*koutQ#dbdzU9H*BG!lTAk4_0A9$uX|JvCZb0-dwBE7If
zuQ!QmJO%B(EC;XFHGVXHm>xJ-=snIUJZYAy<cB4-+qK+am!!o~wGVgZ+|YT}9=3oM
zEY2ZcTGNrD#F*uLoA6E@iePV2B&2y`ynFg7U~?tE^REw>y3_sV%6aFGQ#Xu^wY64z
z^UJ-}{C~d^{4Qsgc{_sKc0IzW+>q2tdosB{KTnw-k(?D0gr1FIz@e){N>{owJt>mU
zZHvgKAzGFn@HvL6K9YhqNgwLhmy3=zmtH>KWgo>}D~wYAGQ~<+s8)%iz413Xg(T6m
z3G#OOc9M6FioS?rQB!mpWa`6(t(8b>xoWO`^JRsW$3*XXkzG*&)-;>`p%1wwTkKHT
zG39&07!8Sp7wmeIE9S3#uLC`nbkktCt>T{U&SvqV@GIrnq!0D5tK<5)-{}_}LMH#D
z`L)$IxQcRA*Gk5U*eg2VJqQ^&%%%C%f~N$6*%PQ{vZ8J_0pCsdawDn1>DJv7+GHBb
zTW+t%j$U^Xa!SGkcbD3Jmn>f4X*-bVmx>|l`Dm04e0tDk+TNb`sNUMG=7vBpXA)WQ
zk=wEM2S=X<B19u;g~MYo3~TCJf1NjfQ1r@yhe0Brhb^-x)?q06dY?V_k-&=Gss65?
zgWYb-uljL`USemWrmjkTSgpe4UHnFsl0{8rzyHKh^YPoB!kAP)<84w&)Yp1juEe~-
z@PP&=FK6or9>>`$aWxjl9py+rdbTfePrMZg!TT=)-yNFHz2`e_nZ}uBee3vgj@d@t
zSQK^(uy@sjw!O@)y74WSpNGzP{@c3eW9X4L4U_j4Q*EFA4Xf{#i|&5Axe(wXv2W=y
z9!N=e%kO(Ua<;wsqLlu0HA={D|MMBsDsd@770&qrIX$ENro#-6og~k1E&e~-S$}4J
zd$vk_7tP~KTpCxgO;bAm%vI>J_OF(-IQb+7cMO+EQEh}AZdmHpY+dWI3w)W)^bh1t
zS~pgInv7v(+-M4nQuf$-dY-hA&N<hY5k)ZT&Sm0DSY8PD3xwMzU!h|iDZ$D0!AqL4
zr7KyN0ry>aoAsCOsn&O<Zwq#B|KfZhK9%=CiI|S}Rm2~+%a$Ab+ThcRl-`fE6OgjJ
zoJnlqTQv31MS64ceK@aR%2A{^>UzJqPjbv_P1rd5ezS~_{O!A(i4*ekgI(G2%-s9C
zM*-`6|JW20&=P(EHwvUosVW&pv?dbeC+srBZiC}XO{cr(I0!od!t;qqw`!lPld^c}
z;I@|5t0NhgzTi&-HgOhYXmiK(C@!BwF?iAcDFQ*B;fEmFdHDYYNC{C#Am!np6NhYj
z`=@OFQ;=Af!9?)UwUMmSpOJeu5kD(v-<}KodE<28DdNRcB@Py~n8Q~w+s%tl|3n?z
zA8Q)PV%gf)?OCcgHBie-_-Ir5DN%;y-ElO5v)@7^XUcXkzszz+J7MpXk90_QN22No
z-SX4g$3lM2O79;Pu(Hn4k9?P=4cqmUc`$eEINGMWl$WpufPez+-9xq;4AVT>Ke+1M
zs+LEtp2(>Tou>JyqVAifg{&2qR`RLUeCVkW^ez}JHDQ#hbmmH0I)Pr`Vx~v-@_<3G
zgZ6{NWoo;H{Rd=aYreDPhLXh+e$H`79b21}HKUN`D}>)SZcuzO$f;Ju(tNyP5HUO9
zJQJYg${lq(G8j42rWb?BdJtVcMYSA{WWr^{^)t>aF)+t8QQ)6F$m1yBt<I^$@PLj5
zu#@SxU%q`e)RFgy$G6en+)#J)Q6{`Kt1s8KnH0I`D6Wgwz-AT@J<;U50bvRc0;}Gw
z>F04%M>j0%>TB!l6|S`&<p!Y8yo5&%Hl<UB9WJ8X;DGh($3_Y>!G~|cv7}b$hd$=x
zQn}ahcPECNeGT|-CSB3mF`urPnAeIrXeN5fTxLg+M_1Z+pM85zD>Rx^+1uez-C3}3
zrPpXG+G9Tu|9SaW%LC6V{Od34nU8=aM!oz#zVEkE-Tq)#WiNv7BgkPc6}z-gdSWj7
z3D$p?Qe#h_uxaYd$Auad31*GX4?m46xpttglJax>(w*TAbQErWSNhf$-)rbuXD(SK
z=X((%`-ex#;VpWxw+Us2<YVRQWk!CnBJ3rfCc77}%wLM0UXk8oqZ5&^aH?Ag5bVo%
zM`YS+L{%S|`l{ojgm$%P->A7jDE=F-4uQYazA+Q*=sH5@arEH!IEg#3+FRJo6wg!+
zjHLc5OBjb|9u`-N_I+LfZizq#X`oAdL-Iqm%J$3Bq~^u1r6)PzQypFWX=ZM;Uwg-G
zfpqXwb_lvEqKnr%bxL3-(c{pEHTn~AVPyUb>g|}oD{y-WdI_=`-DAfd?@NA+=2?}-
z3%phh9pp!|f}!=(#*UeqzT4MY`zzPMGs@|(-`YOC9Idw6y3vczhi}U0T#mueJd`0s
z`8H95#{vql*G`j<vx^gPTEnH9Y!6;S7$IZFX5j1(DPuN$ci?&N*h{LrcE-Mi`|jLp
zCwjssww9Mu8;{qIZDTsqUahqzVYOitP~gXw)dOH+Hdx-FMxdM4gy()>z}f!T|MBa5
zV?>8#A$;(%6&!;(nMBCTF1L)p2hUDpwK?GB)AYE#S+M*gSpKYLtpgzLiSPy^Q1njI
zV?ph^XV-%Q!ba^XceqaEycujisZr5SR=vX!2Clb2U2o`d=Qz9Zy?ZT!+D9v`8{IK^
zMSqWvC*hw}gAYv(_<=k8mm1t70VL@B_xgX2|KrC0=gQzR5<GiE<;EXEitxM%E}}rt
NB?I$|HF~Zw{|`5`@Dcz3

literal 0
HcmV?d00001

diff --git a/docs/_static/Quantinuum_logo_white.png b/docs/_static/Quantinuum_logo_white.png
new file mode 100644
index 0000000000000000000000000000000000000000..e896db91cbc3e092ffacd6174419fbfaba0ff015
GIT binary patch
literal 16704
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

literal 0
HcmV?d00001

diff --git a/docs/_static/custom.css b/docs/_static/custom.css
new file mode 100644
index 00000000..ce78012b
--- /dev/null
+++ b/docs/_static/custom.css
@@ -0,0 +1,38 @@
+.wy-side-nav-search,
+.wy-nav-top {
+    background: #5A46BE;
+}
+
+.wy-grid-for-nav,
+.wy-body-for-nav,
+.wy-nav-side,
+.wy-side-scroll,
+.wy-menu,
+.wy-menu-vertical {
+    background-color: #FFFFFF;
+}
+
+.wy-menu-vertical a:hover {
+    background-color: #d9d9d9;
+}
+
+.btn-link:visited,
+.btn-link,
+a:visited,
+.a.reference.external,
+.a.reference.internal,
+.wy-menu-vertical a,
+.wy-menu-vertical li,
+.wy-menu-vertical ul,
+.span.pre,
+.sig-param,
+.std.std-ref,
+
+
+html[data-theme=light] {
+    --pst-color-inline-code: rgb(199, 37, 78) !important;
+}
+
+.sig-name {
+    font-size: 1.25rem;
+}
diff --git a/docs/api-docs/.gitignore b/docs/api-docs/.gitignore
new file mode 100644
index 00000000..df91f175
--- /dev/null
+++ b/docs/api-docs/.gitignore
@@ -0,0 +1,3 @@
+_autosummary
+_build
+generated
\ No newline at end of file
diff --git a/docs/api-docs/_templates/custom-class-template.rst b/docs/api-docs/_templates/custom-class-template.rst
new file mode 100644
index 00000000..d2e98e7c
--- /dev/null
+++ b/docs/api-docs/_templates/custom-class-template.rst
@@ -0,0 +1,38 @@
+..
+   Custom class template to make sphinx-autosummary list the full API doc after
+   the summary. See https://github.com/sphinx-doc/sphinx/issues/7912
+
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. autoclass:: {{ objname }}
+   :members:
+   :show-inheritance:
+   :inherited-members:
+   :special-members: __call__, __add__, __mul__
+
+   {% block methods %}
+   {% if methods %}
+   .. rubric:: {{ _('Methods') }}
+
+   .. autosummary::
+      :nosignatures:
+   {% for item in methods %}
+      {%- if not item.startswith('_') %}
+      ~{{ name }}.{{ item }}
+      {%- endif -%}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block attributes %}
+   {% if attributes %}
+   .. rubric:: {{ _('Attributes') }}
+
+   .. autosummary::
+   {% for item in attributes %}
+      ~{{ name }}.{{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
diff --git a/docs/api-docs/_templates/custom-module-template.rst b/docs/api-docs/_templates/custom-module-template.rst
new file mode 100644
index 00000000..2ab8d43d
--- /dev/null
+++ b/docs/api-docs/_templates/custom-module-template.rst
@@ -0,0 +1,70 @@
+..
+   Custom module template to make sphinx-autosummary list the full API doc after
+   the summary. See https://github.com/sphinx-doc/sphinx/issues/7912
+
+{{ fullname | escape | underline}}
+
+.. automodule:: {{ fullname }}
+
+   {% block attributes %}
+   {% if attributes %}
+   .. rubric:: Module attributes
+
+   .. autosummary::
+      :toctree:
+   {% for item in attributes %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block functions %}
+   {% if functions %}
+   .. rubric:: {{ _('Functions') }}
+
+   .. autosummary::
+      :toctree:
+      :nosignatures:
+   {% for item in functions %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block classes %}
+   {% if classes %}
+   .. rubric:: {{ _('Classes') }}
+
+   .. autosummary::
+      :toctree:
+      :template: custom-class-template.rst
+      :nosignatures:
+   {% for item in classes %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block exceptions %}
+   {% if exceptions %}
+   .. rubric:: {{ _('Exceptions') }}
+
+   .. autosummary::
+      :toctree:
+   {% for item in exceptions %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+{% block modules %}
+{% if modules %}
+.. autosummary::
+   :toctree:
+   :template: custom-module-template.rst
+   :recursive:
+{% for item in modules %}
+   {{ item }}
+{%- endfor %}
+{% endif %}
+{% endblock %}
diff --git a/docs/api-docs/conf.py b/docs/api-docs/conf.py
new file mode 100644
index 00000000..5b52c009
--- /dev/null
+++ b/docs/api-docs/conf.py
@@ -0,0 +1,41 @@
+# Configuration file for the Sphinx documentation builder.
+# See https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+project = "Guppy Compiler"
+copyright = "2024, Quantinuum"
+author = "Quantinuum"
+
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.viewcode",
+    "sphinx.ext.intersphinx",
+]
+
+html_theme = "sphinx_book_theme"
+
+html_title = "Guppy compiler development docs"
+
+html_theme_options = {
+    "repository_url": "https://github.com/CQCL/guppy",
+    "use_repository_button": True,
+    "navigation_with_keys": True,
+    "logo": {
+        "image_light": "_static/Quantinuum_logo_black.png",
+        "image_dark": "_static/Quantinuum_logo_white.png",
+    },
+}
+
+html_static_path = ["../_static"]
+html_css_files = ["custom.css"]
+
+autosummary_generate = True
+
+templates_path = ['_templates']
+exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
+
+intersphinx_mapping = {
+    "python": ("https://docs.python.org/3/", None),
+}
diff --git a/docs/api-docs/index.rst b/docs/api-docs/index.rst
new file mode 100644
index 00000000..0549265c
--- /dev/null
+++ b/docs/api-docs/index.rst
@@ -0,0 +1,22 @@
+Guppy Compiler API Documentation
+================================
+
+This is the API documentation for the Guppy compiler.
+
+Note that this page is designed for contributors to the Guppy compiler, not users of the language.
+See TODO for the language documentation.
+
+.. autosummary::
+   :toctree: generated
+   :template: custom-module-template.rst
+   :recursive:
+
+   guppylang
+
+
+Indices and tables
+~~~~~~~~~~~~~~~~~~
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`
diff --git a/docs/build.sh b/docs/build.sh
new file mode 100755
index 00000000..66bde126
--- /dev/null
+++ b/docs/build.sh
@@ -0,0 +1,5 @@
+mkdir build
+
+touch build/.nojekyll  # Disable jekyll to keep files starting with underscores
+
+poetry run sphinx-build -b html ./api-docs ./build/api-docs
diff --git a/poetry.lock b/poetry.lock
index 44ae6c3b..6a468082 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -1,5 +1,30 @@
 # This file is automatically @generated by Poetry 1.7.1 and should not be changed by hand.
 
+[[package]]
+name = "accessible-pygments"
+version = "0.0.4"
+description = "A collection of accessible pygments styles"
+optional = false
+python-versions = "*"
+files = [
+    {file = "accessible-pygments-0.0.4.tar.gz", hash = "sha256:e7b57a9b15958e9601c7e9eb07a440c813283545a20973f2574a5f453d0e953e"},
+    {file = "accessible_pygments-0.0.4-py2.py3-none-any.whl", hash = "sha256:416c6d8c1ea1c5ad8701903a20fcedf953c6e720d64f33dc47bfb2d3f2fa4e8d"},
+]
+
+[package.dependencies]
+pygments = ">=1.5"
+
+[[package]]
+name = "alabaster"
+version = "0.7.16"
+description = "A light, configurable Sphinx theme"
+optional = false
+python-versions = ">=3.9"
+files = [
+    {file = "alabaster-0.7.16-py3-none-any.whl", hash = "sha256:b46733c07dce03ae4e150330b975c75737fa60f0a7c591b6c8bf4928a28e2c92"},
+    {file = "alabaster-0.7.16.tar.gz", hash = "sha256:75a8b99c28a5dad50dd7f8ccdd447a121ddb3892da9e53d1ca5cca3106d58d65"},
+]
+
 [[package]]
 name = "annotated-types"
 version = "0.6.0"
@@ -11,6 +36,52 @@ files = [
     {file = "annotated_types-0.6.0.tar.gz", hash = "sha256:563339e807e53ffd9c267e99fc6d9ea23eb8443c08f112651963e24e22f84a5d"},
 ]
 
+[[package]]
+name = "babel"
+version = "2.14.0"
+description = "Internationalization utilities"
+optional = false
+python-versions = ">=3.7"
+files = [
+    {file = "Babel-2.14.0-py3-none-any.whl", hash = "sha256:efb1a25b7118e67ce3a259bed20545c29cb68be8ad2c784c83689981b7a57287"},
+    {file = "Babel-2.14.0.tar.gz", hash = "sha256:6919867db036398ba21eb5c7a0f6b28ab8cbc3ae7a73a44ebe34ae74a4e7d363"},
+]
+
+[package.extras]
+dev = ["freezegun (>=1.0,<2.0)", "pytest (>=6.0)", "pytest-cov"]
+
+[[package]]
+name = "beautifulsoup4"
+version = "4.12.3"
+description = "Screen-scraping library"
+optional = false
+python-versions = ">=3.6.0"
+files = [
+    {file = "beautifulsoup4-4.12.3-py3-none-any.whl", hash = "sha256:b80878c9f40111313e55da8ba20bdba06d8fa3969fc68304167741bbf9e082ed"},
+    {file = "beautifulsoup4-4.12.3.tar.gz", hash = "sha256:74e3d1928edc070d21748185c46e3fb33490f22f52a3addee9aee0f4f7781051"},
+]
+
+[package.dependencies]
+soupsieve = ">1.2"
+
+[package.extras]
+cchardet = ["cchardet"]
+chardet = ["chardet"]
+charset-normalizer = ["charset-normalizer"]
+html5lib = ["html5lib"]
+lxml = ["lxml"]
+
+[[package]]
+name = "certifi"
+version = "2024.2.2"
+description = "Python package for providing Mozilla's CA Bundle."
+optional = false
+python-versions = ">=3.6"
+files = [
+    {file = "certifi-2024.2.2-py3-none-any.whl", hash = "sha256:dc383c07b76109f368f6106eee2b593b04a011ea4d55f652c6ca24a754d1cdd1"},
+    {file = "certifi-2024.2.2.tar.gz", hash = "sha256:0569859f95fc761b18b45ef421b1290a0f65f147e92a1e5eb3e635f9a5e4e66f"},
+]
+
 [[package]]
 name = "cfgv"
 version = "3.4.0"
@@ -22,6 +93,105 @@ files = [
     {file = "cfgv-3.4.0.tar.gz", hash = "sha256:e52591d4c5f5dead8e0f673fb16db7949d2cfb3f7da4582893288f0ded8fe560"},
 ]
 
+[[package]]
+name = "charset-normalizer"
+version = "3.3.2"
+description = "The Real First Universal Charset Detector. Open, modern and actively maintained alternative to Chardet."
+optional = false
+python-versions = ">=3.7.0"
+files = [
+    {file = "charset-normalizer-3.3.2.tar.gz", hash = "sha256:f30c3cb33b24454a82faecaf01b19c18562b1e89558fb6c56de4d9118a032fd5"},
+    {file = "charset_normalizer-3.3.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:25baf083bf6f6b341f4121c2f3c548875ee6f5339300e08be3f2b2ba1721cdd3"},
+    {file = "charset_normalizer-3.3.2-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:06435b539f889b1f6f4ac1758871aae42dc3a8c0e24ac9e60c2384973ad73027"},
+    {file = "charset_normalizer-3.3.2-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:9063e24fdb1e498ab71cb7419e24622516c4a04476b17a2dab57e8baa30d6e03"},
+    {file = "charset_normalizer-3.3.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6897af51655e3691ff853668779c7bad41579facacf5fd7253b0133308cf000d"},
+    {file = "charset_normalizer-3.3.2-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1d3193f4a680c64b4b6a9115943538edb896edc190f0b222e73761716519268e"},
+    {file = "charset_normalizer-3.3.2-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:cd70574b12bb8a4d2aaa0094515df2463cb429d8536cfb6c7ce983246983e5a6"},
+    {file = "charset_normalizer-3.3.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8465322196c8b4d7ab6d1e049e4c5cb460d0394da4a27d23cc242fbf0034b6b5"},
+    {file = "charset_normalizer-3.3.2-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:a9a8e9031d613fd2009c182b69c7b2c1ef8239a0efb1df3f7c8da66d5dd3d537"},
+    {file = "charset_normalizer-3.3.2-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:beb58fe5cdb101e3a055192ac291b7a21e3b7ef4f67fa1d74e331a7f2124341c"},
+    {file = "charset_normalizer-3.3.2-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:e06ed3eb3218bc64786f7db41917d4e686cc4856944f53d5bdf83a6884432e12"},
+    {file = "charset_normalizer-3.3.2-cp310-cp310-musllinux_1_1_ppc64le.whl", hash = "sha256:2e81c7b9c8979ce92ed306c249d46894776a909505d8f5a4ba55b14206e3222f"},
+    {file = "charset_normalizer-3.3.2-cp310-cp310-musllinux_1_1_s390x.whl", hash = "sha256:572c3763a264ba47b3cf708a44ce965d98555f618ca42c926a9c1616d8f34269"},
+    {file = "charset_normalizer-3.3.2-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:fd1abc0d89e30cc4e02e4064dc67fcc51bd941eb395c502aac3ec19fab46b519"},
+    {file = "charset_normalizer-3.3.2-cp310-cp310-win32.whl", hash = "sha256:3d47fa203a7bd9c5b6cee4736ee84ca03b8ef23193c0d1ca99b5089f72645c73"},
+    {file = "charset_normalizer-3.3.2-cp310-cp310-win_amd64.whl", hash = "sha256:10955842570876604d404661fbccbc9c7e684caf432c09c715ec38fbae45ae09"},
+    {file = "charset_normalizer-3.3.2-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:802fe99cca7457642125a8a88a084cef28ff0cf9407060f7b93dca5aa25480db"},
+    {file = "charset_normalizer-3.3.2-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:573f6eac48f4769d667c4442081b1794f52919e7edada77495aaed9236d13a96"},
+    {file = "charset_normalizer-3.3.2-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:549a3a73da901d5bc3ce8d24e0600d1fa85524c10287f6004fbab87672bf3e1e"},
+    {file = "charset_normalizer-3.3.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f27273b60488abe721a075bcca6d7f3964f9f6f067c8c4c605743023d7d3944f"},
+    {file = "charset_normalizer-3.3.2-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1ceae2f17a9c33cb48e3263960dc5fc8005351ee19db217e9b1bb15d28c02574"},
+    {file = "charset_normalizer-3.3.2-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:65f6f63034100ead094b8744b3b97965785388f308a64cf8d7c34f2f2e5be0c4"},
+    {file = "charset_normalizer-3.3.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:753f10e867343b4511128c6ed8c82f7bec3bd026875576dfd88483c5c73b2fd8"},
+    {file = "charset_normalizer-3.3.2-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:4a78b2b446bd7c934f5dcedc588903fb2f5eec172f3d29e52a9096a43722adfc"},
+    {file = "charset_normalizer-3.3.2-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:e537484df0d8f426ce2afb2d0f8e1c3d0b114b83f8850e5f2fbea0e797bd82ae"},
+    {file = "charset_normalizer-3.3.2-cp311-cp311-musllinux_1_1_i686.whl", hash = "sha256:eb6904c354526e758fda7167b33005998fb68c46fbc10e013ca97f21ca5c8887"},
+    {file = "charset_normalizer-3.3.2-cp311-cp311-musllinux_1_1_ppc64le.whl", hash = "sha256:deb6be0ac38ece9ba87dea880e438f25ca3eddfac8b002a2ec3d9183a454e8ae"},
+    {file = "charset_normalizer-3.3.2-cp311-cp311-musllinux_1_1_s390x.whl", hash = "sha256:4ab2fe47fae9e0f9dee8c04187ce5d09f48eabe611be8259444906793ab7cbce"},
+    {file = "charset_normalizer-3.3.2-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:80402cd6ee291dcb72644d6eac93785fe2c8b9cb30893c1af5b8fdd753b9d40f"},
+    {file = "charset_normalizer-3.3.2-cp311-cp311-win32.whl", hash = "sha256:7cd13a2e3ddeed6913a65e66e94b51d80a041145a026c27e6bb76c31a853c6ab"},
+    {file = "charset_normalizer-3.3.2-cp311-cp311-win_amd64.whl", hash = "sha256:663946639d296df6a2bb2aa51b60a2454ca1cb29835324c640dafb5ff2131a77"},
+    {file = "charset_normalizer-3.3.2-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:0b2b64d2bb6d3fb9112bafa732def486049e63de9618b5843bcdd081d8144cd8"},
+    {file = "charset_normalizer-3.3.2-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:ddbb2551d7e0102e7252db79ba445cdab71b26640817ab1e3e3648dad515003b"},
+    {file = "charset_normalizer-3.3.2-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:55086ee1064215781fff39a1af09518bc9255b50d6333f2e4c74ca09fac6a8f6"},
+    {file = "charset_normalizer-3.3.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8f4a014bc36d3c57402e2977dada34f9c12300af536839dc38c0beab8878f38a"},
+    {file = "charset_normalizer-3.3.2-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:a10af20b82360ab00827f916a6058451b723b4e65030c5a18577c8b2de5b3389"},
+    {file = "charset_normalizer-3.3.2-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:8d756e44e94489e49571086ef83b2bb8ce311e730092d2c34ca8f7d925cb20aa"},
+    {file = "charset_normalizer-3.3.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:90d558489962fd4918143277a773316e56c72da56ec7aa3dc3dbbe20fdfed15b"},
+    {file = "charset_normalizer-3.3.2-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:6ac7ffc7ad6d040517be39eb591cac5ff87416c2537df6ba3cba3bae290c0fed"},
+    {file = "charset_normalizer-3.3.2-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:7ed9e526742851e8d5cc9e6cf41427dfc6068d4f5a3bb03659444b4cabf6bc26"},
+    {file = "charset_normalizer-3.3.2-cp312-cp312-musllinux_1_1_i686.whl", hash = "sha256:8bdb58ff7ba23002a4c5808d608e4e6c687175724f54a5dade5fa8c67b604e4d"},
+    {file = "charset_normalizer-3.3.2-cp312-cp312-musllinux_1_1_ppc64le.whl", hash = "sha256:6b3251890fff30ee142c44144871185dbe13b11bab478a88887a639655be1068"},
+    {file = "charset_normalizer-3.3.2-cp312-cp312-musllinux_1_1_s390x.whl", hash = "sha256:b4a23f61ce87adf89be746c8a8974fe1c823c891d8f86eb218bb957c924bb143"},
+    {file = "charset_normalizer-3.3.2-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:efcb3f6676480691518c177e3b465bcddf57cea040302f9f4e6e191af91174d4"},
+    {file = "charset_normalizer-3.3.2-cp312-cp312-win32.whl", hash = "sha256:d965bba47ddeec8cd560687584e88cf699fd28f192ceb452d1d7ee807c5597b7"},
+    {file = "charset_normalizer-3.3.2-cp312-cp312-win_amd64.whl", hash = "sha256:96b02a3dc4381e5494fad39be677abcb5e6634bf7b4fa83a6dd3112607547001"},
+    {file = "charset_normalizer-3.3.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:95f2a5796329323b8f0512e09dbb7a1860c46a39da62ecb2324f116fa8fdc85c"},
+    {file = "charset_normalizer-3.3.2-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c002b4ffc0be611f0d9da932eb0f704fe2602a9a949d1f738e4c34c75b0863d5"},
+    {file = "charset_normalizer-3.3.2-cp37-cp37m-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:a981a536974bbc7a512cf44ed14938cf01030a99e9b3a06dd59578882f06f985"},
+    {file = "charset_normalizer-3.3.2-cp37-cp37m-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:3287761bc4ee9e33561a7e058c72ac0938c4f57fe49a09eae428fd88aafe7bb6"},
+    {file = "charset_normalizer-3.3.2-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:42cb296636fcc8b0644486d15c12376cb9fa75443e00fb25de0b8602e64c1714"},
+    {file = "charset_normalizer-3.3.2-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0a55554a2fa0d408816b3b5cedf0045f4b8e1a6065aec45849de2d6f3f8e9786"},
+    {file = "charset_normalizer-3.3.2-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:c083af607d2515612056a31f0a8d9e0fcb5876b7bfc0abad3ecd275bc4ebc2d5"},
+    {file = "charset_normalizer-3.3.2-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:87d1351268731db79e0f8e745d92493ee2841c974128ef629dc518b937d9194c"},
+    {file = "charset_normalizer-3.3.2-cp37-cp37m-musllinux_1_1_ppc64le.whl", hash = "sha256:bd8f7df7d12c2db9fab40bdd87a7c09b1530128315d047a086fa3ae3435cb3a8"},
+    {file = "charset_normalizer-3.3.2-cp37-cp37m-musllinux_1_1_s390x.whl", hash = "sha256:c180f51afb394e165eafe4ac2936a14bee3eb10debc9d9e4db8958fe36afe711"},
+    {file = "charset_normalizer-3.3.2-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:8c622a5fe39a48f78944a87d4fb8a53ee07344641b0562c540d840748571b811"},
+    {file = "charset_normalizer-3.3.2-cp37-cp37m-win32.whl", hash = "sha256:db364eca23f876da6f9e16c9da0df51aa4f104a972735574842618b8c6d999d4"},
+    {file = "charset_normalizer-3.3.2-cp37-cp37m-win_amd64.whl", hash = "sha256:86216b5cee4b06df986d214f664305142d9c76df9b6512be2738aa72a2048f99"},
+    {file = "charset_normalizer-3.3.2-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:6463effa3186ea09411d50efc7d85360b38d5f09b870c48e4600f63af490e56a"},
+    {file = "charset_normalizer-3.3.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:6c4caeef8fa63d06bd437cd4bdcf3ffefe6738fb1b25951440d80dc7df8c03ac"},
+    {file = "charset_normalizer-3.3.2-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:37e55c8e51c236f95b033f6fb391d7d7970ba5fe7ff453dad675e88cf303377a"},
+    {file = "charset_normalizer-3.3.2-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:fb69256e180cb6c8a894fee62b3afebae785babc1ee98b81cdf68bbca1987f33"},
+    {file = "charset_normalizer-3.3.2-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:ae5f4161f18c61806f411a13b0310bea87f987c7d2ecdbdaad0e94eb2e404238"},
+    {file = "charset_normalizer-3.3.2-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:b2b0a0c0517616b6869869f8c581d4eb2dd83a4d79e0ebcb7d373ef9956aeb0a"},
+    {file = "charset_normalizer-3.3.2-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:45485e01ff4d3630ec0d9617310448a8702f70e9c01906b0d0118bdf9d124cf2"},
+    {file = "charset_normalizer-3.3.2-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:eb00ed941194665c332bf8e078baf037d6c35d7c4f3102ea2d4f16ca94a26dc8"},
+    {file = "charset_normalizer-3.3.2-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:2127566c664442652f024c837091890cb1942c30937add288223dc895793f898"},
+    {file = "charset_normalizer-3.3.2-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:a50aebfa173e157099939b17f18600f72f84eed3049e743b68ad15bd69b6bf99"},
+    {file = "charset_normalizer-3.3.2-cp38-cp38-musllinux_1_1_ppc64le.whl", hash = "sha256:4d0d1650369165a14e14e1e47b372cfcb31d6ab44e6e33cb2d4e57265290044d"},
+    {file = "charset_normalizer-3.3.2-cp38-cp38-musllinux_1_1_s390x.whl", hash = "sha256:923c0c831b7cfcb071580d3f46c4baf50f174be571576556269530f4bbd79d04"},
+    {file = "charset_normalizer-3.3.2-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:06a81e93cd441c56a9b65d8e1d043daeb97a3d0856d177d5c90ba85acb3db087"},
+    {file = "charset_normalizer-3.3.2-cp38-cp38-win32.whl", hash = "sha256:6ef1d82a3af9d3eecdba2321dc1b3c238245d890843e040e41e470ffa64c3e25"},
+    {file = "charset_normalizer-3.3.2-cp38-cp38-win_amd64.whl", hash = "sha256:eb8821e09e916165e160797a6c17edda0679379a4be5c716c260e836e122f54b"},
+    {file = "charset_normalizer-3.3.2-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:c235ebd9baae02f1b77bcea61bce332cb4331dc3617d254df3323aa01ab47bd4"},
+    {file = "charset_normalizer-3.3.2-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:5b4c145409bef602a690e7cfad0a15a55c13320ff7a3ad7ca59c13bb8ba4d45d"},
+    {file = "charset_normalizer-3.3.2-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:68d1f8a9e9e37c1223b656399be5d6b448dea850bed7d0f87a8311f1ff3dabb0"},
+    {file = "charset_normalizer-3.3.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:22afcb9f253dac0696b5a4be4a1c0f8762f8239e21b99680099abd9b2b1b2269"},
+    {file = "charset_normalizer-3.3.2-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e27ad930a842b4c5eb8ac0016b0a54f5aebbe679340c26101df33424142c143c"},
+    {file = "charset_normalizer-3.3.2-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:1f79682fbe303db92bc2b1136016a38a42e835d932bab5b3b1bfcfbf0640e519"},
+    {file = "charset_normalizer-3.3.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b261ccdec7821281dade748d088bb6e9b69e6d15b30652b74cbbac25e280b796"},
+    {file = "charset_normalizer-3.3.2-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:122c7fa62b130ed55f8f285bfd56d5f4b4a5b503609d181f9ad85e55c89f4185"},
+    {file = "charset_normalizer-3.3.2-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:d0eccceffcb53201b5bfebb52600a5fb483a20b61da9dbc885f8b103cbe7598c"},
+    {file = "charset_normalizer-3.3.2-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:9f96df6923e21816da7e0ad3fd47dd8f94b2a5ce594e00677c0013018b813458"},
+    {file = "charset_normalizer-3.3.2-cp39-cp39-musllinux_1_1_ppc64le.whl", hash = "sha256:7f04c839ed0b6b98b1a7501a002144b76c18fb1c1850c8b98d458ac269e26ed2"},
+    {file = "charset_normalizer-3.3.2-cp39-cp39-musllinux_1_1_s390x.whl", hash = "sha256:34d1c8da1e78d2e001f363791c98a272bb734000fcef47a491c1e3b0505657a8"},
+    {file = "charset_normalizer-3.3.2-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:ff8fa367d09b717b2a17a052544193ad76cd49979c805768879cb63d9ca50561"},
+    {file = "charset_normalizer-3.3.2-cp39-cp39-win32.whl", hash = "sha256:aed38f6e4fb3f5d6bf81bfa990a07806be9d83cf7bacef998ab1a9bd660a581f"},
+    {file = "charset_normalizer-3.3.2-cp39-cp39-win_amd64.whl", hash = "sha256:b01b88d45a6fcb69667cd6d2f7a9aeb4bf53760d7fc536bf679ec94fe9f3ff3d"},
+    {file = "charset_normalizer-3.3.2-py3-none-any.whl", hash = "sha256:3e4d1f6587322d2788836a99c69062fbb091331ec940e02d12d179c1d53e25fc"},
+]
+
 [[package]]
 name = "colorama"
 version = "0.4.6"
@@ -111,6 +281,17 @@ files = [
     {file = "distlib-0.3.8.tar.gz", hash = "sha256:1530ea13e350031b6312d8580ddb6b27a104275a31106523b8f123787f494f64"},
 ]
 
+[[package]]
+name = "docutils"
+version = "0.20.1"
+description = "Docutils -- Python Documentation Utilities"
+optional = false
+python-versions = ">=3.7"
+files = [
+    {file = "docutils-0.20.1-py3-none-any.whl", hash = "sha256:96f387a2c5562db4476f09f13bbab2192e764cac08ebbf3a34a95d9b1e4a59d6"},
+    {file = "docutils-0.20.1.tar.gz", hash = "sha256:f08a4e276c3a1583a86dce3e34aba3fe04d02bba2dd51ed16106244e8a923e3b"},
+]
+
 [[package]]
 name = "exceptiongroup"
 version = "1.2.0"
@@ -184,6 +365,28 @@ files = [
 [package.extras]
 license = ["ukkonen"]
 
+[[package]]
+name = "idna"
+version = "3.7"
+description = "Internationalized Domain Names in Applications (IDNA)"
+optional = false
+python-versions = ">=3.5"
+files = [
+    {file = "idna-3.7-py3-none-any.whl", hash = "sha256:82fee1fc78add43492d3a1898bfa6d8a904cc97d8427f683ed8e798d07761aa0"},
+    {file = "idna-3.7.tar.gz", hash = "sha256:028ff3aadf0609c1fd278d8ea3089299412a7a8b9bd005dd08b9f8285bcb5cfc"},
+]
+
+[[package]]
+name = "imagesize"
+version = "1.4.1"
+description = "Getting image size from png/jpeg/jpeg2000/gif file"
+optional = false
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
+files = [
+    {file = "imagesize-1.4.1-py2.py3-none-any.whl", hash = "sha256:0d8d18d08f840c19d0ee7ca1fd82490fdc3729b7ac93f49870406ddde8ef8d8b"},
+    {file = "imagesize-1.4.1.tar.gz", hash = "sha256:69150444affb9cb0d5cc5a92b3676f0b2fb7cd9ae39e947a5e11a36b4497cd4a"},
+]
+
 [[package]]
 name = "iniconfig"
 version = "2.0.0"
@@ -647,6 +850,48 @@ files = [
 [package.dependencies]
 typing-extensions = ">=4.6.0,<4.7.0 || >4.7.0"
 
+[[package]]
+name = "pydata-sphinx-theme"
+version = "0.15.2"
+description = "Bootstrap-based Sphinx theme from the PyData community"
+optional = false
+python-versions = ">=3.9"
+files = [
+    {file = "pydata_sphinx_theme-0.15.2-py3-none-any.whl", hash = "sha256:0c5fa1fa98a9b26dae590666ff576f27e26c7ba708fee754ecb9e07359ed4588"},
+    {file = "pydata_sphinx_theme-0.15.2.tar.gz", hash = "sha256:4243fee85b3afcfae9df64f83210a04e7182e53bc3db8841ffff6d21d95ae320"},
+]
+
+[package.dependencies]
+accessible-pygments = "*"
+Babel = "*"
+beautifulsoup4 = "*"
+docutils = "!=0.17.0"
+packaging = "*"
+pygments = ">=2.7"
+sphinx = ">=5.0"
+typing-extensions = "*"
+
+[package.extras]
+a11y = ["pytest-playwright"]
+dev = ["nox", "pre-commit", "pydata-sphinx-theme[doc,test]", "pyyaml"]
+doc = ["ablog (>=0.11.0rc2)", "colorama", "ipykernel", "ipyleaflet", "jupyter_sphinx", "jupyterlite-sphinx", "linkify-it-py", "matplotlib", "myst-parser", "nbsphinx", "numpy", "numpydoc", "pandas", "plotly", "rich", "sphinx-autoapi (>=3.0.0)", "sphinx-copybutton", "sphinx-design", "sphinx-favicon (>=1.0.1)", "sphinx-sitemap", "sphinx-togglebutton", "sphinxcontrib-youtube (<1.4)", "sphinxext-rediraffe", "xarray"]
+test = ["pytest", "pytest-cov", "pytest-regressions"]
+
+[[package]]
+name = "pygments"
+version = "2.17.2"
+description = "Pygments is a syntax highlighting package written in Python."
+optional = false
+python-versions = ">=3.7"
+files = [
+    {file = "pygments-2.17.2-py3-none-any.whl", hash = "sha256:b27c2826c47d0f3219f29554824c30c5e8945175d888647acd804ddd04af846c"},
+    {file = "pygments-2.17.2.tar.gz", hash = "sha256:da46cec9fd2de5be3a8a784f434e4c4ab670b4ff54d605c4c2717e9d49c4c367"},
+]
+
+[package.extras]
+plugins = ["importlib-metadata"]
+windows-terminal = ["colorama (>=0.4.6)"]
+
 [[package]]
 name = "pytest"
 version = "7.4.4"
@@ -799,6 +1044,27 @@ files = [
 [package.dependencies]
 setuptools = "*"
 
+[[package]]
+name = "requests"
+version = "2.31.0"
+description = "Python HTTP for Humans."
+optional = false
+python-versions = ">=3.7"
+files = [
+    {file = "requests-2.31.0-py3-none-any.whl", hash = "sha256:58cd2187c01e70e6e26505bca751777aa9f2ee0b7f4300988b709f44e013003f"},
+    {file = "requests-2.31.0.tar.gz", hash = "sha256:942c5a758f98d790eaed1a29cb6eefc7ffb0d1cf7af05c3d2791656dbd6ad1e1"},
+]
+
+[package.dependencies]
+certifi = ">=2017.4.17"
+charset-normalizer = ">=2,<4"
+idna = ">=2.5,<4"
+urllib3 = ">=1.21.1,<3"
+
+[package.extras]
+socks = ["PySocks (>=1.5.6,!=1.5.7)"]
+use-chardet-on-py3 = ["chardet (>=3.0.2,<6)"]
+
 [[package]]
 name = "ruff"
 version = "0.3.0"
@@ -883,6 +1149,176 @@ docs = ["furo", "jaraco.packaging (>=9.3)", "jaraco.tidelift (>=1.4)", "pygments
 testing = ["build[virtualenv]", "filelock (>=3.4.0)", "flake8-2020", "ini2toml[lite] (>=0.9)", "jaraco.develop (>=7.21)", "jaraco.envs (>=2.2)", "jaraco.path (>=3.2.0)", "packaging (>=23.2)", "pip (>=19.1)", "pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-cov", "pytest-enabler (>=2.2)", "pytest-home (>=0.5)", "pytest-mypy (>=0.9.1)", "pytest-perf", "pytest-ruff (>=0.2.1)", "pytest-timeout", "pytest-xdist", "tomli-w (>=1.0.0)", "virtualenv (>=13.0.0)", "wheel"]
 testing-integration = ["build[virtualenv] (>=1.0.3)", "filelock (>=3.4.0)", "jaraco.envs (>=2.2)", "jaraco.path (>=3.2.0)", "packaging (>=23.2)", "pytest", "pytest-enabler", "pytest-xdist", "tomli", "virtualenv (>=13.0.0)", "wheel"]
 
+[[package]]
+name = "snowballstemmer"
+version = "2.2.0"
+description = "This package provides 29 stemmers for 28 languages generated from Snowball algorithms."
+optional = false
+python-versions = "*"
+files = [
+    {file = "snowballstemmer-2.2.0-py2.py3-none-any.whl", hash = "sha256:c8e1716e83cc398ae16824e5572ae04e0d9fc2c6b985fb0f900f5f0c96ecba1a"},
+    {file = "snowballstemmer-2.2.0.tar.gz", hash = "sha256:09b16deb8547d3412ad7b590689584cd0fe25ec8db3be37788be3810cbf19cb1"},
+]
+
+[[package]]
+name = "soupsieve"
+version = "2.5"
+description = "A modern CSS selector implementation for Beautiful Soup."
+optional = false
+python-versions = ">=3.8"
+files = [
+    {file = "soupsieve-2.5-py3-none-any.whl", hash = "sha256:eaa337ff55a1579b6549dc679565eac1e3d000563bcb1c8ab0d0fefbc0c2cdc7"},
+    {file = "soupsieve-2.5.tar.gz", hash = "sha256:5663d5a7b3bfaeee0bc4372e7fc48f9cff4940b3eec54a6451cc5299f1097690"},
+]
+
+[[package]]
+name = "sphinx"
+version = "7.2.6"
+description = "Python documentation generator"
+optional = false
+python-versions = ">=3.9"
+files = [
+    {file = "sphinx-7.2.6-py3-none-any.whl", hash = "sha256:1e09160a40b956dc623c910118fa636da93bd3ca0b9876a7b3df90f07d691560"},
+    {file = "sphinx-7.2.6.tar.gz", hash = "sha256:9a5160e1ea90688d5963ba09a2dcd8bdd526620edbb65c328728f1b2228d5ab5"},
+]
+
+[package.dependencies]
+alabaster = ">=0.7,<0.8"
+babel = ">=2.9"
+colorama = {version = ">=0.4.5", markers = "sys_platform == \"win32\""}
+docutils = ">=0.18.1,<0.21"
+imagesize = ">=1.3"
+Jinja2 = ">=3.0"
+packaging = ">=21.0"
+Pygments = ">=2.14"
+requests = ">=2.25.0"
+snowballstemmer = ">=2.0"
+sphinxcontrib-applehelp = "*"
+sphinxcontrib-devhelp = "*"
+sphinxcontrib-htmlhelp = ">=2.0.0"
+sphinxcontrib-jsmath = "*"
+sphinxcontrib-qthelp = "*"
+sphinxcontrib-serializinghtml = ">=1.1.9"
+
+[package.extras]
+docs = ["sphinxcontrib-websupport"]
+lint = ["docutils-stubs", "flake8 (>=3.5.0)", "flake8-simplify", "isort", "mypy (>=0.990)", "ruff", "sphinx-lint", "types-requests"]
+test = ["cython (>=3.0)", "filelock", "html5lib", "pytest (>=4.6)", "setuptools (>=67.0)"]
+
+[[package]]
+name = "sphinx-book-theme"
+version = "1.1.2"
+description = "A clean book theme for scientific explanations and documentation with Sphinx"
+optional = false
+python-versions = ">=3.9"
+files = [
+    {file = "sphinx_book_theme-1.1.2-py3-none-any.whl", hash = "sha256:cee744466fde48f50302b851291b208aa67e726ca31b7a3bfb9b6e6a145663e0"},
+    {file = "sphinx_book_theme-1.1.2.tar.gz", hash = "sha256:7f3abcd146ca82e6f39d6db53711102b1c1d328d12f65e3e47ad9bf842614a49"},
+]
+
+[package.dependencies]
+pydata-sphinx-theme = ">=0.14"
+sphinx = ">=5"
+
+[package.extras]
+code-style = ["pre-commit"]
+doc = ["ablog", "folium", "ipywidgets", "matplotlib", "myst-nb", "nbclient", "numpy", "numpydoc", "pandas", "plotly", "sphinx-copybutton", "sphinx-design", "sphinx-examples", "sphinx-tabs", "sphinx-thebe", "sphinx-togglebutton", "sphinxcontrib-bibtex", "sphinxcontrib-youtube", "sphinxext-opengraph"]
+test = ["beautifulsoup4", "coverage", "myst-nb", "pytest", "pytest-cov", "pytest-regressions", "sphinx_thebe"]
+
+[[package]]
+name = "sphinxcontrib-applehelp"
+version = "1.0.8"
+description = "sphinxcontrib-applehelp is a Sphinx extension which outputs Apple help books"
+optional = false
+python-versions = ">=3.9"
+files = [
+    {file = "sphinxcontrib_applehelp-1.0.8-py3-none-any.whl", hash = "sha256:cb61eb0ec1b61f349e5cc36b2028e9e7ca765be05e49641c97241274753067b4"},
+    {file = "sphinxcontrib_applehelp-1.0.8.tar.gz", hash = "sha256:c40a4f96f3776c4393d933412053962fac2b84f4c99a7982ba42e09576a70619"},
+]
+
+[package.extras]
+lint = ["docutils-stubs", "flake8", "mypy"]
+standalone = ["Sphinx (>=5)"]
+test = ["pytest"]
+
+[[package]]
+name = "sphinxcontrib-devhelp"
+version = "1.0.6"
+description = "sphinxcontrib-devhelp is a sphinx extension which outputs Devhelp documents"
+optional = false
+python-versions = ">=3.9"
+files = [
+    {file = "sphinxcontrib_devhelp-1.0.6-py3-none-any.whl", hash = "sha256:6485d09629944511c893fa11355bda18b742b83a2b181f9a009f7e500595c90f"},
+    {file = "sphinxcontrib_devhelp-1.0.6.tar.gz", hash = "sha256:9893fd3f90506bc4b97bdb977ceb8fbd823989f4316b28c3841ec128544372d3"},
+]
+
+[package.extras]
+lint = ["docutils-stubs", "flake8", "mypy"]
+standalone = ["Sphinx (>=5)"]
+test = ["pytest"]
+
+[[package]]
+name = "sphinxcontrib-htmlhelp"
+version = "2.0.5"
+description = "sphinxcontrib-htmlhelp is a sphinx extension which renders HTML help files"
+optional = false
+python-versions = ">=3.9"
+files = [
+    {file = "sphinxcontrib_htmlhelp-2.0.5-py3-none-any.whl", hash = "sha256:393f04f112b4d2f53d93448d4bce35842f62b307ccdc549ec1585e950bc35e04"},
+    {file = "sphinxcontrib_htmlhelp-2.0.5.tar.gz", hash = "sha256:0dc87637d5de53dd5eec3a6a01753b1ccf99494bd756aafecd74b4fa9e729015"},
+]
+
+[package.extras]
+lint = ["docutils-stubs", "flake8", "mypy"]
+standalone = ["Sphinx (>=5)"]
+test = ["html5lib", "pytest"]
+
+[[package]]
+name = "sphinxcontrib-jsmath"
+version = "1.0.1"
+description = "A sphinx extension which renders display math in HTML via JavaScript"
+optional = false
+python-versions = ">=3.5"
+files = [
+    {file = "sphinxcontrib-jsmath-1.0.1.tar.gz", hash = "sha256:a9925e4a4587247ed2191a22df5f6970656cb8ca2bd6284309578f2153e0c4b8"},
+    {file = "sphinxcontrib_jsmath-1.0.1-py2.py3-none-any.whl", hash = "sha256:2ec2eaebfb78f3f2078e73666b1415417a116cc848b72e5172e596c871103178"},
+]
+
+[package.extras]
+test = ["flake8", "mypy", "pytest"]
+
+[[package]]
+name = "sphinxcontrib-qthelp"
+version = "1.0.7"
+description = "sphinxcontrib-qthelp is a sphinx extension which outputs QtHelp documents"
+optional = false
+python-versions = ">=3.9"
+files = [
+    {file = "sphinxcontrib_qthelp-1.0.7-py3-none-any.whl", hash = "sha256:e2ae3b5c492d58fcbd73281fbd27e34b8393ec34a073c792642cd8e529288182"},
+    {file = "sphinxcontrib_qthelp-1.0.7.tar.gz", hash = "sha256:053dedc38823a80a7209a80860b16b722e9e0209e32fea98c90e4e6624588ed6"},
+]
+
+[package.extras]
+lint = ["docutils-stubs", "flake8", "mypy"]
+standalone = ["Sphinx (>=5)"]
+test = ["pytest"]
+
+[[package]]
+name = "sphinxcontrib-serializinghtml"
+version = "1.1.10"
+description = "sphinxcontrib-serializinghtml is a sphinx extension which outputs \"serialized\" HTML files (json and pickle)"
+optional = false
+python-versions = ">=3.9"
+files = [
+    {file = "sphinxcontrib_serializinghtml-1.1.10-py3-none-any.whl", hash = "sha256:326369b8df80a7d2d8d7f99aa5ac577f51ea51556ed974e7716cfd4fca3f6cb7"},
+    {file = "sphinxcontrib_serializinghtml-1.1.10.tar.gz", hash = "sha256:93f3f5dc458b91b192fe10c397e324f262cf163d79f3282c158e8436a2c4511f"},
+]
+
+[package.extras]
+lint = ["docutils-stubs", "flake8", "mypy"]
+standalone = ["Sphinx (>=5)"]
+test = ["pytest"]
+
 [[package]]
 name = "sympy"
 version = "1.12"
@@ -945,6 +1381,23 @@ files = [
     {file = "typing_extensions-4.10.0.tar.gz", hash = "sha256:b0abd7c89e8fb96f98db18d86106ff1d90ab692004eb746cf6eda2682f91b3cb"},
 ]
 
+[[package]]
+name = "urllib3"
+version = "2.2.1"
+description = "HTTP library with thread-safe connection pooling, file post, and more."
+optional = false
+python-versions = ">=3.8"
+files = [
+    {file = "urllib3-2.2.1-py3-none-any.whl", hash = "sha256:450b20ec296a467077128bff42b73080516e71b56ff59a60a02bef2232c4fa9d"},
+    {file = "urllib3-2.2.1.tar.gz", hash = "sha256:d0570876c61ab9e520d776c38acbbb5b05a776d3f9ff98a5c8fd5162a444cf19"},
+]
+
+[package.extras]
+brotli = ["brotli (>=1.0.9)", "brotlicffi (>=0.8.0)"]
+h2 = ["h2 (>=4,<5)"]
+socks = ["pysocks (>=1.5.6,!=1.5.7,<2.0)"]
+zstd = ["zstandard (>=0.18.0)"]
+
 [[package]]
 name = "virtualenv"
 version = "20.25.1"
@@ -968,4 +1421,4 @@ test = ["covdefaults (>=2.3)", "coverage (>=7.2.7)", "coverage-enable-subprocess
 [metadata]
 lock-version = "2.0"
 python-versions = "^3.10"
-content-hash = "57785589b5390f498f093ea0cdce22e07cfa82d54e1a7765eef77ef7b0b2d3af"
+content-hash = "49cc1079ec5cc62f0903953f633009f2a532ad5fd4aa262d87c5c7e9d1ff5f96"
diff --git a/pyproject.toml b/pyproject.toml
index 6cf01e71..7e5d55fb 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -38,6 +38,14 @@ pytket = { version = "^1.24.0" }
 tket2-py = { git = "https://github.com/CQCL/tket2.git", rev = "9e941f3" }
 
 
+[tool.poetry.group.docs]
+optional = true
+
+[tool.poetry.group.docs.dependencies]
+sphinx = "^7.2.6"
+sphinx-book-theme = "^1.1.2"
+
+
 [build-system]
 requires = ["poetry-core"]
 build-backend = "poetry.core.masonry.api"