Refresh the documentation website with figures, rebuilt examples, and cool animations

.gitignore

@@ -17,17 +17,28 @@ notes/*
 
 # Literate-generated example pages (source: docs/literate/examples/*.jl)
 /docs/src/examples/*.md
-# Keep the hand-written instrument-sequences stub until it is Literate-migrated.
-!/docs/src/examples/instrument_sequences.md
 
 # Example figures copied from scripts/figures during docs/make.jl
 /docs/src/assets/examples/
 
+# LaTeX products from docs/tikz/build_svgs.sh
+/docs/tikz/*.aux
+/docs/tikz/*.log
+/docs/tikz/*.out
+/docs/tikz/*.pdf
+/docs/tikz/*.dvi
+/docs/tikz/*.toc
+/docs/tikz/*.build.log
+
 # Local throwaway project environments at any depth (e.g. .bench_env, .plot_env,
 # scripts/.plot_examples_env). Trailing slash limits the match to directories.
 .*env/
 **/.*env/
 
+# Manim render cache and draft outputs from docs/animations/*.py
+/docs/animations/media/
+__pycache__/
+
 # Serialized process-tensor caches from companion scripts
 scripts/.cache/
 

CHANGELOG.md

@@ -7,8 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+### Removed
+
+* **Boundary-driven XXZ example.** The Literate page, companion script, and
+  transport figure are no longer part of the documentation.
+* **Unitary TFIM TEBD and TDVP examples.** The closed-system comparison pages,
+  companion scripts, and figures are removed. A short treatment remains in the
+  unitary-dynamics tutorial.
+
 ### Added
 
+* **`thermal_mode`.** Build a bosonic or spin bath mode whose Liouville `rho0`
+  is the Gibbs state of the local mode Hamiltonian at temperature `T`, the
+  ground-state projector at `T = 0`, or the maximally mixed state at `T = Inf`.
+  Replacement methods keep Hamiltonian, sites, coupling, and `n_max`.
+* **Ramsey POVM example.** A Literate walkthrough and companion ACE script
+  contract three unsharp ``X`` measure-and-reset instruments with a thermal
+  dephasing process tensor, then compare the joint record to a product of
+  single-round marginals. The companion script is `scripts/ramsey_povm.jl`
+  and writes separate protocol and record figures.
 * **Testers and noisy quantum qubits example:** A Literate walkthrough and
   companion ACE script demonstrate store–wait–retrieve control, tester-only
   phase operations, joint trajectories, and system–tester mutual information.

README.md

@@ -39,6 +39,35 @@ The same package can also be used before process tensors enter the story: closed
 | **Run experiments on a process** | Assemble preparations, controls, measurements, left/right actions, trace-outs, and open legs into an `InstrumentSeq`, then contract it with `evaluate_process`. |
 | **Reuse the same environment** | Once a process tensor is built, evolve new initial states with `evolve`, evaluate different protocols, or probe multi-time correlations without rebuilding the bath. |
 
+In each clip below, time runs from right to left.
+
+**Construct a process tensor:** Combine the influence of independent environmental modes and compress the resulting temporal bonds using ACE.
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/src/assets/animations/ace-dark.gif">
+    <img src="docs/src/assets/animations/ace-light.gif" width="640" alt="Time runs right to left. Two environment modes over three time steps are absorbed column by column and compressed into a three-core process tensor with downward system legs.">
+  </picture>
+</p>
+
+**Customize your instruments:** Define the interventions you wish to perform on the system at chosen times; unspecified slots default to identity.
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/src/assets/animations/instruments-dark.gif">
+    <img src="docs/src/assets/animations/instruments-light.gif" width="640" alt="Time runs right to left. A preparation, a custom map, and an open output snap into the slots of a three-step instrument tape; the unspecified slot is filled by an identity, leaving a filled instrument tape.">
+  </picture>
+</p>
+
+**Evaluate and reuse:** Contract the same process tensor with different instruments to obtain reduced states and expectation values.
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/src/assets/animations/contraction-dark.gif">
+    <img src="docs/src/assets/animations/contraction-light.gif" width="900" alt="Time runs right to left. Two identical process tensors are contracted with instruments; the left ends as an open reduced state (triangle) and the right as a closed scalar (circle).">
+  </picture>
+</p>
+
 ## Installation
 
 Install the latest tagged release from GitHub:
@@ -135,8 +164,8 @@ The documentation is written as a progression rather than an API dump.
 
 - **New to the tensor-network conventions?** Start with [ITensor Basics](https://Gauthameshwar.github.io/ProcessTensors.jl/stable/tutorials/itensor_basics/) and [MPS and MPO Basics](https://Gauthameshwar.github.io/ProcessTensors.jl/stable/tutorials/mps_mpo_basics/).
 - **Want open-system dynamics first?** Go to [Liouville-Space Basics](https://Gauthameshwar.github.io/ProcessTensors.jl/stable/tutorials/liouville_basics/) and [Dissipative Dynamics](https://Gauthameshwar.github.io/ProcessTensors.jl/stable/tutorials/dissipative_dynamics/).
-- **Here for process tensors?** Start with the [Single-Mode Process Tensor tutorial](https://Gauthameshwar.github.io/ProcessTensors.jl/stable/tutorials/process_tensor_singlemode/), then move to the ACE examples.
-- **Already know the theory?** Jump straight to the [Examples](https://Gauthameshwar.github.io/ProcessTensors.jl/stable/examples/tebd_time_evolution/) or the [API Reference](https://Gauthameshwar.github.io/ProcessTensors.jl/stable/api/).
+- **Here for process tensors?** Start with [Construct your first process tensor](https://Gauthameshwar.github.io/ProcessTensors.jl/stable/tutorials/process_tensor_singlemode/), then [Explore a process with instruments](https://Gauthameshwar.github.io/ProcessTensors.jl/stable/tutorials/process_tensor_instruments/).
+- **Already know the theory?** Jump straight to the [Examples](https://Gauthameshwar.github.io/ProcessTensors.jl/stable/examples/spin_bath_process_tensor/) or the [API Reference](https://Gauthameshwar.github.io/ProcessTensors.jl/stable/api/).
 
 ## Contributing
 

docs/Project.toml

@@ -1,6 +1,7 @@
 [deps]
 CairoMakie = "13f3f980-e62b-5c42-98c6-ff1f3baf88f0"
 Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
+HDF5 = "f67ccb44-e63f-5c2f-98bd-6dc0ccc4ba2f"
 ITensorMPS = "0d1a4710-d33b-49a5-8f18-73bdf49b47e2"
 ITensors = "9136182c-28ba-11e9-034c-db9fb085ebd5"
 Literate = "98b081ad-f1c9-55d3-8b20-4c87d4299306"
@@ -9,6 +10,7 @@ ProcessTensors = "359c2eb2-a0cb-447a-868d-92de414ddc78"
 [compat]
 CairoMakie = "0.15"
 Documenter = "1.17"
+HDF5 = "0.17"
 ITensorMPS = "0.3.44, 0.4"
 ITensors = "0.9.25"
 Literate = "2"