diff --git a/.buildinfo b/.buildinfo
index 4a87cfcf5..47a6f662f 100644
--- a/.buildinfo
+++ b/.buildinfo
@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file records the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: bc80145cd978ad13593299240540dc9f
+config: 239e77517bdc2098f56264595ac8bdd9
 tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/.doctrees/api/ffsim.contract.doctree b/.doctrees/api/ffsim.contract.doctree
index 656e054fa..0b1f2b532 100644
Binary files a/.doctrees/api/ffsim.contract.doctree and b/.doctrees/api/ffsim.contract.doctree differ
diff --git a/.doctrees/api/ffsim.doctree b/.doctrees/api/ffsim.doctree
index 39a84241d..4ed4f0ac1 100644
Binary files a/.doctrees/api/ffsim.doctree and b/.doctrees/api/ffsim.doctree differ
diff --git a/.doctrees/api/ffsim.linalg.doctree b/.doctrees/api/ffsim.linalg.doctree
index ca6754749..649579a2f 100644
Binary files a/.doctrees/api/ffsim.linalg.doctree and b/.doctrees/api/ffsim.linalg.doctree differ
diff --git a/.doctrees/api/ffsim.optimize.doctree b/.doctrees/api/ffsim.optimize.doctree
index 7812705f0..782ec0043 100644
Binary files a/.doctrees/api/ffsim.optimize.doctree and b/.doctrees/api/ffsim.optimize.doctree differ
diff --git a/.doctrees/api/ffsim.qiskit.doctree b/.doctrees/api/ffsim.qiskit.doctree
index b250963b6..5351608dc 100644
Binary files a/.doctrees/api/ffsim.qiskit.doctree and b/.doctrees/api/ffsim.qiskit.doctree differ
diff --git a/.doctrees/api/ffsim.random.doctree b/.doctrees/api/ffsim.random.doctree
index a0b624fe2..170edc9b2 100644
Binary files a/.doctrees/api/ffsim.random.doctree and b/.doctrees/api/ffsim.random.doctree differ
diff --git a/.doctrees/api/ffsim.testing.doctree b/.doctrees/api/ffsim.testing.doctree
index 818312786..17992b187 100644
Binary files a/.doctrees/api/ffsim.testing.doctree and b/.doctrees/api/ffsim.testing.doctree differ
diff --git a/.doctrees/api/index.doctree b/.doctrees/api/index.doctree
index 4dc5fe084..f3bd7c033 100644
Binary files a/.doctrees/api/index.doctree and b/.doctrees/api/index.doctree differ
diff --git a/.doctrees/environment.pickle b/.doctrees/environment.pickle
index c8d4fa171..535f0bb56 100644
Binary files a/.doctrees/environment.pickle and b/.doctrees/environment.pickle differ
diff --git a/.doctrees/explanations/double-factorized.doctree b/.doctrees/explanations/double-factorized.doctree
index f5d60ebc2..b796e19ea 100644
Binary files a/.doctrees/explanations/double-factorized.doctree and b/.doctrees/explanations/double-factorized.doctree differ
diff --git a/.doctrees/explanations/hamiltonians.doctree b/.doctrees/explanations/hamiltonians.doctree
index d5297ca92..9da92663c 100644
Binary files a/.doctrees/explanations/hamiltonians.doctree and b/.doctrees/explanations/hamiltonians.doctree differ
diff --git a/.doctrees/explanations/index.doctree b/.doctrees/explanations/index.doctree
index 31c01b425..db7611fe2 100644
Binary files a/.doctrees/explanations/index.doctree and b/.doctrees/explanations/index.doctree differ
diff --git a/.doctrees/explanations/lucj.doctree b/.doctrees/explanations/lucj.doctree
index 3180618be..f3fd0d42f 100644
Binary files a/.doctrees/explanations/lucj.doctree and b/.doctrees/explanations/lucj.doctree differ
diff --git a/.doctrees/explanations/orbital-rotation.doctree b/.doctrees/explanations/orbital-rotation.doctree
index 5c401d622..328d85828 100644
Binary files a/.doctrees/explanations/orbital-rotation.doctree and b/.doctrees/explanations/orbital-rotation.doctree differ
diff --git a/.doctrees/explanations/qiskit-gate-decompositions.doctree b/.doctrees/explanations/qiskit-gate-decompositions.doctree
index 2f6af504c..d9ff93298 100644
Binary files a/.doctrees/explanations/qiskit-gate-decompositions.doctree and b/.doctrees/explanations/qiskit-gate-decompositions.doctree differ
diff --git a/.doctrees/explanations/state-vectors-and-gates.doctree b/.doctrees/explanations/state-vectors-and-gates.doctree
index 8ea26297c..da84e2652 100644
Binary files a/.doctrees/explanations/state-vectors-and-gates.doctree and b/.doctrees/explanations/state-vectors-and-gates.doctree differ
diff --git a/.doctrees/how-to-guides/entanglement-forging.doctree b/.doctrees/how-to-guides/entanglement-forging.doctree
index 4dbebb338..1e6110b07 100644
Binary files a/.doctrees/how-to-guides/entanglement-forging.doctree and b/.doctrees/how-to-guides/entanglement-forging.doctree differ
diff --git a/.doctrees/how-to-guides/fermion-operator.doctree b/.doctrees/how-to-guides/fermion-operator.doctree
index 2a58d55e9..a06b80ef5 100644
Binary files a/.doctrees/how-to-guides/fermion-operator.doctree and b/.doctrees/how-to-guides/fermion-operator.doctree differ
diff --git a/.doctrees/how-to-guides/index.doctree b/.doctrees/how-to-guides/index.doctree
index 3e7da7913..387f51354 100644
Binary files a/.doctrees/how-to-guides/index.doctree and b/.doctrees/how-to-guides/index.doctree differ
diff --git a/.doctrees/how-to-guides/lucj.doctree b/.doctrees/how-to-guides/lucj.doctree
index e19e1ff61..03612bc96 100644
Binary files a/.doctrees/how-to-guides/lucj.doctree and b/.doctrees/how-to-guides/lucj.doctree differ
diff --git a/.doctrees/how-to-guides/qiskit-circuits.doctree b/.doctrees/how-to-guides/qiskit-circuits.doctree
index 3913e333b..d9759ccdd 100644
Binary files a/.doctrees/how-to-guides/qiskit-circuits.doctree and b/.doctrees/how-to-guides/qiskit-circuits.doctree differ
diff --git a/.doctrees/how-to-guides/qiskit-sampler.doctree b/.doctrees/how-to-guides/qiskit-sampler.doctree
index 57562438f..5a73ec0f7 100644
Binary files a/.doctrees/how-to-guides/qiskit-sampler.doctree and b/.doctrees/how-to-guides/qiskit-sampler.doctree differ
diff --git a/.doctrees/index.doctree b/.doctrees/index.doctree
index 739953f97..7173f2160 100644
Binary files a/.doctrees/index.doctree and b/.doctrees/index.doctree differ
diff --git a/.doctrees/install.doctree b/.doctrees/install.doctree
index 49e98625a..c17e5035b 100644
Binary files a/.doctrees/install.doctree and b/.doctrees/install.doctree differ
diff --git a/.doctrees/nbsphinx/explanations/hamiltonians.ipynb b/.doctrees/nbsphinx/explanations/hamiltonians.ipynb
index f6b911685..2252d2655 100644
--- a/.doctrees/nbsphinx/explanations/hamiltonians.ipynb
+++ b/.doctrees/nbsphinx/explanations/hamiltonians.ipynb
@@ -33,10 +33,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:03.485145Z",
-     "iopub.status.busy": "2024-10-10T17:21:03.484958Z",
-     "iopub.status.idle": "2024-10-10T17:21:04.191751Z",
-     "shell.execute_reply": "2024-10-10T17:21:04.191231Z"
+     "iopub.execute_input": "2024-10-30T17:26:54.772283Z",
+     "iopub.status.busy": "2024-10-30T17:26:54.772070Z",
+     "iopub.status.idle": "2024-10-30T17:26:55.493928Z",
+     "shell.execute_reply": "2024-10-30T17:26:55.493354Z"
     }
    },
    "outputs": [],
@@ -68,10 +68,10 @@
    "execution_count": 2,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:04.194153Z",
-     "iopub.status.busy": "2024-10-10T17:21:04.193867Z",
-     "iopub.status.idle": "2024-10-10T17:21:04.196762Z",
-     "shell.execute_reply": "2024-10-10T17:21:04.196291Z"
+     "iopub.execute_input": "2024-10-30T17:26:55.496452Z",
+     "iopub.status.busy": "2024-10-30T17:26:55.495975Z",
+     "iopub.status.idle": "2024-10-30T17:26:55.499145Z",
+     "shell.execute_reply": "2024-10-30T17:26:55.498671Z"
     }
    },
    "outputs": [],
@@ -99,10 +99,10 @@
    "execution_count": 3,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:04.198510Z",
-     "iopub.status.busy": "2024-10-10T17:21:04.198324Z",
-     "iopub.status.idle": "2024-10-10T17:21:04.201628Z",
-     "shell.execute_reply": "2024-10-10T17:21:04.201061Z"
+     "iopub.execute_input": "2024-10-30T17:26:55.500894Z",
+     "iopub.status.busy": "2024-10-30T17:26:55.500696Z",
+     "iopub.status.idle": "2024-10-30T17:26:55.504318Z",
+     "shell.execute_reply": "2024-10-30T17:26:55.503769Z"
     }
    },
    "outputs": [],
@@ -127,10 +127,10 @@
    "execution_count": 4,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:04.203659Z",
-     "iopub.status.busy": "2024-10-10T17:21:04.203329Z",
-     "iopub.status.idle": "2024-10-10T17:21:04.207886Z",
-     "shell.execute_reply": "2024-10-10T17:21:04.207317Z"
+     "iopub.execute_input": "2024-10-30T17:26:55.506488Z",
+     "iopub.status.busy": "2024-10-30T17:26:55.506167Z",
+     "iopub.status.idle": "2024-10-30T17:26:55.510814Z",
+     "shell.execute_reply": "2024-10-30T17:26:55.510264Z"
     }
    },
    "outputs": [],
@@ -152,17 +152,17 @@
    "execution_count": 5,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:04.210160Z",
-     "iopub.status.busy": "2024-10-10T17:21:04.209747Z",
-     "iopub.status.idle": "2024-10-10T17:21:04.235530Z",
-     "shell.execute_reply": "2024-10-10T17:21:04.234960Z"
+     "iopub.execute_input": "2024-10-30T17:26:55.513724Z",
+     "iopub.status.busy": "2024-10-30T17:26:55.513306Z",
+     "iopub.status.idle": "2024-10-30T17:26:55.541337Z",
+     "shell.execute_reply": "2024-10-30T17:26:55.540634Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "np.float64(-99.55717072551563)"
+       "np.float64(-99.55717072551556)"
       ]
      },
      "execution_count": 5,
@@ -191,10 +191,10 @@
    "execution_count": 6,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:04.270599Z",
-     "iopub.status.busy": "2024-10-10T17:21:04.270067Z",
-     "iopub.status.idle": "2024-10-10T17:21:04.933925Z",
-     "shell.execute_reply": "2024-10-10T17:21:04.933299Z"
+     "iopub.execute_input": "2024-10-30T17:26:55.572876Z",
+     "iopub.status.busy": "2024-10-30T17:26:55.572325Z",
+     "iopub.status.idle": "2024-10-30T17:26:56.238213Z",
+     "shell.execute_reply": "2024-10-30T17:26:56.237552Z"
     }
    },
    "outputs": [
@@ -202,7 +202,7 @@
      "name": "stderr",
      "output_type": "stream",
      "text": [
-      "/tmp/ipykernel_4237/2190712273.py:2: UserWarning: Trace of LinearOperator not available, it will be estimated. Provide `traceA` to ensure performance.\n",
+      "/tmp/ipykernel_4175/2190712273.py:2: UserWarning: Trace of LinearOperator not available, it will be estimated. Provide `traceA` to ensure performance.\n",
       "  evolved_vec = scipy.sparse.linalg.expm_multiply(-1j * time * linop, vec)\n"
      ]
     }
@@ -224,10 +224,10 @@
    "execution_count": 7,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:04.937758Z",
-     "iopub.status.busy": "2024-10-10T17:21:04.936948Z",
-     "iopub.status.idle": "2024-10-10T17:21:05.616394Z",
-     "shell.execute_reply": "2024-10-10T17:21:05.615709Z"
+     "iopub.execute_input": "2024-10-30T17:26:56.240996Z",
+     "iopub.status.busy": "2024-10-30T17:26:56.240500Z",
+     "iopub.status.idle": "2024-10-30T17:26:56.847408Z",
+     "shell.execute_reply": "2024-10-30T17:26:56.846761Z"
     }
    },
    "outputs": [],
diff --git a/.doctrees/nbsphinx/explanations/orbital-rotation.ipynb b/.doctrees/nbsphinx/explanations/orbital-rotation.ipynb
index 4cae8fee3..5c278adb8 100644
--- a/.doctrees/nbsphinx/explanations/orbital-rotation.ipynb
+++ b/.doctrees/nbsphinx/explanations/orbital-rotation.ipynb
@@ -62,10 +62,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:08.707558Z",
-     "iopub.status.busy": "2024-10-10T17:21:08.707362Z",
-     "iopub.status.idle": "2024-10-10T17:21:09.428870Z",
-     "shell.execute_reply": "2024-10-10T17:21:09.428214Z"
+     "iopub.execute_input": "2024-10-30T17:27:00.234613Z",
+     "iopub.status.busy": "2024-10-30T17:27:00.234418Z",
+     "iopub.status.idle": "2024-10-30T17:27:00.990409Z",
+     "shell.execute_reply": "2024-10-30T17:27:00.989866Z"
     }
    },
    "outputs": [],
diff --git a/.doctrees/nbsphinx/explanations/qiskit-gate-decompositions.ipynb b/.doctrees/nbsphinx/explanations/qiskit-gate-decompositions.ipynb
index 64688c307..9096de595 100644
--- a/.doctrees/nbsphinx/explanations/qiskit-gate-decompositions.ipynb
+++ b/.doctrees/nbsphinx/explanations/qiskit-gate-decompositions.ipynb
@@ -16,10 +16,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:10.838944Z",
-     "iopub.status.busy": "2024-10-10T17:21:10.838758Z",
-     "iopub.status.idle": "2024-10-10T17:21:12.521911Z",
-     "shell.execute_reply": "2024-10-10T17:21:12.521256Z"
+     "iopub.execute_input": "2024-10-30T17:27:02.607124Z",
+     "iopub.status.busy": "2024-10-30T17:27:02.606924Z",
+     "iopub.status.idle": "2024-10-30T17:27:06.593316Z",
+     "shell.execute_reply": "2024-10-30T17:27:06.592711Z"
     }
    },
    "outputs": [
@@ -81,10 +81,10 @@
    "execution_count": 2,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:12.524449Z",
-     "iopub.status.busy": "2024-10-10T17:21:12.523996Z",
-     "iopub.status.idle": "2024-10-10T17:21:12.732271Z",
-     "shell.execute_reply": "2024-10-10T17:21:12.731653Z"
+     "iopub.execute_input": "2024-10-30T17:27:06.595577Z",
+     "iopub.status.busy": "2024-10-30T17:27:06.595122Z",
+     "iopub.status.idle": "2024-10-30T17:27:06.806346Z",
+     "shell.execute_reply": "2024-10-30T17:27:06.805818Z"
     }
    },
    "outputs": [
@@ -119,10 +119,10 @@
    "execution_count": 3,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:12.734452Z",
-     "iopub.status.busy": "2024-10-10T17:21:12.734123Z",
-     "iopub.status.idle": "2024-10-10T17:21:12.844935Z",
-     "shell.execute_reply": "2024-10-10T17:21:12.844366Z"
+     "iopub.execute_input": "2024-10-30T17:27:06.808476Z",
+     "iopub.status.busy": "2024-10-30T17:27:06.808177Z",
+     "iopub.status.idle": "2024-10-30T17:27:06.918391Z",
+     "shell.execute_reply": "2024-10-30T17:27:06.917877Z"
     }
    },
    "outputs": [
@@ -156,10 +156,10 @@
    "execution_count": 4,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:12.846966Z",
-     "iopub.status.busy": "2024-10-10T17:21:12.846594Z",
-     "iopub.status.idle": "2024-10-10T17:21:12.957794Z",
-     "shell.execute_reply": "2024-10-10T17:21:12.957286Z"
+     "iopub.execute_input": "2024-10-30T17:27:06.920436Z",
+     "iopub.status.busy": "2024-10-30T17:27:06.920128Z",
+     "iopub.status.idle": "2024-10-30T17:27:07.032871Z",
+     "shell.execute_reply": "2024-10-30T17:27:07.032260Z"
     }
    },
    "outputs": [
@@ -196,10 +196,10 @@
    "execution_count": 5,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:12.959672Z",
-     "iopub.status.busy": "2024-10-10T17:21:12.959480Z",
-     "iopub.status.idle": "2024-10-10T17:21:13.146846Z",
-     "shell.execute_reply": "2024-10-10T17:21:13.146311Z"
+     "iopub.execute_input": "2024-10-30T17:27:07.035167Z",
+     "iopub.status.busy": "2024-10-30T17:27:07.034794Z",
+     "iopub.status.idle": "2024-10-30T17:27:07.222737Z",
+     "shell.execute_reply": "2024-10-30T17:27:07.222077Z"
     }
    },
    "outputs": [
@@ -250,10 +250,10 @@
    "execution_count": 6,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:13.149032Z",
-     "iopub.status.busy": "2024-10-10T17:21:13.148655Z",
-     "iopub.status.idle": "2024-10-10T17:21:13.376897Z",
-     "shell.execute_reply": "2024-10-10T17:21:13.376293Z"
+     "iopub.execute_input": "2024-10-30T17:27:07.225066Z",
+     "iopub.status.busy": "2024-10-30T17:27:07.224663Z",
+     "iopub.status.idle": "2024-10-30T17:27:07.449531Z",
+     "shell.execute_reply": "2024-10-30T17:27:07.448982Z"
     }
    },
    "outputs": [
@@ -292,10 +292,10 @@
    "execution_count": 7,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:13.378856Z",
-     "iopub.status.busy": "2024-10-10T17:21:13.378656Z",
-     "iopub.status.idle": "2024-10-10T17:21:13.518126Z",
-     "shell.execute_reply": "2024-10-10T17:21:13.517518Z"
+     "iopub.execute_input": "2024-10-30T17:27:07.451843Z",
+     "iopub.status.busy": "2024-10-30T17:27:07.451401Z",
+     "iopub.status.idle": "2024-10-30T17:27:07.592320Z",
+     "shell.execute_reply": "2024-10-30T17:27:07.591710Z"
     }
    },
    "outputs": [
@@ -334,10 +334,10 @@
    "execution_count": 8,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:13.520233Z",
-     "iopub.status.busy": "2024-10-10T17:21:13.519894Z",
-     "iopub.status.idle": "2024-10-10T17:21:14.050224Z",
-     "shell.execute_reply": "2024-10-10T17:21:14.049601Z"
+     "iopub.execute_input": "2024-10-30T17:27:07.594907Z",
+     "iopub.status.busy": "2024-10-30T17:27:07.594473Z",
+     "iopub.status.idle": "2024-10-30T17:27:08.139898Z",
+     "shell.execute_reply": "2024-10-30T17:27:08.139294Z"
     }
    },
    "outputs": [
@@ -378,10 +378,10 @@
    "execution_count": 9,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:14.052407Z",
-     "iopub.status.busy": "2024-10-10T17:21:14.052071Z",
-     "iopub.status.idle": "2024-10-10T17:21:14.234624Z",
-     "shell.execute_reply": "2024-10-10T17:21:14.234012Z"
+     "iopub.execute_input": "2024-10-30T17:27:08.142187Z",
+     "iopub.status.busy": "2024-10-30T17:27:08.141809Z",
+     "iopub.status.idle": "2024-10-30T17:27:08.336062Z",
+     "shell.execute_reply": "2024-10-30T17:27:08.335369Z"
     }
    },
    "outputs": [
@@ -430,10 +430,10 @@
    "execution_count": 10,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:14.236774Z",
-     "iopub.status.busy": "2024-10-10T17:21:14.236343Z",
-     "iopub.status.idle": "2024-10-10T17:21:14.406477Z",
-     "shell.execute_reply": "2024-10-10T17:21:14.405936Z"
+     "iopub.execute_input": "2024-10-30T17:27:08.338832Z",
+     "iopub.status.busy": "2024-10-30T17:27:08.338387Z",
+     "iopub.status.idle": "2024-10-30T17:27:08.519514Z",
+     "shell.execute_reply": "2024-10-30T17:27:08.519002Z"
     }
    },
    "outputs": [
@@ -474,10 +474,10 @@
    "execution_count": 11,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:14.408510Z",
-     "iopub.status.busy": "2024-10-10T17:21:14.408306Z",
-     "iopub.status.idle": "2024-10-10T17:21:14.542693Z",
-     "shell.execute_reply": "2024-10-10T17:21:14.542205Z"
+     "iopub.execute_input": "2024-10-30T17:27:08.521659Z",
+     "iopub.status.busy": "2024-10-30T17:27:08.521281Z",
+     "iopub.status.idle": "2024-10-30T17:27:08.652145Z",
+     "shell.execute_reply": "2024-10-30T17:27:08.651538Z"
     }
    },
    "outputs": [
@@ -513,10 +513,10 @@
    "execution_count": 12,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:14.544729Z",
-     "iopub.status.busy": "2024-10-10T17:21:14.544359Z",
-     "iopub.status.idle": "2024-10-10T17:21:14.727510Z",
-     "shell.execute_reply": "2024-10-10T17:21:14.726960Z"
+     "iopub.execute_input": "2024-10-30T17:27:08.654309Z",
+     "iopub.status.busy": "2024-10-30T17:27:08.653918Z",
+     "iopub.status.idle": "2024-10-30T17:27:08.835091Z",
+     "shell.execute_reply": "2024-10-30T17:27:08.834516Z"
     }
    },
    "outputs": [
@@ -553,10 +553,10 @@
    "execution_count": 13,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:14.729474Z",
-     "iopub.status.busy": "2024-10-10T17:21:14.729278Z",
-     "iopub.status.idle": "2024-10-10T17:21:14.892263Z",
-     "shell.execute_reply": "2024-10-10T17:21:14.891740Z"
+     "iopub.execute_input": "2024-10-30T17:27:08.837363Z",
+     "iopub.status.busy": "2024-10-30T17:27:08.836939Z",
+     "iopub.status.idle": "2024-10-30T17:27:08.997578Z",
+     "shell.execute_reply": "2024-10-30T17:27:08.996943Z"
     }
    },
    "outputs": [
@@ -593,10 +593,10 @@
    "execution_count": 14,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:14.894273Z",
-     "iopub.status.busy": "2024-10-10T17:21:14.894078Z",
-     "iopub.status.idle": "2024-10-10T17:21:15.025893Z",
-     "shell.execute_reply": "2024-10-10T17:21:15.025410Z"
+     "iopub.execute_input": "2024-10-30T17:27:08.999532Z",
+     "iopub.status.busy": "2024-10-30T17:27:08.999338Z",
+     "iopub.status.idle": "2024-10-30T17:27:09.132483Z",
+     "shell.execute_reply": "2024-10-30T17:27:09.131862Z"
     }
    },
    "outputs": [
@@ -630,10 +630,10 @@
    "execution_count": 15,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:15.027712Z",
-     "iopub.status.busy": "2024-10-10T17:21:15.027520Z",
-     "iopub.status.idle": "2024-10-10T17:21:15.281421Z",
-     "shell.execute_reply": "2024-10-10T17:21:15.280677Z"
+     "iopub.execute_input": "2024-10-30T17:27:09.134646Z",
+     "iopub.status.busy": "2024-10-30T17:27:09.134280Z",
+     "iopub.status.idle": "2024-10-30T17:27:09.296639Z",
+     "shell.execute_reply": "2024-10-30T17:27:09.296017Z"
     }
    },
    "outputs": [
@@ -677,10 +677,10 @@
    "execution_count": 16,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:15.283721Z",
-     "iopub.status.busy": "2024-10-10T17:21:15.283332Z",
-     "iopub.status.idle": "2024-10-10T17:21:15.375513Z",
-     "shell.execute_reply": "2024-10-10T17:21:15.374999Z"
+     "iopub.execute_input": "2024-10-30T17:27:09.298921Z",
+     "iopub.status.busy": "2024-10-30T17:27:09.298567Z",
+     "iopub.status.idle": "2024-10-30T17:27:09.481927Z",
+     "shell.execute_reply": "2024-10-30T17:27:09.481306Z"
     }
    },
    "outputs": [
@@ -736,16 +736,16 @@
    "execution_count": 17,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:15.377520Z",
-     "iopub.status.busy": "2024-10-10T17:21:15.377187Z",
-     "iopub.status.idle": "2024-10-10T17:21:15.842745Z",
-     "shell.execute_reply": "2024-10-10T17:21:15.842201Z"
+     "iopub.execute_input": "2024-10-30T17:27:09.484154Z",
+     "iopub.status.busy": "2024-10-30T17:27:09.483807Z",
+     "iopub.status.idle": "2024-10-30T17:27:09.944385Z",
+     "shell.execute_reply": "2024-10-30T17:27:09.943758Z"
     }
    },
    "outputs": [
     {
      "data": {
-      "image/png": "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bVq8/ec///mAF00AP//5z5k9ezYjRozg/vvvL27Py8sjNzeXRo0aAdC0adPiocOSJFUmh3odLMuHH35Ix44dSUpKKm470GtjzZo1+frrr8u3cOk7DjYSpqioiPnz5x9wSYp9mjdvzrRp0/joo49466232LlzZ4n9a9asYcGCBbz33ntkZmbSokWLUv3T09OZM2eOS1eoXJX1HL1161Zq164NQK1atdi6dWup2/fu3Zvbb7+d8847r0T/5ORktm3bxubNm1mxYgVvvvkmffr04bnnngN8/yIFmWFXwI0ZM4ZwOMzpp59O+/btD9hn9uzZtGrViurVqx9wf7169QA477zz+Oqrr4rbJ0+eTN++fcu9ZkmSysvhvA4eyjPPPMNPfvKTEm0He22UKsp3R8J89tlnnHXWWWXe5rTTTqNq1aoAJCYmlhrR/84777Bjxw569erFiBEjDtq/efPmLFy4sDwPRyeow3mOrlu3Ltu3bwcgNzeXunXrlurz3nvv8frrrzNixIgS/fPy8qhTpw516tShc+fOVKtWjQsvvJClS5cer0OSVEkYdgXcvk//Hn744RLtaWlp5OTkAPD555/z7rvv0rdvX+bNm8cjjzxSom9ubi4AK1eu5KSTTipunzBhApdffnnxdk5OTpmfJkqSVNEO53XwUFauXMmAAQMYNWoUjz/+ODk5OQd8bdy5c+cB34RJx8N3R8JkZ2fTrFmzw7rtu+++S4sWLUp90Ll582ZCoRDvv/8+q1atYt68eQfs72gYlZfDeY7u0KED06ZNAyheb+vbCgoKAKhTpw41atTgpJNOIjc3l127dhX3P+uss9iwYQORSIQFCxYU/7/i+xcpuJIO3UVBlJKSUjx0/YYbbuCGG24AoE+fPvzyl78E4O6772bUqFHcf//9fPbZZyQkJPDUU08BUFhYyLJly2jVqlXxfU6dOpWLL764Yg9EkqSj8O3XQYDBgwfz/vvvs2LFCkaMGEHv3r2LXwdnzJgBwIsvvkhSUhJNmzbl1ltvLfXaOG3aNC666KKYHI9OHGPGjGHKlCl069btoCNhFi1axK233lqirW/fvjzwwAOsW7eOxx57jDfffLPU7erUqVO8NtK+0S8nn3zyQftLx8u3n6MbNmxI27Zt6d69O23btqVjx45s3LiRsWPHcu+999K/f3/y8/MJhULFz8d33XUXPXv2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",
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAABLsAAAMkCAYAAABQkSLjAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjkuMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8hTgPZAAAACXBIWXMAAA9hAAAPYQGoP6dpAADV7ElEQVR4nOzdeXxTVf7/8VeSlpbSltKyFShtoQXLUtoBQfYAFWUcUUAcRRQRxn0cZhR1WPwyI6joz+Wro6hfZERGFGUYEQdlUSICxcpSdkrLUva1bKV0TX5/RAKhG1Care/n45GHveee5Hzu9ZKcfHLOuQabzWZDRERERERERETEBxjdHYCIiIiIiIiIiMj1omSXiIiIiIiIiIj4DCW7RERERERERETEZyjZJSIiIiIiIiIiPkPJLhERERERERER8RlKdomIiIiIiIiIiM9QsktERERERERERHyGkl0iIiIiIiIiIuIzlOwSERERERERERGfoWSXiIiIiIiIiIj4DCW7RERERERERETEZyjZJSIiIiIiIiIiPkPJLhERERERERER8RlKdomIiIiIiIiIiM9QsktERERERERERHyGkl0iIiIiIiIiIuIzlOwSERERERERERGfoWSXiIiIiIiIiIj4DCW7RERERERERETEZyjZJSIiIiIiIiIiPkPJLhERERERERER8RlKdomIiIiIiIiIiM9QsktERERERERERHyGkl0iIiIiIiIiIuIzlOwSERERERERERGfoWSXiIiIiIiIiIj4DCW7RERERERERETEZyjZJSIiIiIiIiIiPkPJLhERERERERER8Rl+7g7AkxWezePktr3uDsNn1EtoTq2QoErr5RZB1hkXBFSGuFAI9ndP2yIiIiIiIiJSdUp2VeDktr18e8cEd4fhMwbMn0yjzjdUWi/rDIxe6YKAyjC9OyRFuKdtEREREREREak6TWMUERERERERERGfoWSXiIiIiIiIiIj4DCW7RERERERERETEZyjZJSIiIiIiIiIiPkML1ItPyBhv5tz2VAx+/hhMfgQ2vYEmw6cQ2qGfu0MTERERERERERfSyC7xGU2GTyF5Ti6JM49Qp3VXdr50JyXnTrs7LBERERERERFxISW7xOcY/QOof/MorPm55B/Kcnc4IiIiIiIiIuJCSnaJz7EWnOf4kukYg0IJbBLv7nBERERERERE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GA+v2OyU3Er/f184kl+Nu7fj0MrNVW5DREREpDpdGDUwefJkp/K4uDiys7MB2Lx5M0uWLOHWW28lPT2dKVOmONXt3LkzW7ZsIT8/n+Li8n84zMvLIyws7Lofg4iIr7t89G1mZiYxMTEVPufUqVOEhtq/c4eEhHDq1KkK67du3Zoff/wRm83GTz/9xOnTp4mMjCQjI4PFixfzwQcfcOLECQCio6PZsWNHlY5Jqp+SXdUgP+csALUblR6NVbthPXudE2cAOHfgWKk65/Y7l+XuO3ZFI7uKzxdQ8GvbAEGREeRe/lrZRwiKrPrq74dWbKLRTW2oFRpEaIsm7P5qJaZafgRFhhPZox2HftpU5TZERERE3CE8PJy8vDwAHnzwQZYtW8Z3331HUlIS48ePB+Dpp58G4Nlnn2XMmDGYzWaeeeYZAD755BOefvppPv74Y5599lkAli9fTv/+/d1wNCIi3ulKRt9u3boVs9ns9HjllVcICwvjzBn7d+6zZ89W+mPDwIEDOXbsGDfffDMNGjSgYcOGBAQEEBQURO3atenZsyc7d+68zkco1UljravBmZ0HObv3CLEDu3H4shFOsXd04+zeI5zZdQgAm7X0XN86zRo4bQdHNeDYusozxzar1Wk779AJGndte9lrNSTv0Iky61+NnC17sFmttPnD7zj6y3ZsViuHVmym1bAUghrW4+gv26/5tUVERESq24UvReUZOHAgS5cuJSUlxVG2dOlSx9+vv/46AM2aNXMqB3jggQccixlfsGDBAi1qLCJyFS7cMfdy8fHxzJs3D4A2bdpgsVhK1fnll1/47LPPuP3221m+fDl33313hW2ZTCamTZuGzWZjxIgRdO3aldzcXIKDg7HZbKxZs4Ynn3wSgOzsbLp37171A5RqpZFd1STthY+J+30f2j5yO/7BtfEPCaLNI78j7u4+pE38Z4XPbXxTG6L6d8JgMtJicE/qtYlmz39XX3UMu+evolGXBKJv64LBaKRpnySibunEzrnLATh//DR1mta/5rtAHl61hTYP38ahFfZRXIdWbqLNw7dxdO0OSgqKruk1RURERDzBAw884JToqqp3333XcdcvERG5dh06dCAjI6PCOjfeeCMFBQX07NmTDh060KhRIw4fPuy40yJASkoK69evJyUlheXLl2M2m+nXrx933XUXQUFBrFq1ik6dOtGt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5vXXX+e5555jw4YNGI1G3n33XQD+/ve/Y7FYaNq0KR988AFg/xF0wIABbjkeT/DRRx+xdOlSevToUe4ouq1bt/L44487ld16662lZk60bNmywrYGDhzI4sWLufnmm2nQoAENGzYkICDAsb9nz57s3LmTiIiIqh2UiI9RskukBjKbzZjN5nL3Dxw4kKVLl5KSksLEiROZOHGiY1/jxo0ZO3YsYJ+2uHr1aqfnvvfee6Ve78MPP3TazsnJISwsjJCQkCochYiIiIjA1fXt/vWvf5Xa//rrrwNl9+NeeOEFXnjhBaeyn3/+mYcffrhqQXuxUaNGMWHChFLl8fHxzJs3D4A2bdqUeTOmX375hc8++4zbb7+d5cuXc/fdd1fYlslkYtq0adhsNkaMGEHXrl3Jzc0lODgYm83GmjVrePLJJwH7iLvu3btX/QBFfICmMYpIKQ888AApKSnV9vrh4eFau0tERETERa533+6f//wnRqO+Sl6uQ4cOZGRkVFjnxhtvpKCggJ49e9KhQwcaNWrE4cOHHXdaBEhJSWH9+vWkpKSwfPlyzGYz/fr146677iIoKIhVq1bRqVMnunXrRv/+/YmMjATsNyNo165dtR6jiLfQyC4RERERERGRK1DRKDqj0UhiYiKZmZkVrml2YYroBZfOnABYunSp0/7LR4j179+f/v37O5Vt27aNjh07YjAYruAoRHyfkl0iIiIiIiIi10FZ0xtdISEhgYSEBLe0LeKJNPZURERERERERER8hpJdIiIiIiIiIiLiM5TsEhERERERERERn6E1u8Tj5BZB1hn3tB0XCsH+7mlbRERERERERKpOyS7xOFlnYPRK97Q9vTskRbinbRERERERERGpOk1jFBERERERERERn6Fkl4iIiIiIiIiI+Awlu0RERERERERExGdozS7xCRnjzZzbnorBzx+DyY/ApjfQZPgUQjv0c3doIiIiIiIiIuJCGtklPqPJ8Ckkz8klceYR6rTuys6X7qTk3Gl3hyUiIiIiIiIiLqRkl/gco38A9W8ehTU/l/xDWe4OR0RERERERERcSMku8TnWgvMcXzIdY1AogU3i3R2OiIiIiIiIiLiQ1yS7CgsLmThxIlFRUdSuXZu+ffuSlpaGwWBg/vz57g5PPMDB2RNJHxbGpj/EkLd7A3ETvsEUFOrusERERERERETEhbxigXqb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",
       "text/plain": [
        "<Figure size 1547.39x1018.38 with 1 Axes>"
       ]
@@ -776,10 +776,10 @@
    "execution_count": 18,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:15.844900Z",
-     "iopub.status.busy": "2024-10-10T17:21:15.844504Z",
-     "iopub.status.idle": "2024-10-10T17:21:16.106211Z",
-     "shell.execute_reply": "2024-10-10T17:21:16.105617Z"
+     "iopub.execute_input": "2024-10-30T17:27:09.946610Z",
+     "iopub.status.busy": "2024-10-30T17:27:09.946246Z",
+     "iopub.status.idle": "2024-10-30T17:27:10.205482Z",
+     "shell.execute_reply": "2024-10-30T17:27:10.204872Z"
     }
    },
    "outputs": [
diff --git a/.doctrees/nbsphinx/explanations/state-vectors-and-gates.ipynb b/.doctrees/nbsphinx/explanations/state-vectors-and-gates.ipynb
index a8d4b3f18..03037223a 100644
--- a/.doctrees/nbsphinx/explanations/state-vectors-and-gates.ipynb
+++ b/.doctrees/nbsphinx/explanations/state-vectors-and-gates.ipynb
@@ -26,10 +26,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:18.719941Z",
-     "iopub.status.busy": "2024-10-10T17:21:18.719728Z",
-     "iopub.status.idle": "2024-10-10T17:21:19.426888Z",
-     "shell.execute_reply": "2024-10-10T17:21:19.426214Z"
+     "iopub.execute_input": "2024-10-30T17:27:12.686986Z",
+     "iopub.status.busy": "2024-10-30T17:27:12.686516Z",
+     "iopub.status.idle": "2024-10-30T17:27:13.446932Z",
+     "shell.execute_reply": "2024-10-30T17:27:13.446285Z"
     }
    },
    "outputs": [
@@ -74,10 +74,10 @@
    "execution_count": 2,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:19.429569Z",
-     "iopub.status.busy": "2024-10-10T17:21:19.429034Z",
-     "iopub.status.idle": "2024-10-10T17:21:19.436074Z",
-     "shell.execute_reply": "2024-10-10T17:21:19.435556Z"
+     "iopub.execute_input": "2024-10-30T17:27:13.449473Z",
+     "iopub.status.busy": "2024-10-30T17:27:13.448898Z",
+     "iopub.status.idle": "2024-10-30T17:27:13.457314Z",
+     "shell.execute_reply": "2024-10-30T17:27:13.456674Z"
     }
    },
    "outputs": [
@@ -120,10 +120,10 @@
    "execution_count": 3,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:19.438001Z",
-     "iopub.status.busy": "2024-10-10T17:21:19.437662Z",
-     "iopub.status.idle": "2024-10-10T17:21:19.441804Z",
-     "shell.execute_reply": "2024-10-10T17:21:19.441353Z"
+     "iopub.execute_input": "2024-10-30T17:27:13.459711Z",
+     "iopub.status.busy": "2024-10-30T17:27:13.459291Z",
+     "iopub.status.idle": "2024-10-30T17:27:13.464094Z",
+     "shell.execute_reply": "2024-10-30T17:27:13.463424Z"
     }
    },
    "outputs": [
@@ -157,10 +157,10 @@
    "execution_count": 4,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:19.443651Z",
-     "iopub.status.busy": "2024-10-10T17:21:19.443311Z",
-     "iopub.status.idle": "2024-10-10T17:21:19.447166Z",
-     "shell.execute_reply": "2024-10-10T17:21:19.446717Z"
+     "iopub.execute_input": "2024-10-30T17:27:13.466363Z",
+     "iopub.status.busy": "2024-10-30T17:27:13.465887Z",
+     "iopub.status.idle": "2024-10-30T17:27:13.470532Z",
+     "shell.execute_reply": "2024-10-30T17:27:13.469937Z"
     }
    },
    "outputs": [
@@ -199,10 +199,10 @@
    "execution_count": 5,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:19.449198Z",
-     "iopub.status.busy": "2024-10-10T17:21:19.448854Z",
-     "iopub.status.idle": "2024-10-10T17:21:19.454457Z",
-     "shell.execute_reply": "2024-10-10T17:21:19.453944Z"
+     "iopub.execute_input": "2024-10-30T17:27:13.472845Z",
+     "iopub.status.busy": "2024-10-30T17:27:13.472504Z",
+     "iopub.status.idle": "2024-10-30T17:27:13.478847Z",
+     "shell.execute_reply": "2024-10-30T17:27:13.478263Z"
     }
    },
    "outputs": [
@@ -245,10 +245,10 @@
    "execution_count": 6,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:19.456383Z",
-     "iopub.status.busy": "2024-10-10T17:21:19.456043Z",
-     "iopub.status.idle": "2024-10-10T17:21:19.461634Z",
-     "shell.execute_reply": "2024-10-10T17:21:19.461104Z"
+     "iopub.execute_input": "2024-10-30T17:27:13.480833Z",
+     "iopub.status.busy": "2024-10-30T17:27:13.480646Z",
+     "iopub.status.idle": "2024-10-30T17:27:13.488132Z",
+     "shell.execute_reply": "2024-10-30T17:27:13.487481Z"
     }
    },
    "outputs": [
@@ -293,10 +293,10 @@
    "execution_count": 7,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:19.463650Z",
-     "iopub.status.busy": "2024-10-10T17:21:19.463330Z",
-     "iopub.status.idle": "2024-10-10T17:21:19.468339Z",
-     "shell.execute_reply": "2024-10-10T17:21:19.467756Z"
+     "iopub.execute_input": "2024-10-30T17:27:13.490610Z",
+     "iopub.status.busy": "2024-10-30T17:27:13.490421Z",
+     "iopub.status.idle": "2024-10-30T17:27:13.495381Z",
+     "shell.execute_reply": "2024-10-30T17:27:13.494922Z"
     }
    },
    "outputs": [
diff --git a/.doctrees/nbsphinx/explanations_qiskit-gate-decompositions_34_0.png b/.doctrees/nbsphinx/explanations_qiskit-gate-decompositions_34_0.png
index b7cb42826..25955e9e6 100644
Binary files a/.doctrees/nbsphinx/explanations_qiskit-gate-decompositions_34_0.png and b/.doctrees/nbsphinx/explanations_qiskit-gate-decompositions_34_0.png differ
diff --git a/.doctrees/nbsphinx/how-to-guides/entanglement-forging.ipynb b/.doctrees/nbsphinx/how-to-guides/entanglement-forging.ipynb
index 50b26c599..df39b9664 100644
--- a/.doctrees/nbsphinx/how-to-guides/entanglement-forging.ipynb
+++ b/.doctrees/nbsphinx/how-to-guides/entanglement-forging.ipynb
@@ -18,10 +18,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:21.297389Z",
-     "iopub.status.busy": "2024-10-10T17:21:21.296950Z",
-     "iopub.status.idle": "2024-10-10T17:21:22.176916Z",
-     "shell.execute_reply": "2024-10-10T17:21:22.176304Z"
+     "iopub.execute_input": "2024-10-30T17:27:15.162383Z",
+     "iopub.status.busy": "2024-10-30T17:27:15.161905Z",
+     "iopub.status.idle": "2024-10-30T17:27:16.189261Z",
+     "shell.execute_reply": "2024-10-30T17:27:16.188626Z"
     }
    },
    "outputs": [
@@ -36,7 +36,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Parsing /tmp/tmpfo16w5i1\n",
+      "Parsing /tmp/tmpjuqvvg3m\n",
       "converged SCF energy = -75.6787887956314\n"
      ]
     },
@@ -59,7 +59,7 @@
      "name": "stderr",
      "output_type": "stream",
      "text": [
-      "Overwritten attributes  get_hcore get_ovlp  of <class 'pyscf.scf.hf.RHF'>\n",
+      "Overwritten attributes  get_ovlp get_hcore  of <class 'pyscf.scf.hf.RHF'>\n",
       "/home/runner/work/ffsim/ffsim/.tox/docs/lib/python3.12/site-packages/pyscf/gto/mole.py:1294: UserWarning: Function mol.dumps drops attribute energy_nuc because it is not JSON-serializable\n",
       "  warnings.warn(msg)\n",
       "/home/runner/work/ffsim/ffsim/.tox/docs/lib/python3.12/site-packages/pyscf/gto/mole.py:1294: UserWarning: Function mol.dumps drops attribute intor_symmetric because it is not JSON-serializable\n",
@@ -125,10 +125,10 @@
    "execution_count": 2,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:22.179665Z",
-     "iopub.status.busy": "2024-10-10T17:21:22.179197Z",
-     "iopub.status.idle": "2024-10-10T17:21:22.187320Z",
-     "shell.execute_reply": "2024-10-10T17:21:22.186782Z"
+     "iopub.execute_input": "2024-10-30T17:27:16.192782Z",
+     "iopub.status.busy": "2024-10-30T17:27:16.191812Z",
+     "iopub.status.idle": "2024-10-30T17:27:16.197126Z",
+     "shell.execute_reply": "2024-10-30T17:27:16.196496Z"
     }
    },
    "outputs": [],
@@ -168,10 +168,10 @@
    "execution_count": 3,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:22.190592Z",
-     "iopub.status.busy": "2024-10-10T17:21:22.189798Z",
-     "iopub.status.idle": "2024-10-10T17:21:22.194034Z",
-     "shell.execute_reply": "2024-10-10T17:21:22.193504Z"
+     "iopub.execute_input": "2024-10-30T17:27:16.199239Z",
+     "iopub.status.busy": "2024-10-30T17:27:16.198907Z",
+     "iopub.status.idle": "2024-10-30T17:27:16.202157Z",
+     "shell.execute_reply": "2024-10-30T17:27:16.201587Z"
     }
    },
    "outputs": [],
@@ -200,10 +200,10 @@
    "execution_count": 4,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:22.197268Z",
-     "iopub.status.busy": "2024-10-10T17:21:22.196465Z",
-     "iopub.status.idle": "2024-10-10T17:21:22.332000Z",
-     "shell.execute_reply": "2024-10-10T17:21:22.331466Z"
+     "iopub.execute_input": "2024-10-30T17:27:16.204104Z",
+     "iopub.status.busy": "2024-10-30T17:27:16.203683Z",
+     "iopub.status.idle": "2024-10-30T17:27:16.329816Z",
+     "shell.execute_reply": "2024-10-30T17:27:16.329288Z"
     }
    },
    "outputs": [
@@ -211,7 +211,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Energy at initialialization: -75.67794403659725\n"
+      "Energy at initialialization: -75.67794403659722\n"
      ]
     }
    ],
@@ -238,10 +238,10 @@
    "execution_count": 5,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:22.334154Z",
-     "iopub.status.busy": "2024-10-10T17:21:22.333777Z",
-     "iopub.status.idle": "2024-10-10T17:21:30.189519Z",
-     "shell.execute_reply": "2024-10-10T17:21:30.188878Z"
+     "iopub.execute_input": "2024-10-30T17:27:16.331912Z",
+     "iopub.status.busy": "2024-10-30T17:27:16.331528Z",
+     "iopub.status.idle": "2024-10-30T17:27:24.335381Z",
+     "shell.execute_reply": "2024-10-30T17:27:24.334806Z"
     }
    },
    "outputs": [
@@ -253,10 +253,10 @@
       "  message: STOP: TOTAL NO. of f AND g EVALUATIONS EXCEEDS LIMIT\n",
       "  success: False\n",
       "   status: 1\n",
-      "      fun: -75.68381563541598\n",
-      "        x: [-1.603e-01  6.417e-03 ...  5.748e-02 -1.005e-01]\n",
+      "      fun: -75.68381560472928\n",
+      "        x: [-1.603e-01  6.420e-03 ...  5.748e-02 -1.005e-01]\n",
       "      nit: 3\n",
-      "      jac: [ 2.174e-04  1.108e-04 ... -4.748e-03  7.435e-03]\n",
+      "      jac: [ 2.146e-04  1.094e-04 ... -4.751e-03  7.424e-03]\n",
       "     nfev: 112\n",
       "     njev: 7\n",
       " hess_inv: <15x15 LbfgsInvHessProduct with dtype=float64>\n"
diff --git a/.doctrees/nbsphinx/how-to-guides/fermion-operator.ipynb b/.doctrees/nbsphinx/how-to-guides/fermion-operator.ipynb
index 49adb9e3e..02901c580 100644
--- a/.doctrees/nbsphinx/how-to-guides/fermion-operator.ipynb
+++ b/.doctrees/nbsphinx/how-to-guides/fermion-operator.ipynb
@@ -29,10 +29,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:31.695901Z",
-     "iopub.status.busy": "2024-10-10T17:21:31.695687Z",
-     "iopub.status.idle": "2024-10-10T17:21:32.411527Z",
-     "shell.execute_reply": "2024-10-10T17:21:32.410915Z"
+     "iopub.execute_input": "2024-10-30T17:27:26.120139Z",
+     "iopub.status.busy": "2024-10-30T17:27:26.119528Z",
+     "iopub.status.idle": "2024-10-30T17:27:26.847863Z",
+     "shell.execute_reply": "2024-10-30T17:27:26.847316Z"
     }
    },
    "outputs": [
@@ -76,10 +76,10 @@
    "execution_count": 2,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:32.413794Z",
-     "iopub.status.busy": "2024-10-10T17:21:32.413364Z",
-     "iopub.status.idle": "2024-10-10T17:21:32.417558Z",
-     "shell.execute_reply": "2024-10-10T17:21:32.417078Z"
+     "iopub.execute_input": "2024-10-30T17:27:26.850083Z",
+     "iopub.status.busy": "2024-10-30T17:27:26.849602Z",
+     "iopub.status.idle": "2024-10-30T17:27:26.853689Z",
+     "shell.execute_reply": "2024-10-30T17:27:26.853139Z"
     }
    },
    "outputs": [
@@ -110,10 +110,10 @@
    "execution_count": 3,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:32.419324Z",
-     "iopub.status.busy": "2024-10-10T17:21:32.419143Z",
-     "iopub.status.idle": "2024-10-10T17:21:32.423352Z",
-     "shell.execute_reply": "2024-10-10T17:21:32.422897Z"
+     "iopub.execute_input": "2024-10-30T17:27:26.855622Z",
+     "iopub.status.busy": "2024-10-30T17:27:26.855205Z",
+     "iopub.status.idle": "2024-10-30T17:27:26.859459Z",
+     "shell.execute_reply": "2024-10-30T17:27:26.859004Z"
     }
    },
    "outputs": [
@@ -121,17 +121,17 @@
      "data": {
       "text/plain": [
        "FermionOperator({\n",
+       "    (cre_a(3), des_a(0)): -0.5,\n",
        "    (cre_b(2)): 0-0.25j,\n",
-       "    (cre_a(3), des_a(0), cre_b(2)): 0-0.25j,\n",
-       "    (cre_a(3), des_a(0), des_a(3), des_b(3)): 0.0625,\n",
        "    (des_a(3), des_b(3)): 0.0625,\n",
+       "    (cre_a(0), des_a(3), cre_b(2)): 0+0.5j,\n",
+       "    (cre_b(1), des_b(5), cre_a(4), cre_b(2)): -1+1j,\n",
        "    (cre_a(0), des_a(3)): 1,\n",
        "    (cre_b(1), des_b(5), cre_a(4)): 2+2j,\n",
-       "    (cre_b(1), des_b(5), cre_a(4), cre_b(2)): -1+1j,\n",
-       "    (cre_a(3), des_a(0)): -0.5,\n",
+       "    (cre_a(3), des_a(0), des_a(3), des_b(3)): 0.0625,\n",
        "    (cre_b(1), des_b(5), cre_a(4), des_a(3), des_b(3)): -0.25-0.25j,\n",
-       "    (cre_a(0), des_a(3), cre_b(2)): 0+0.5j,\n",
-       "    (cre_a(0), des_a(3), des_a(3), des_b(3)): -0.125\n",
+       "    (cre_a(0), des_a(3), des_a(3), des_b(3)): -0.125,\n",
+       "    (cre_a(3), des_a(0), cre_b(2)): 0-0.25j\n",
        "})"
       ]
      },
@@ -170,10 +170,10 @@
    "execution_count": 4,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:32.425182Z",
-     "iopub.status.busy": "2024-10-10T17:21:32.424997Z",
-     "iopub.status.idle": "2024-10-10T17:21:32.428839Z",
-     "shell.execute_reply": "2024-10-10T17:21:32.428366Z"
+     "iopub.execute_input": "2024-10-30T17:27:26.861444Z",
+     "iopub.status.busy": "2024-10-30T17:27:26.860952Z",
+     "iopub.status.idle": "2024-10-30T17:27:26.864613Z",
+     "shell.execute_reply": "2024-10-30T17:27:26.864162Z"
     }
    },
    "outputs": [
@@ -181,17 +181,17 @@
      "data": {
       "text/plain": [
        "FermionOperator({\n",
+       "    (cre_a(3), des_a(0)): 0+3j,\n",
        "    (cre_b(2)): -5,\n",
-       "    (cre_a(3), des_a(0), cre_b(2)): -1,\n",
-       "    (cre_a(3), des_a(0), des_a(3), des_b(3)): 0-0.25j,\n",
        "    (des_a(3), des_b(3)): 0-1.25j,\n",
+       "    (cre_a(0), des_a(3), cre_b(2)): 2,\n",
+       "    (cre_b(1), des_b(5), cre_a(4), cre_b(2)): 4+4j,\n",
        "    (cre_a(0), des_a(3)): 0-6j,\n",
        "    (cre_b(1), des_b(5), cre_a(4)): 12-12j,\n",
-       "    (cre_b(1), des_b(5), cre_a(4), cre_b(2)): 4+4j,\n",
-       "    (cre_a(3), des_a(0)): 0+3j,\n",
+       "    (cre_a(3), des_a(0), des_a(3), des_b(3)): 0-0.25j,\n",
        "    (cre_b(1), des_b(5), cre_a(4), des_a(3), des_b(3)): -1+1j,\n",
-       "    (cre_a(0), des_a(3), cre_b(2)): 2,\n",
-       "    (cre_a(0), des_a(3), des_a(3), des_b(3)): 0+0.5j\n",
+       "    (cre_a(0), des_a(3), des_a(3), des_b(3)): 0+0.5j,\n",
+       "    (cre_a(3), des_a(0), cre_b(2)): -1\n",
        "})"
       ]
      },
@@ -220,10 +220,10 @@
    "execution_count": 5,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:32.430545Z",
-     "iopub.status.busy": "2024-10-10T17:21:32.430362Z",
-     "iopub.status.idle": "2024-10-10T17:21:32.434150Z",
-     "shell.execute_reply": "2024-10-10T17:21:32.433667Z"
+     "iopub.execute_input": "2024-10-30T17:27:26.866792Z",
+     "iopub.status.busy": "2024-10-30T17:27:26.866326Z",
+     "iopub.status.idle": "2024-10-30T17:27:26.870321Z",
+     "shell.execute_reply": "2024-10-30T17:27:26.869858Z"
     }
    },
    "outputs": [
@@ -231,16 +231,16 @@
      "data": {
       "text/plain": [
        "FermionOperator({\n",
-       "    (cre_a(3), des_b(3), des_a(3), des_a(0)): 0+0.25j,\n",
-       "    (cre_b(1), cre_a(4), des_b(5), des_b(3), des_a(3)): -1+1j,\n",
-       "    (cre_b(2), cre_a(0), des_a(3)): 2,\n",
        "    (cre_b(2), cre_a(3), des_a(0)): -1,\n",
+       "    (cre_a(3), des_b(3), des_a(3), des_a(0)): 0+0.25j,\n",
        "    (cre_b(2)): -5,\n",
-       "    (des_b(3), des_a(3)): 0+1.25j,\n",
        "    (cre_b(2), cre_b(1), cre_a(4), des_b(5)): 4+4j,\n",
-       "    (cre_a(3), des_a(0)): 0+3j,\n",
+       "    (cre_b(1), cre_a(4), des_b(5), des_b(3), des_a(3)): -1+1j,\n",
+       "    (cre_b(2), cre_a(0), des_a(3)): 2,\n",
        "    (cre_b(1), cre_a(4), des_b(5)): -12+12j,\n",
-       "    (cre_a(0), des_a(3)): 0-6j\n",
+       "    (des_b(3), des_a(3)): 0+1.25j,\n",
+       "    (cre_a(0), des_a(3)): 0-6j,\n",
+       "    (cre_a(3), des_a(0)): 0+3j\n",
        "})"
       ]
      },
@@ -265,10 +265,10 @@
    "execution_count": 6,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:32.436030Z",
-     "iopub.status.busy": "2024-10-10T17:21:32.435844Z",
-     "iopub.status.idle": "2024-10-10T17:21:32.438868Z",
-     "shell.execute_reply": "2024-10-10T17:21:32.438410Z"
+     "iopub.execute_input": "2024-10-30T17:27:26.872053Z",
+     "iopub.status.busy": "2024-10-30T17:27:26.871866Z",
+     "iopub.status.idle": "2024-10-30T17:27:26.875188Z",
+     "shell.execute_reply": "2024-10-30T17:27:26.874630Z"
     }
    },
    "outputs": [
@@ -298,10 +298,10 @@
    "execution_count": 7,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:32.440768Z",
-     "iopub.status.busy": "2024-10-10T17:21:32.440413Z",
-     "iopub.status.idle": "2024-10-10T17:21:32.444300Z",
-     "shell.execute_reply": "2024-10-10T17:21:32.443803Z"
+     "iopub.execute_input": "2024-10-30T17:27:26.877127Z",
+     "iopub.status.busy": "2024-10-30T17:27:26.876916Z",
+     "iopub.status.idle": "2024-10-30T17:27:26.880703Z",
+     "shell.execute_reply": "2024-10-30T17:27:26.880242Z"
     }
    },
    "outputs": [
@@ -341,21 +341,21 @@
    "execution_count": 8,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:32.446100Z",
-     "iopub.status.busy": "2024-10-10T17:21:32.445912Z",
-     "iopub.status.idle": "2024-10-10T17:21:32.451783Z",
-     "shell.execute_reply": "2024-10-10T17:21:32.451208Z"
+     "iopub.execute_input": "2024-10-30T17:27:26.882731Z",
+     "iopub.status.busy": "2024-10-30T17:27:26.882374Z",
+     "iopub.status.idle": "2024-10-30T17:27:26.888475Z",
+     "shell.execute_reply": "2024-10-30T17:27:26.887882Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "array([ 0.        +0.j      ,  0.        +0.j      ,\n",
-       "        0.        +0.j      ,  0.        +0.j      ,\n",
-       "       -0.06944034+0.086307j,  0.        +0.j      ,\n",
-       "        0.        +0.j      ,  0.        +0.j      ,\n",
-       "        0.        +0.j      ])"
+       "array([ 0.        +0.j        ,  0.        +0.j        ,\n",
+       "        0.        +0.j        ,  0.        +0.j        ,\n",
+       "       -0.15212504+0.07716715j,  0.        +0.j        ,\n",
+       "        0.        +0.j        ,  0.        +0.j        ,\n",
+       "        0.        +0.j        ])"
       ]
      },
      "execution_count": 8,
@@ -380,10 +380,10 @@
    "execution_count": 9,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:32.453763Z",
-     "iopub.status.busy": "2024-10-10T17:21:32.453548Z",
-     "iopub.status.idle": "2024-10-10T17:21:32.464893Z",
-     "shell.execute_reply": "2024-10-10T17:21:32.464411Z"
+     "iopub.execute_input": "2024-10-30T17:27:26.890274Z",
+     "iopub.status.busy": "2024-10-30T17:27:26.890084Z",
+     "iopub.status.idle": "2024-10-30T17:27:26.900982Z",
+     "shell.execute_reply": "2024-10-30T17:27:26.900414Z"
     }
    },
    "outputs": [
diff --git a/.doctrees/nbsphinx/how-to-guides/lucj.ipynb b/.doctrees/nbsphinx/how-to-guides/lucj.ipynb
index 7e6b1619f..03399ab16 100644
--- a/.doctrees/nbsphinx/how-to-guides/lucj.ipynb
+++ b/.doctrees/nbsphinx/how-to-guides/lucj.ipynb
@@ -16,10 +16,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:34.169724Z",
-     "iopub.status.busy": "2024-10-10T17:21:34.169540Z",
-     "iopub.status.idle": "2024-10-10T17:21:35.154219Z",
-     "shell.execute_reply": "2024-10-10T17:21:35.153561Z"
+     "iopub.execute_input": "2024-10-30T17:27:28.828546Z",
+     "iopub.status.busy": "2024-10-30T17:27:28.828095Z",
+     "iopub.status.idle": "2024-10-30T17:27:29.851176Z",
+     "shell.execute_reply": "2024-10-30T17:27:29.850524Z"
     }
    },
    "outputs": [
@@ -34,7 +34,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Parsing /tmp/tmpk6ithy5m\n",
+      "Parsing /tmp/tmptvm74xlu\n",
       "converged SCF energy = -77.8266321248744\n"
      ]
     },
@@ -42,7 +42,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "CASCI E = -77.8742165643862  E(CI) = -4.02122442107772  S^2 = 0.0000000\n"
+      "CASCI E = -77.8742165643862  E(CI) = -4.02122442107773  S^2 = 0.0000000\n"
      ]
     },
     {
@@ -57,7 +57,7 @@
      "name": "stderr",
      "output_type": "stream",
      "text": [
-      "Overwritten attributes  get_hcore get_ovlp  of <class 'pyscf.scf.hf.RHF'>\n",
+      "Overwritten attributes  get_ovlp get_hcore  of <class 'pyscf.scf.hf.RHF'>\n",
       "/home/runner/work/ffsim/ffsim/.tox/docs/lib/python3.12/site-packages/pyscf/gto/mole.py:1294: UserWarning: Function mol.dumps drops attribute energy_nuc because it is not JSON-serializable\n",
       "  warnings.warn(msg)\n",
       "/home/runner/work/ffsim/ffsim/.tox/docs/lib/python3.12/site-packages/pyscf/gto/mole.py:1294: UserWarning: Function mol.dumps drops attribute intor_symmetric because it is not JSON-serializable\n",
@@ -123,10 +123,10 @@
    "execution_count": 2,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:35.157196Z",
-     "iopub.status.busy": "2024-10-10T17:21:35.156542Z",
-     "iopub.status.idle": "2024-10-10T17:21:35.228394Z",
-     "shell.execute_reply": "2024-10-10T17:21:35.227836Z"
+     "iopub.execute_input": "2024-10-30T17:27:29.854348Z",
+     "iopub.status.busy": "2024-10-30T17:27:29.853810Z",
+     "iopub.status.idle": "2024-10-30T17:27:29.931938Z",
+     "shell.execute_reply": "2024-10-30T17:27:29.931310Z"
     }
    },
    "outputs": [
@@ -134,14 +134,14 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "E(CCSD) = -77.87421536374029  E_corr = -0.04758323886585568\n"
+      "E(CCSD) = -77.87421536374029  E_corr = -0.04758323886584753\n"
      ]
     },
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Energy at initialization: -77.87160024816285\n"
+      "Energy at initialization: -77.87160024816274\n"
      ]
     },
     {
@@ -189,10 +189,10 @@
    "execution_count": 3,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:35.230943Z",
-     "iopub.status.busy": "2024-10-10T17:21:35.230721Z",
-     "iopub.status.idle": "2024-10-10T17:23:20.436643Z",
-     "shell.execute_reply": "2024-10-10T17:23:20.436053Z"
+     "iopub.execute_input": "2024-10-30T17:27:29.934971Z",
+     "iopub.status.busy": "2024-10-30T17:27:29.934555Z",
+     "iopub.status.idle": "2024-10-30T17:29:15.163148Z",
+     "shell.execute_reply": "2024-10-30T17:29:15.162577Z"
     }
    },
    "outputs": [
@@ -204,10 +204,10 @@
       "  message: STOP: TOTAL NO. of ITERATIONS REACHED LIMIT\n",
       "  success: False\n",
       "   status: 1\n",
-      "      fun: -77.87387394279139\n",
-      "        x: [-1.153e+00 -5.246e-04 ...  2.524e-04  1.287e-01]\n",
+      "      fun: -77.87387391422578\n",
+      "        x: [-1.152e+00 -4.460e-04 ...  1.090e-04  1.286e-01]\n",
       "      nit: 10\n",
-      "      jac: [ 2.558e-05  3.126e-05 ...  1.990e-05  1.563e-05]\n",
+      "      jac: [ 1.421e-05 -7.105e-06 ...  4.263e-06  1.705e-05]\n",
       "     nfev: 949\n",
       "     njev: 13\n",
       " hess_inv: <72x72 LbfgsInvHessProduct with dtype=float64>\n"
@@ -251,10 +251,10 @@
    "execution_count": 4,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:23:20.439256Z",
-     "iopub.status.busy": "2024-10-10T17:23:20.438868Z",
-     "iopub.status.idle": "2024-10-10T17:23:55.278873Z",
-     "shell.execute_reply": "2024-10-10T17:23:55.278241Z"
+     "iopub.execute_input": "2024-10-30T17:29:15.166044Z",
+     "iopub.status.busy": "2024-10-30T17:29:15.165703Z",
+     "iopub.status.idle": "2024-10-30T17:29:51.503695Z",
+     "shell.execute_reply": "2024-10-30T17:29:51.503127Z"
     }
    },
    "outputs": [
@@ -266,10 +266,10 @@
       "  message: CONVERGENCE: REL_REDUCTION_OF_F_<=_FACTR*EPSMCH\n",
       "  success: True\n",
       "   status: 0\n",
-      "      fun: -77.87363426711082\n",
-      "        x: [-1.152e+00 -5.221e-05 ...  3.520e-02  2.561e-01]\n",
+      "      fun: -77.87363426535352\n",
+      "        x: [-1.152e+00 -3.913e-05 ...  3.519e-02  2.561e-01]\n",
       "      nit: 5\n",
-      "      jac: [ 4.405e-05  1.990e-05 ...  1.421e-06 -4.263e-06]\n",
+      "      jac: [-2.700e-05  0.000e+00 ...  0.000e+00 -4.263e-06]\n",
       "     nfev: 329\n",
       "     njev: 7\n",
       " hess_inv: <46x46 LbfgsInvHessProduct with dtype=float64>\n"
@@ -314,10 +314,10 @@
    "execution_count": 5,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:23:55.281548Z",
-     "iopub.status.busy": "2024-10-10T17:23:55.281323Z",
-     "iopub.status.idle": "2024-10-10T17:24:17.538470Z",
-     "shell.execute_reply": "2024-10-10T17:24:17.537902Z"
+     "iopub.execute_input": "2024-10-30T17:29:51.507188Z",
+     "iopub.status.busy": "2024-10-30T17:29:51.506397Z",
+     "iopub.status.idle": "2024-10-30T17:30:14.767738Z",
+     "shell.execute_reply": "2024-10-30T17:30:14.767155Z"
     }
    },
    "outputs": [
@@ -328,29 +328,29 @@
       "Number of parameters: 46\n",
       " message: Convergence: Relative reduction of objective function <= ftol.\n",
       " success: True\n",
-      "     fun: -77.87363431320702\n",
-      "       x: [-1.152e+00  3.624e-04 ...  3.488e-02  2.558e-01]\n",
+      "     fun: -77.87363433826606\n",
+      "       x: [-1.151e+00 -4.937e-04 ...  3.455e-02  2.562e-01]\n",
       "     nit: 3\n",
-      "     jac: [ 1.529e-06  3.657e-06 ... -1.537e-07 -6.623e-07]\n",
-      "    nfev: 559\n",
+      "     jac: [ 5.087e-07  2.242e-08 ... -5.690e-08  1.230e-07]\n",
+      "    nfev: 568\n",
       "    njev: 4\n",
-      "  nlinop: 375\n",
+      "  nlinop: 384\n",
       "\n",
       "Iteration 1\n",
-      "    Energy: -77.87363199406526\n",
-      "    Norm of gradient: 0.0010966013623508449\n",
-      "    Regularization hyperparameter: 0.0019345284203860285\n",
-      "    Variation hyperparameter: 0.9994348455232611\n",
+      "    Energy: -77.87363069599299\n",
+      "    Norm of gradient: 0.0012186049723606237\n",
+      "    Regularization hyperparameter: 0.0010963985209662588\n",
+      "    Variation hyperparameter: 0.9936417698594683\n",
       "Iteration 2\n",
-      "    Energy: -77.87363429661693\n",
-      "    Norm of gradient: 5.813579097194513e-05\n",
-      "    Regularization hyperparameter: 0.0019345282363449037\n",
-      "    Variation hyperparameter: 0.9994348455194204\n",
+      "    Energy: -77.8736342817356\n",
+      "    Norm of gradient: 7.743704662632361e-05\n",
+      "    Regularization hyperparameter: 0.0043114907894774524\n",
+      "    Variation hyperparameter: 0.9923307413892999\n",
       "Iteration 3\n",
-      "    Energy: -77.87363431320702\n",
-      "    Norm of gradient: 1.3773990245482654e-05\n",
-      "    Regularization hyperparameter: 0.013134424201630223\n",
-      "    Variation hyperparameter: 0.9994145851204197\n"
+      "    Energy: -77.87363433826606\n",
+      "    Norm of gradient: 1.1816193567350311e-05\n",
+      "    Regularization hyperparameter: 0.003169753739017794\n",
+      "    Variation hyperparameter: 0.9923426063078371\n"
      ]
     }
    ],
diff --git a/.doctrees/nbsphinx/how-to-guides/qiskit-circuits.ipynb b/.doctrees/nbsphinx/how-to-guides/qiskit-circuits.ipynb
index 25a3f7e46..af5800ae3 100644
--- a/.doctrees/nbsphinx/how-to-guides/qiskit-circuits.ipynb
+++ b/.doctrees/nbsphinx/how-to-guides/qiskit-circuits.ipynb
@@ -16,10 +16,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:19.152011Z",
-     "iopub.status.busy": "2024-10-10T17:24:19.151803Z",
-     "iopub.status.idle": "2024-10-10T17:24:19.856823Z",
-     "shell.execute_reply": "2024-10-10T17:24:19.856281Z"
+     "iopub.execute_input": "2024-10-30T17:30:16.531601Z",
+     "iopub.status.busy": "2024-10-30T17:30:16.531142Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.239849Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.239311Z"
     }
    },
    "outputs": [],
@@ -54,10 +54,10 @@
    "execution_count": 2,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:19.859167Z",
-     "iopub.status.busy": "2024-10-10T17:24:19.858867Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.437039Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.436447Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.242358Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.241853Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.823455Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.822798Z"
     }
    },
    "outputs": [
@@ -103,10 +103,10 @@
    "execution_count": 3,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:20.439573Z",
-     "iopub.status.busy": "2024-10-10T17:24:20.438877Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.498274Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.497674Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.825867Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.825368Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.886715Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.886157Z"
     }
    },
    "outputs": [
@@ -160,17 +160,17 @@
    "execution_count": 4,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:20.500276Z",
-     "iopub.status.busy": "2024-10-10T17:24:20.499917Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.504080Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.503453Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.888807Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.888583Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.893057Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.892426Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "<qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc37cd0>"
+       "<qiskit.circuit.instructionset.InstructionSet at 0x7f6ca5943490>"
       ]
      },
      "execution_count": 4,
@@ -195,17 +195,17 @@
    "execution_count": 5,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:20.506162Z",
-     "iopub.status.busy": "2024-10-10T17:24:20.505797Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.510487Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.510017Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.895198Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.894693Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.899975Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.899488Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "<qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc36560>"
+       "<qiskit.circuit.instructionset.InstructionSet at 0x7f6ca5941ea0>"
       ]
      },
      "execution_count": 5,
@@ -242,17 +242,17 @@
    "execution_count": 6,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:20.512512Z",
-     "iopub.status.busy": "2024-10-10T17:24:20.512033Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.516570Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.515979Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.902445Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.901929Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.906990Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.906379Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "<qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc35f30>"
+       "<qiskit.circuit.instructionset.InstructionSet at 0x7f6ca5862aa0>"
       ]
      },
      "execution_count": 6,
@@ -279,17 +279,17 @@
    "execution_count": 7,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:20.518584Z",
-     "iopub.status.busy": "2024-10-10T17:24:20.518392Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.522744Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.522132Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.909022Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.908646Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.913457Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.912840Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "<qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc36230>"
+       "<qiskit.circuit.instructionset.InstructionSet at 0x7f6ca5940880>"
       ]
      },
      "execution_count": 7,
@@ -315,17 +315,17 @@
    "execution_count": 8,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:20.524666Z",
-     "iopub.status.busy": "2024-10-10T17:24:20.524461Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.528840Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.528251Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.915552Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.915193Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.920001Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.919516Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "<qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc36980>"
+       "<qiskit.circuit.instructionset.InstructionSet at 0x7f6ca5941e40>"
       ]
      },
      "execution_count": 8,
@@ -354,17 +354,17 @@
    "execution_count": 9,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:20.545298Z",
-     "iopub.status.busy": "2024-10-10T17:24:20.544691Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.549873Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.549273Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.922125Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.921746Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.927139Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.926531Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "<qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc374c0>"
+       "<qiskit.circuit.instructionset.InstructionSet at 0x7f6ca5943cd0>"
       ]
      },
      "execution_count": 9,
@@ -391,17 +391,17 @@
    "execution_count": 10,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:20.552139Z",
-     "iopub.status.busy": "2024-10-10T17:24:20.551619Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.557049Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.556583Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.929554Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.929078Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.934909Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.934307Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "<qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc36770>"
+       "<qiskit.circuit.instructionset.InstructionSet at 0x7f6ca59419f0>"
       ]
      },
      "execution_count": 10,
@@ -428,17 +428,17 @@
    "execution_count": 11,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:20.558936Z",
-     "iopub.status.busy": "2024-10-10T17:24:20.558597Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.564330Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.563849Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.936884Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.936689Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.942864Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.942371Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "<qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc37100>"
+       "<qiskit.circuit.instructionset.InstructionSet at 0x7f6ca51ad390>"
       ]
      },
      "execution_count": 11,
diff --git a/.doctrees/nbsphinx/how-to-guides/qiskit-sampler.ipynb b/.doctrees/nbsphinx/how-to-guides/qiskit-sampler.ipynb
index 032b2b5f9..27224ed5e 100644
--- a/.doctrees/nbsphinx/how-to-guides/qiskit-sampler.ipynb
+++ b/.doctrees/nbsphinx/how-to-guides/qiskit-sampler.ipynb
@@ -18,10 +18,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:22.630450Z",
-     "iopub.status.busy": "2024-10-10T17:24:22.630004Z",
-     "iopub.status.idle": "2024-10-10T17:24:23.324194Z",
-     "shell.execute_reply": "2024-10-10T17:24:23.323531Z"
+     "iopub.execute_input": "2024-10-30T17:30:19.829756Z",
+     "iopub.status.busy": "2024-10-30T17:30:19.829293Z",
+     "iopub.status.idle": "2024-10-30T17:30:20.552031Z",
+     "shell.execute_reply": "2024-10-30T17:30:20.551488Z"
     }
    },
    "outputs": [],
@@ -71,10 +71,10 @@
    "execution_count": 2,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:23.326723Z",
-     "iopub.status.busy": "2024-10-10T17:24:23.326254Z",
-     "iopub.status.idle": "2024-10-10T17:24:23.390846Z",
-     "shell.execute_reply": "2024-10-10T17:24:23.390322Z"
+     "iopub.execute_input": "2024-10-30T17:30:20.554582Z",
+     "iopub.status.busy": "2024-10-30T17:30:20.554114Z",
+     "iopub.status.idle": "2024-10-30T17:30:20.618334Z",
+     "shell.execute_reply": "2024-10-30T17:30:20.617682Z"
     }
    },
    "outputs": [
@@ -154,10 +154,10 @@
    "execution_count": 3,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:23.393053Z",
-     "iopub.status.busy": "2024-10-10T17:24:23.392687Z",
-     "iopub.status.idle": "2024-10-10T17:24:23.713939Z",
-     "shell.execute_reply": "2024-10-10T17:24:23.713375Z"
+     "iopub.execute_input": "2024-10-30T17:30:20.620461Z",
+     "iopub.status.busy": "2024-10-30T17:30:20.620247Z",
+     "iopub.status.idle": "2024-10-30T17:30:20.911145Z",
+     "shell.execute_reply": "2024-10-30T17:30:20.910562Z"
     }
    },
    "outputs": [
@@ -165,7 +165,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "converged SCF energy = -108.835236570774\n"
+      "converged SCF energy = -108.835236570775\n"
      ]
     },
     {
@@ -174,7 +174,7 @@
      "text": [
       "norb = 14\n",
       "nelec = (3, 3)\n",
-      "E(CCSD) = -108.9630419334854  E_corr = -0.1278053627110059\n"
+      "E(CCSD) = -108.9630419334855  E_corr = -0.1278053627110058\n"
      ]
     },
     {
@@ -188,13 +188,13 @@
      "data": {
       "text/plain": [
        "{'0000000000011100000000000111': 9924,\n",
-       " '0000000000110100000000001101': 15,\n",
+       " '0000000000110100000000001101': 16,\n",
        " '0000000001110000000000000111': 10,\n",
        " '0000000000011100000000011100': 10,\n",
-       " '0000000001011000000000010110': 9,\n",
+       " '0000000001011000000000010110': 10,\n",
        " '0001000001010000000000000111': 5,\n",
        " '0000000001011000100000000110': 4,\n",
-       " '0100000000100100000000000111': 3,\n",
+       " '0100000001001000000000000111': 3,\n",
        " '0000000000011100100000001100': 3,\n",
        " '0010000000011000000000010110': 3}"
       ]
@@ -276,10 +276,10 @@
    "execution_count": 4,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:23.716230Z",
-     "iopub.status.busy": "2024-10-10T17:24:23.715814Z",
-     "iopub.status.idle": "2024-10-10T17:24:24.273119Z",
-     "shell.execute_reply": "2024-10-10T17:24:24.272595Z"
+     "iopub.execute_input": "2024-10-30T17:30:20.913309Z",
+     "iopub.status.busy": "2024-10-30T17:30:20.912896Z",
+     "iopub.status.idle": "2024-10-30T17:30:21.460858Z",
+     "shell.execute_reply": "2024-10-30T17:30:21.460340Z"
     }
    },
    "outputs": [
@@ -294,7 +294,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "SCF energy = -75.3484557064305\n"
+      "SCF energy = -75.3484557089003\n"
      ]
     },
     {
@@ -312,14 +312,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "E(UCCSD) = -75.45619739137106  E_corr = -0.1077416849405244"
-     ]
-    },
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "\n"
+      "E(UCCSD) = -75.45619739093132  E_corr = -0.1077416820310391\n"
      ]
     },
     {
diff --git a/.doctrees/nbsphinx/tutorials/double-factorized-trotter.ipynb b/.doctrees/nbsphinx/tutorials/double-factorized-trotter.ipynb
index 3157e55b6..0431fbd64 100644
--- a/.doctrees/nbsphinx/tutorials/double-factorized-trotter.ipynb
+++ b/.doctrees/nbsphinx/tutorials/double-factorized-trotter.ipynb
@@ -18,10 +18,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:25.819360Z",
-     "iopub.status.busy": "2024-10-10T17:24:25.819176Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.585120Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.584507Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.018043Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.017857Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.778746Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.778140Z"
     }
    },
    "outputs": [
@@ -80,10 +80,10 @@
    "execution_count": 2,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.588832Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.587914Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.592807Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.592350Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.781995Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.780904Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.786271Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.785682Z"
     }
    },
    "outputs": [],
@@ -106,10 +106,10 @@
    "execution_count": 3,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.594777Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.594345Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.598784Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.598320Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.788118Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.787937Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.793017Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.792498Z"
     }
    },
    "outputs": [
@@ -172,10 +172,10 @@
    "execution_count": 4,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.600615Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.600427Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.604611Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.604034Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.795040Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.794689Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.798781Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.798275Z"
     }
    },
    "outputs": [
@@ -208,10 +208,10 @@
    "execution_count": 5,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.606370Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.606189Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.610295Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.609699Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.800762Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.800418Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.804298Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.803811Z"
     }
    },
    "outputs": [
@@ -242,10 +242,10 @@
    "execution_count": 6,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.612036Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.611849Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.629634Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.629149Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.806478Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.806034Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.824284Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.823769Z"
     }
    },
    "outputs": [
@@ -302,10 +302,10 @@
    "execution_count": 7,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.631638Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.631299Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.635499Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.635027Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.826390Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.826017Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.830305Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.829725Z"
     }
    },
    "outputs": [],
@@ -360,10 +360,10 @@
    "execution_count": 8,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.637366Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.637034Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.640676Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.640060Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.832361Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.831852Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.835452Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.834971Z"
     }
    },
    "outputs": [],
@@ -400,10 +400,10 @@
    "execution_count": 9,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.642683Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.642329Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.740698Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.740126Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.837415Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.837079Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.937835Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.937203Z"
     }
    },
    "outputs": [],
@@ -439,10 +439,10 @@
    "execution_count": 10,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.743990Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.743034Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.792806Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.792352Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.940685Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.940042Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.989610Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.989110Z"
     }
    },
    "outputs": [
@@ -450,7 +450,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Fidelity of Trotter-evolved state with exact state: 0.9402435386975859\n"
+      "Fidelity of Trotter-evolved state with exact state: 0.9402435115724028\n"
      ]
     }
    ],
@@ -480,10 +480,10 @@
    "execution_count": 11,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.794865Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.794471Z",
-     "iopub.status.idle": "2024-10-10T17:24:27.007158Z",
-     "shell.execute_reply": "2024-10-10T17:24:27.006639Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.991607Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.991166Z",
+     "iopub.status.idle": "2024-10-30T17:30:24.203147Z",
+     "shell.execute_reply": "2024-10-30T17:30:24.202617Z"
     }
    },
    "outputs": [
@@ -491,7 +491,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Fidelity of Trotter-evolved state with exact state: 0.9985212861519277\n"
+      "Fidelity of Trotter-evolved state with exact state: 0.9985212854220817\n"
      ]
     }
    ],
@@ -521,10 +521,10 @@
    "execution_count": 12,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:27.009271Z",
-     "iopub.status.busy": "2024-10-10T17:24:27.008891Z",
-     "iopub.status.idle": "2024-10-10T17:24:27.134836Z",
-     "shell.execute_reply": "2024-10-10T17:24:27.134380Z"
+     "iopub.execute_input": "2024-10-30T17:30:24.205298Z",
+     "iopub.status.busy": "2024-10-30T17:30:24.204871Z",
+     "iopub.status.idle": "2024-10-30T17:30:24.332984Z",
+     "shell.execute_reply": "2024-10-30T17:30:24.332329Z"
     }
    },
    "outputs": [
@@ -532,7 +532,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Fidelity of Trotter-evolved state with exact state: 0.998521286151879\n"
+      "Fidelity of Trotter-evolved state with exact state: 0.9985212854218731\n"
      ]
     }
    ],
@@ -563,10 +563,10 @@
    "execution_count": 13,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:27.136698Z",
-     "iopub.status.busy": "2024-10-10T17:24:27.136505Z",
-     "iopub.status.idle": "2024-10-10T17:24:27.239845Z",
-     "shell.execute_reply": "2024-10-10T17:24:27.239329Z"
+     "iopub.execute_input": "2024-10-30T17:30:24.335293Z",
+     "iopub.status.busy": "2024-10-30T17:30:24.334888Z",
+     "iopub.status.idle": "2024-10-30T17:30:24.438840Z",
+     "shell.execute_reply": "2024-10-30T17:30:24.438282Z"
     }
    },
    "outputs": [
@@ -574,7 +574,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Fidelity of Trotter-evolved state with exact state: 0.9996731164191628"
+      "Fidelity of Trotter-evolved state with exact state: 0.9996731164188345"
      ]
     },
     {
diff --git a/.doctrees/tutorials/double-factorized-trotter.doctree b/.doctrees/tutorials/double-factorized-trotter.doctree
index b67970db9..7a1c38204 100644
Binary files a/.doctrees/tutorials/double-factorized-trotter.doctree and b/.doctrees/tutorials/double-factorized-trotter.doctree differ
diff --git a/.doctrees/tutorials/index.doctree b/.doctrees/tutorials/index.doctree
index 3723cfe92..410a25c11 100644
Binary files a/.doctrees/tutorials/index.doctree and b/.doctrees/tutorials/index.doctree differ
diff --git a/_images/explanations_qiskit-gate-decompositions_34_0.png b/_images/explanations_qiskit-gate-decompositions_34_0.png
index b7cb42826..25955e9e6 100644
Binary files a/_images/explanations_qiskit-gate-decompositions_34_0.png and b/_images/explanations_qiskit-gate-decompositions_34_0.png differ
diff --git a/_modules/ffsim/cistring.html b/_modules/ffsim/cistring.html
index 1cfc605ca..e52b02fa6 100644
--- a/_modules/ffsim/cistring.html
+++ b/_modules/ffsim/cistring.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../genindex.html" /><link rel="search" title="Search" href="../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.cistring - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.cistring - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -353,7 +353,7 @@ <h1>Source code for ffsim.cistring</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/contract/diag_coulomb.html b/_modules/ffsim/contract/diag_coulomb.html
index ed388ff77..ccfcc7deb 100644
--- a/_modules/ffsim/contract/diag_coulomb.html
+++ b/_modules/ffsim/contract/diag_coulomb.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.contract.diag_coulomb - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.contract.diag_coulomb - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -574,7 +574,7 @@ <h1>Source code for ffsim.contract.diag_coulomb</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/contract/num_op_sum.html b/_modules/ffsim/contract/num_op_sum.html
index e24ee49a2..d61e398ef 100644
--- a/_modules/ffsim/contract/num_op_sum.html
+++ b/_modules/ffsim/contract/num_op_sum.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.contract.num_op_sum - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.contract.num_op_sum - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -433,7 +433,7 @@ <h1>Source code for ffsim.contract.num_op_sum</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/contract/one_body.html b/_modules/ffsim/contract/one_body.html
index 4709528c7..e99e5ab3e 100644
--- a/_modules/ffsim/contract/one_body.html
+++ b/_modules/ffsim/contract/one_body.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.contract.one_body - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.contract.one_body - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -390,7 +390,7 @@ <h1>Source code for ffsim.contract.one_body</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/gates/basic_gates.html b/_modules/ffsim/gates/basic_gates.html
index f1a7b733c..3c71b1b32 100644
--- a/_modules/ffsim/gates/basic_gates.html
+++ b/_modules/ffsim/gates/basic_gates.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.gates.basic_gates - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.gates.basic_gates - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -952,7 +952,7 @@ <h1>Source code for ffsim.gates.basic_gates</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/gates/diag_coulomb.html b/_modules/ffsim/gates/diag_coulomb.html
index 0c97c8d44..ef7c12d3a 100644
--- a/_modules/ffsim/gates/diag_coulomb.html
+++ b/_modules/ffsim/gates/diag_coulomb.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.gates.diag_coulomb - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.gates.diag_coulomb - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -564,7 +564,7 @@ <h1>Source code for ffsim.gates.diag_coulomb</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/gates/num_op_sum.html b/_modules/ffsim/gates/num_op_sum.html
index d9f88934b..7ca2fb43f 100644
--- a/_modules/ffsim/gates/num_op_sum.html
+++ b/_modules/ffsim/gates/num_op_sum.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.gates.num_op_sum - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.gates.num_op_sum - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -534,7 +534,7 @@ <h1>Source code for ffsim.gates.num_op_sum</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/gates/orbital_rotation.html b/_modules/ffsim/gates/orbital_rotation.html
index c2f5e5134..918d8e689 100644
--- a/_modules/ffsim/gates/orbital_rotation.html
+++ b/_modules/ffsim/gates/orbital_rotation.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.gates.orbital_rotation - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.gates.orbital_rotation - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -535,7 +535,7 @@ <h1>Source code for ffsim.gates.orbital_rotation</h1><div class="highlight"><pre
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/hamiltonians/diagonal_coulomb_hamiltonian.html b/_modules/ffsim/hamiltonians/diagonal_coulomb_hamiltonian.html
index 8976d84a4..ca6253ac6 100644
--- a/_modules/ffsim/hamiltonians/diagonal_coulomb_hamiltonian.html
+++ b/_modules/ffsim/hamiltonians/diagonal_coulomb_hamiltonian.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.hamiltonians.diagonal_coulomb_hamiltonian - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.hamiltonians.diagonal_coulomb_hamiltonian - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -498,7 +498,7 @@ <h1>Source code for ffsim.hamiltonians.diagonal_coulomb_hamiltonian</h1><div cla
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/hamiltonians/double_factorized_hamiltonian.html b/_modules/ffsim/hamiltonians/double_factorized_hamiltonian.html
index ecb9a8137..5a387fc97 100644
--- a/_modules/ffsim/hamiltonians/double_factorized_hamiltonian.html
+++ b/_modules/ffsim/hamiltonians/double_factorized_hamiltonian.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.hamiltonians.double_factorized_hamiltonian - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.hamiltonians.double_factorized_hamiltonian - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -611,7 +611,7 @@ <h1>Source code for ffsim.hamiltonians.double_factorized_hamiltonian</h1><div cl
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/hamiltonians/molecular_hamiltonian.html b/_modules/ffsim/hamiltonians/molecular_hamiltonian.html
index e34779270..807d38bb2 100644
--- a/_modules/ffsim/hamiltonians/molecular_hamiltonian.html
+++ b/_modules/ffsim/hamiltonians/molecular_hamiltonian.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.hamiltonians.molecular_hamiltonian - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.hamiltonians.molecular_hamiltonian - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -498,7 +498,7 @@ <h1>Source code for ffsim.hamiltonians.molecular_hamiltonian</h1><div class="hig
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/hamiltonians/single_factorized_hamiltonian.html b/_modules/ffsim/hamiltonians/single_factorized_hamiltonian.html
index ae0ea4ff1..c0dd4e614 100644
--- a/_modules/ffsim/hamiltonians/single_factorized_hamiltonian.html
+++ b/_modules/ffsim/hamiltonians/single_factorized_hamiltonian.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.hamiltonians.single_factorized_hamiltonian - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.hamiltonians.single_factorized_hamiltonian - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -577,7 +577,7 @@ <h1>Source code for ffsim.hamiltonians.single_factorized_hamiltonian</h1><div cl
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/linalg/double_factorized_decomposition.html b/_modules/ffsim/linalg/double_factorized_decomposition.html
index cc4c8656d..d23fb968e 100644
--- a/_modules/ffsim/linalg/double_factorized_decomposition.html
+++ b/_modules/ffsim/linalg/double_factorized_decomposition.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.linalg.double_factorized_decomposition - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.linalg.double_factorized_decomposition - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -1002,7 +1002,7 @@ <h1>Source code for ffsim.linalg.double_factorized_decomposition</h1><div class=
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/linalg/givens.html b/_modules/ffsim/linalg/givens.html
index 3dc0157fd..5e0b5480f 100644
--- a/_modules/ffsim/linalg/givens.html
+++ b/_modules/ffsim/linalg/givens.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.linalg.givens - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.linalg.givens - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -524,7 +524,7 @@ <h1>Source code for ffsim.linalg.givens</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/linalg/linalg.html b/_modules/ffsim/linalg/linalg.html
index e89aa0dfe..a916d5aef 100644
--- a/_modules/ffsim/linalg/linalg.html
+++ b/_modules/ffsim/linalg/linalg.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.linalg.linalg - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.linalg.linalg - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -415,7 +415,7 @@ <h1>Source code for ffsim.linalg.linalg</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/linalg/predicates.html b/_modules/ffsim/linalg/predicates.html
index 70b7f5f52..93c750e43 100644
--- a/_modules/ffsim/linalg/predicates.html
+++ b/_modules/ffsim/linalg/predicates.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.linalg.predicates - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.linalg.predicates - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -440,7 +440,7 @@ <h1>Source code for ffsim.linalg.predicates</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/molecular_data.html b/_modules/ffsim/molecular_data.html
index 8f670b324..0babf3149 100644
--- a/_modules/ffsim/molecular_data.html
+++ b/_modules/ffsim/molecular_data.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../genindex.html" /><link rel="search" title="Search" href="../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.molecular_data - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.molecular_data - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -754,7 +754,7 @@ <h1>Source code for ffsim.molecular_data</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/operators/common_operators.html b/_modules/ffsim/operators/common_operators.html
index e99ca0ebc..afed88a36 100644
--- a/_modules/ffsim/operators/common_operators.html
+++ b/_modules/ffsim/operators/common_operators.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.operators.common_operators - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.operators.common_operators - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -343,7 +343,7 @@ <h1>Source code for ffsim.operators.common_operators</h1><div class="highlight">
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/operators/fermi_hubbard.html b/_modules/ffsim/operators/fermi_hubbard.html
index 0ae3a2ef8..cb8b78865 100644
--- a/_modules/ffsim/operators/fermi_hubbard.html
+++ b/_modules/ffsim/operators/fermi_hubbard.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.operators.fermi_hubbard - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.operators.fermi_hubbard - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -516,7 +516,7 @@ <h1>Source code for ffsim.operators.fermi_hubbard</h1><div class="highlight"><pr
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/operators/fermion_action.html b/_modules/ffsim/operators/fermion_action.html
index 20d8a1b9f..bc78f6bf0 100644
--- a/_modules/ffsim/operators/fermion_action.html
+++ b/_modules/ffsim/operators/fermion_action.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.operators.fermion_action - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.operators.fermion_action - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -394,7 +394,7 @@ <h1>Source code for ffsim.operators.fermion_action</h1><div class="highlight"><p
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/optimize/linear_method.html b/_modules/ffsim/optimize/linear_method.html
index c3af425fa..8a2736f5c 100644
--- a/_modules/ffsim/optimize/linear_method.html
+++ b/_modules/ffsim/optimize/linear_method.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.optimize.linear_method - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.optimize.linear_method - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -637,7 +637,7 @@ <h1>Source code for ffsim.optimize.linear_method</h1><div class="highlight"><pre
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/protocols/apply_unitary_protocol.html b/_modules/ffsim/protocols/apply_unitary_protocol.html
index 87302d15e..4eabf736a 100644
--- a/_modules/ffsim/protocols/apply_unitary_protocol.html
+++ b/_modules/ffsim/protocols/apply_unitary_protocol.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.protocols.apply_unitary_protocol - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.protocols.apply_unitary_protocol - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -390,7 +390,7 @@ <h1>Source code for ffsim.protocols.apply_unitary_protocol</h1><div class="highl
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/protocols/approximate_equality_protocol.html b/_modules/ffsim/protocols/approximate_equality_protocol.html
index a81ada438..5ad0f8d28 100644
--- a/_modules/ffsim/protocols/approximate_equality_protocol.html
+++ b/_modules/ffsim/protocols/approximate_equality_protocol.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.protocols.approximate_equality_protocol - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.protocols.approximate_equality_protocol - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -372,7 +372,7 @@ <h1>Source code for ffsim.protocols.approximate_equality_protocol</h1><div class
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/protocols/diagonal_protocol.html b/_modules/ffsim/protocols/diagonal_protocol.html
index 10099238f..5c9b8b21e 100644
--- a/_modules/ffsim/protocols/diagonal_protocol.html
+++ b/_modules/ffsim/protocols/diagonal_protocol.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.protocols.diagonal_protocol - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.protocols.diagonal_protocol - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -345,7 +345,7 @@ <h1>Source code for ffsim.protocols.diagonal_protocol</h1><div class="highlight"
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/protocols/fermion_operator_protocol.html b/_modules/ffsim/protocols/fermion_operator_protocol.html
index fe61e41f2..423c899ee 100644
--- a/_modules/ffsim/protocols/fermion_operator_protocol.html
+++ b/_modules/ffsim/protocols/fermion_operator_protocol.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.protocols.fermion_operator_protocol - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.protocols.fermion_operator_protocol - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -346,7 +346,7 @@ <h1>Source code for ffsim.protocols.fermion_operator_protocol</h1><div class="hi
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/protocols/linear_operator_protocol.html b/_modules/ffsim/protocols/linear_operator_protocol.html
index 24d2a8567..1f1ad3461 100644
--- a/_modules/ffsim/protocols/linear_operator_protocol.html
+++ b/_modules/ffsim/protocols/linear_operator_protocol.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.protocols.linear_operator_protocol - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.protocols.linear_operator_protocol - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -445,7 +445,7 @@ <h1>Source code for ffsim.protocols.linear_operator_protocol</h1><div class="hig
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/protocols/trace_protocol.html b/_modules/ffsim/protocols/trace_protocol.html
index d9a2ab092..138483613 100644
--- a/_modules/ffsim/protocols/trace_protocol.html
+++ b/_modules/ffsim/protocols/trace_protocol.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.protocols.trace_protocol - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.protocols.trace_protocol - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -349,7 +349,7 @@ <h1>Source code for ffsim.protocols.trace_protocol</h1><div class="highlight"><p
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/qiskit/gates/diag_coulomb.html b/_modules/ffsim/qiskit/gates/diag_coulomb.html
index c42ecb163..42afcb2e5 100644
--- a/_modules/ffsim/qiskit/gates/diag_coulomb.html
+++ b/_modules/ffsim/qiskit/gates/diag_coulomb.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../../genindex.html" /><link rel="search" title="Search" href="../../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.qiskit.gates.diag_coulomb - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.qiskit.gates.diag_coulomb - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -427,9 +427,7 @@ <h1>Source code for ffsim.qiskit.gates.diag_coulomb</h1><div class="highlight"><
 <a class="viewcode-back" href="../../../../api/ffsim.qiskit.html#ffsim.qiskit.DiagCoulombEvolutionSpinlessJW.inverse">[docs]</a>
     <span class="k">def</span> <span class="nf">inverse</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 <span class="w">        </span><span class="sd">&quot;&quot;&quot;Inverse gate.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="n">DiagCoulombEvolutionSpinlessJW</span><span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">norb</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">mat</span><span class="p">,</span> <span class="o">-</span><span class="bp">self</span><span class="o">.</span><span class="n">time</span><span class="p">,</span> <span class="n">z_representation</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">z_representation</span>
-        <span class="p">)</span></div>
+        <span class="k">return</span> <span class="n">DiagCoulombEvolutionSpinlessJW</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">norb</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">mat</span><span class="p">,</span> <span class="o">-</span><span class="bp">self</span><span class="o">.</span><span class="n">time</span><span class="p">)</span></div>
 </div>
 
 
@@ -558,7 +556,7 @@ <h1>Source code for ffsim.qiskit.gates.diag_coulomb</h1><div class="highlight"><
       
     </aside>
   </div>
-</div><script src="../../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/qiskit/gates/diag_coulomb_trotter.html b/_modules/ffsim/qiskit/gates/diag_coulomb_trotter.html
index 669b41b3d..fa387145d 100644
--- a/_modules/ffsim/qiskit/gates/diag_coulomb_trotter.html
+++ b/_modules/ffsim/qiskit/gates/diag_coulomb_trotter.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../../genindex.html" /><link rel="search" title="Search" href="../../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.qiskit.gates.diag_coulomb_trotter - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.qiskit.gates.diag_coulomb_trotter - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -455,7 +455,7 @@ <h1>Source code for ffsim.qiskit.gates.diag_coulomb_trotter</h1><div class="high
       
     </aside>
   </div>
-</div><script src="../../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/qiskit/gates/double_factorized_trotter.html b/_modules/ffsim/qiskit/gates/double_factorized_trotter.html
index 74be71019..afecccd94 100644
--- a/_modules/ffsim/qiskit/gates/double_factorized_trotter.html
+++ b/_modules/ffsim/qiskit/gates/double_factorized_trotter.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../../genindex.html" /><link rel="search" title="Search" href="../../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.qiskit.gates.double_factorized_trotter - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.qiskit.gates.double_factorized_trotter - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -462,7 +462,7 @@ <h1>Source code for ffsim.qiskit.gates.double_factorized_trotter</h1><div class=
       
     </aside>
   </div>
-</div><script src="../../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/qiskit/gates/givens_ansatz.html b/_modules/ffsim/qiskit/gates/givens_ansatz.html
index ef94989e1..da480a15c 100644
--- a/_modules/ffsim/qiskit/gates/givens_ansatz.html
+++ b/_modules/ffsim/qiskit/gates/givens_ansatz.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../../genindex.html" /><link rel="search" title="Search" href="../../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.qiskit.gates.givens_ansatz - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.qiskit.gates.givens_ansatz - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -278,7 +278,6 @@ <h1>Source code for ffsim.qiskit.gates.givens_ansatz</h1><div class="highlight">
 
 <span class="kn">from</span> <span class="nn">__future__</span> <span class="kn">import</span> <span class="n">annotations</span>
 
-<span class="kn">import</span> <span class="nn">itertools</span>
 <span class="kn">import</span> <span class="nn">math</span>
 <span class="kn">from</span> <span class="nn">collections.abc</span> <span class="kn">import</span> <span class="n">Iterator</span><span class="p">,</span> <span class="n">Sequence</span>
 
@@ -291,109 +290,8 @@ <h1>Source code for ffsim.qiskit.gates.givens_ansatz</h1><div class="highlight">
     <span class="n">Qubit</span><span class="p">,</span>
 <span class="p">)</span>
 <span class="kn">from</span> <span class="nn">qiskit.circuit.library</span> <span class="kn">import</span> <span class="n">PhaseGate</span><span class="p">,</span> <span class="n">XXPlusYYGate</span>
-<span class="kn">from</span> <span class="nn">typing_extensions</span> <span class="kn">import</span> <span class="n">deprecated</span>
 
-<span class="kn">from</span> <span class="nn">ffsim.variational</span> <span class="kn">import</span> <span class="n">GivensAnsatzOp</span><span class="p">,</span> <span class="n">GivensAnsatzOperator</span>
-
-
-<div class="viewcode-block" id="GivensAnsatzOperatorJW">
-<a class="viewcode-back" href="../../../../api/ffsim.qiskit.html#ffsim.qiskit.GivensAnsatzOperatorJW">[docs]</a>
-<span class="nd">@deprecated</span><span class="p">(</span><span class="s2">&quot;GivensAnsatzOperatorJW is deprecated. Use GivensAnsatzOpJW instead.&quot;</span><span class="p">)</span>
-<span class="k">class</span> <span class="nc">GivensAnsatzOperatorJW</span><span class="p">(</span><span class="n">Gate</span><span class="p">):</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Givens rotation ansatz operator under the Jordan-Wigner transformation.</span>
-
-<span class="sd">    .. warning::</span>
-<span class="sd">        This class is deprecated. Use :class:`ffsim.qiskit.GivensAnsatzOpJW` instead.</span>
-
-<span class="sd">    See :class:`ffsim.GivensAnsatzOperator` for a description of this gate&#39;s unitary.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-<div class="viewcode-block" id="GivensAnsatzOperatorJW.__init__">
-<a class="viewcode-back" href="../../../../api/ffsim.qiskit.html#ffsim.qiskit.GivensAnsatzOperatorJW.__init__">[docs]</a>
-    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
-        <span class="bp">self</span><span class="p">,</span> <span class="n">givens_ansatz_operator</span><span class="p">:</span> <span class="n">GivensAnsatzOperator</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">label</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-    <span class="p">):</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Create a new Givens ansatz operator gate.</span>
-
-<span class="sd">        Args:</span>
-<span class="sd">            givens_ansatz_operator: The Givens rotation ansatz operator.</span>
-<span class="sd">            label: The label of the gate.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">givens_ansatz_operator</span> <span class="o">=</span> <span class="n">givens_ansatz_operator</span>
-        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span>
-            <span class="s2">&quot;givens_ansatz_jw&quot;</span><span class="p">,</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">givens_ansatz_operator</span><span class="o">.</span><span class="n">norb</span><span class="p">,</span> <span class="p">[],</span> <span class="n">label</span><span class="o">=</span><span class="n">label</span>
-        <span class="p">)</span></div>
-
-
-    <span class="k">def</span> <span class="nf">_define</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Gate decomposition.&quot;&quot;&quot;</span>
-        <span class="n">qubits</span> <span class="o">=</span> <span class="n">QuantumRegister</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">num_qubits</span><span class="p">)</span>
-        <span class="n">circuit</span> <span class="o">=</span> <span class="n">QuantumCircuit</span><span class="p">(</span><span class="n">qubits</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">)</span>
-        <span class="n">norb</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">qubits</span><span class="p">)</span> <span class="o">//</span> <span class="mi">2</span>
-        <span class="n">alpha_qubits</span> <span class="o">=</span> <span class="n">qubits</span><span class="p">[:</span><span class="n">norb</span><span class="p">]</span>
-        <span class="n">beta_qubits</span> <span class="o">=</span> <span class="n">qubits</span><span class="p">[</span><span class="n">norb</span><span class="p">:]</span>
-        <span class="k">for</span> <span class="n">instruction</span> <span class="ow">in</span> <span class="n">_givens_ansatz_operator_jw</span><span class="p">(</span>
-            <span class="n">alpha_qubits</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">givens_ansatz_operator</span>
-        <span class="p">):</span>
-            <span class="n">circuit</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">instruction</span><span class="p">)</span>
-        <span class="k">for</span> <span class="n">instruction</span> <span class="ow">in</span> <span class="n">_givens_ansatz_operator_jw</span><span class="p">(</span>
-            <span class="n">beta_qubits</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">givens_ansatz_operator</span>
-        <span class="p">):</span>
-            <span class="n">circuit</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">instruction</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">definition</span> <span class="o">=</span> <span class="n">circuit</span></div>
-
-
-
-<div class="viewcode-block" id="GivensAnsatzOperatorSpinlessJW">
-<a class="viewcode-back" href="../../../../api/ffsim.qiskit.html#ffsim.qiskit.GivensAnsatzOperatorSpinlessJW">[docs]</a>
-<span class="nd">@deprecated</span><span class="p">(</span>
-    <span class="s2">&quot;GivensAnsatzOperatorSpinlessJW is deprecated. &quot;</span>
-    <span class="s2">&quot;Use GivensAnsatzOpSpinlessJW instead.&quot;</span>
-<span class="p">)</span>
-<span class="k">class</span> <span class="nc">GivensAnsatzOperatorSpinlessJW</span><span class="p">(</span><span class="n">Gate</span><span class="p">):</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Givens rotation ansatz operator under the Jordan-Wigner transformation, spinless.</span>
-
-<span class="sd">    Like :class:`GivensAnsatzOperatorJW` but only acts on a single spin species.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-<div class="viewcode-block" id="GivensAnsatzOperatorSpinlessJW.__init__">
-<a class="viewcode-back" href="../../../../api/ffsim.qiskit.html#ffsim.qiskit.GivensAnsatzOperatorSpinlessJW.__init__">[docs]</a>
-    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
-        <span class="bp">self</span><span class="p">,</span> <span class="n">givens_ansatz_operator</span><span class="p">:</span> <span class="n">GivensAnsatzOperator</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">label</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-    <span class="p">):</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Create a new Givens ansatz operator gate.</span>
-
-<span class="sd">        Args:</span>
-<span class="sd">            givens_ansatz_operator: The Givens rotation ansatz operator.</span>
-<span class="sd">            label: The label of the gate.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">givens_ansatz_operator</span> <span class="o">=</span> <span class="n">givens_ansatz_operator</span>
-        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span>
-            <span class="s2">&quot;givens_ansatz_jw&quot;</span><span class="p">,</span> <span class="n">givens_ansatz_operator</span><span class="o">.</span><span class="n">norb</span><span class="p">,</span> <span class="p">[],</span> <span class="n">label</span><span class="o">=</span><span class="n">label</span>
-        <span class="p">)</span></div>
-
-
-    <span class="k">def</span> <span class="nf">_define</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Gate decomposition.&quot;&quot;&quot;</span>
-        <span class="n">qubits</span> <span class="o">=</span> <span class="n">QuantumRegister</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">num_qubits</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">definition</span> <span class="o">=</span> <span class="n">QuantumCircuit</span><span class="o">.</span><span class="n">from_instructions</span><span class="p">(</span>
-            <span class="n">_givens_ansatz_operator_jw</span><span class="p">(</span><span class="n">qubits</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">givens_ansatz_operator</span><span class="p">),</span>
-            <span class="n">qubits</span><span class="o">=</span><span class="n">qubits</span><span class="p">,</span>
-            <span class="n">name</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">,</span>
-        <span class="p">)</span></div>
-
-
-
-<span class="k">def</span> <span class="nf">_givens_ansatz_operator_jw</span><span class="p">(</span>
-    <span class="n">qubits</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Qubit</span><span class="p">],</span> <span class="n">givens_ansatz_operator</span><span class="p">:</span> <span class="n">GivensAnsatzOperator</span>
-<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Iterator</span><span class="p">[</span><span class="n">CircuitInstruction</span><span class="p">]:</span>
-    <span class="k">for</span> <span class="p">(</span><span class="n">i</span><span class="p">,</span> <span class="n">j</span><span class="p">),</span> <span class="n">theta</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span>
-        <span class="n">itertools</span><span class="o">.</span><span class="n">cycle</span><span class="p">(</span><span class="n">givens_ansatz_operator</span><span class="o">.</span><span class="n">interaction_pairs</span><span class="p">),</span>
-        <span class="n">givens_ansatz_operator</span><span class="o">.</span><span class="n">thetas</span><span class="p">,</span>
-    <span class="p">):</span>
-        <span class="k">yield</span> <span class="n">CircuitInstruction</span><span class="p">(</span>
-            <span class="n">XXPlusYYGate</span><span class="p">(</span><span class="mi">2</span> <span class="o">*</span> <span class="n">theta</span><span class="p">,</span> <span class="o">-</span><span class="mf">0.5</span> <span class="o">*</span> <span class="n">math</span><span class="o">.</span><span class="n">pi</span><span class="p">),</span> <span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="n">j</span><span class="p">])</span>
-        <span class="p">)</span>
+<span class="kn">from</span> <span class="nn">ffsim.variational</span> <span class="kn">import</span> <span class="n">GivensAnsatzOp</span>
 
 
 <div class="viewcode-block" id="GivensAnsatzOpJW">
@@ -512,7 +410,7 @@ <h1>Source code for ffsim.qiskit.gates.givens_ansatz</h1><div class="highlight">
       
     </aside>
   </div>
-</div><script src="../../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/qiskit/gates/num_num_ansatz.html b/_modules/ffsim/qiskit/gates/num_num_ansatz.html
index dfbbe0820..dcff14c97 100644
--- a/_modules/ffsim/qiskit/gates/num_num_ansatz.html
+++ b/_modules/ffsim/qiskit/gates/num_num_ansatz.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../../genindex.html" /><link rel="search" title="Search" href="../../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.qiskit.gates.num_num_ansatz - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.qiskit.gates.num_num_ansatz - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -393,7 +393,7 @@ <h1>Source code for ffsim.qiskit.gates.num_num_ansatz</h1><div class="highlight"
       
     </aside>
   </div>
-</div><script src="../../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/qiskit/gates/num_op_sum.html b/_modules/ffsim/qiskit/gates/num_op_sum.html
index bbbce74eb..8a3071ca3 100644
--- a/_modules/ffsim/qiskit/gates/num_op_sum.html
+++ b/_modules/ffsim/qiskit/gates/num_op_sum.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../../genindex.html" /><link rel="search" title="Search" href="../../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.qiskit.gates.num_op_sum - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.qiskit.gates.num_op_sum - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -480,7 +480,7 @@ <h1>Source code for ffsim.qiskit.gates.num_op_sum</h1><div class="highlight"><pr
       
     </aside>
   </div>
-</div><script src="../../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/qiskit/gates/orbital_rotation.html b/_modules/ffsim/qiskit/gates/orbital_rotation.html
index cf7b7c264..254cb7dd5 100644
--- a/_modules/ffsim/qiskit/gates/orbital_rotation.html
+++ b/_modules/ffsim/qiskit/gates/orbital_rotation.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../../genindex.html" /><link rel="search" title="Search" href="../../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.qiskit.gates.orbital_rotation - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.qiskit.gates.orbital_rotation - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -518,7 +518,7 @@ <h1>Source code for ffsim.qiskit.gates.orbital_rotation</h1><div class="highligh
       
     </aside>
   </div>
-</div><script src="../../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/qiskit/gates/slater_determinant.html b/_modules/ffsim/qiskit/gates/slater_determinant.html
index aa68a6622..8f0e34874 100644
--- a/_modules/ffsim/qiskit/gates/slater_determinant.html
+++ b/_modules/ffsim/qiskit/gates/slater_determinant.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../../genindex.html" /><link rel="search" title="Search" href="../../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.qiskit.gates.slater_determinant - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.qiskit.gates.slater_determinant - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -668,7 +668,7 @@ <h1>Source code for ffsim.qiskit.gates.slater_determinant</h1><div class="highli
       
     </aside>
   </div>
-</div><script src="../../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/qiskit/gates/ucj.html b/_modules/ffsim/qiskit/gates/ucj.html
index 1aa11b488..a63b60388 100644
--- a/_modules/ffsim/qiskit/gates/ucj.html
+++ b/_modules/ffsim/qiskit/gates/ucj.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../../genindex.html" /><link rel="search" title="Search" href="../../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.qiskit.gates.ucj - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.qiskit.gates.ucj - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -511,7 +511,7 @@ <h1>Source code for ffsim.qiskit.gates.ucj</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/qiskit/gates/ucj_operator.html b/_modules/ffsim/qiskit/gates/ucj_operator.html
deleted file mode 100644
index 78ec3104c..000000000
--- a/_modules/ffsim/qiskit/gates/ucj_operator.html
+++ /dev/null
@@ -1,395 +0,0 @@
-<!doctype html>
-<html class="no-js" lang="en">
-  <head><meta charset="utf-8"/>
-    <meta name="viewport" content="width=device-width,initial-scale=1"/>
-    <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../../genindex.html" /><link rel="search" title="Search" href="../../../../search.html" />
-
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.qiskit.gates.ucj_operator - ffsim 0.0.47</title>
-      <link rel="stylesheet" type="text/css" href="../../../../_static/styles/furo.css?v=354aac6f" />
-    <link rel="stylesheet" type="text/css" href="../../../../_static/pygments.css?v=a746c00c" />
-    <link rel="stylesheet" type="text/css" href="../../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
-    <link rel="stylesheet" type="text/css" href="../../../../_static/styles/furo-extensions.css?v=302659d7" />
-    
-    
-
-
-<style>
-  body {
-    --color-code-background: #f8f8f8;
-  --color-code-foreground: black;
-  
-  }
-  @media not print {
-    body[data-theme="dark"] {
-      --color-code-background: #202020;
-  --color-code-foreground: #d0d0d0;
-  
-    }
-    @media (prefers-color-scheme: dark) {
-      body:not([data-theme="light"]) {
-        --color-code-background: #202020;
-  --color-code-foreground: #d0d0d0;
-  
-      }
-    }
-  }
-</style><link rel="preconnect" href="https://fonts.googleapis.com">
-<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin><link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;600&family=IBM+Plex+Sans:ital,wght@0,400;0,600;1,400;1,600&display=swap" rel="stylesheet"></head>
-  <body>
-    
-    <script>
-      document.body.dataset.theme = localStorage.getItem("theme") || "auto";
-    </script>
-    
-<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
-  <symbol id="svg-toc" viewBox="0 0 24 24">
-    <title>Contents</title>
-    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
-      <path d="M14 2H2C1.73478 2 1.48043 2.10536 1.29289 2.29289C1.10536 2.48043 1 2.73478 1 3V13C1 13.2652 1.10536 13.5196 1.29289 13.7071C1.48043 13.8946 1.73478 14 2 14H14C14.2652 14 14.5196 13.8946 14.7071 13.7071C14.8946 13.5196 15 13.2652 15 13V3C15 2.73478 14.8946 2.48043 14.7071 2.29289C14.5196 2.10536 14.2652 2 14 2V2ZM2 3H10V13H2V3ZM14 13H11V3H14V13Z" fill="currentColor"/>
-    </svg>
-  </symbol>
-  <symbol id="svg-menu" viewBox="0 0 24 24">
-    <title>Menu</title>
-    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
-      <path d="M14 3H2V4H14V3Z" fill="currentColor"/>
-      <path d="M14 12H2V13H14V12Z" fill="currentColor"/>
-      <path d="M14 6H2V7H14V6Z" fill="currentColor"/>
-      <path d="M14 9H2V10H14V9Z" fill="currentColor"/>
-    </svg>
-  </symbol>
-  <symbol id="svg-arrow-right" viewBox="0 0 24 24">
-    <title>Expand</title>
-    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
-      <path d="M11 8L6.00005 13L5.30005 12.3L9.60005 8L5.30005 3.7L6.00005 3L11 8Z" fill="currentColor"/>
-    </svg>
-  </symbol>
-  <symbol id="svg-sun" viewBox="0 0 24 24">
-    <title>Light mode</title>
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
-      stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" class="feather-sun">
-      <circle cx="12" cy="12" r="5"></circle>
-      <line x1="12" y1="1" x2="12" y2="3"></line>
-      <line x1="12" y1="21" x2="12" y2="23"></line>
-      <line x1="4.22" y1="4.22" x2="5.64" y2="5.64"></line>
-      <line x1="18.36" y1="18.36" x2="19.78" y2="19.78"></line>
-      <line x1="1" y1="12" x2="3" y2="12"></line>
-      <line x1="21" y1="12" x2="23" y2="12"></line>
-      <line x1="4.22" y1="19.78" x2="5.64" y2="18.36"></line>
-      <line x1="18.36" y1="5.64" x2="19.78" y2="4.22"></line>
-    </svg>
-  </symbol>
-  <symbol id="svg-moon" viewBox="0 0 24 24">
-    <title>Dark mode</title>
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
-      stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-moon">
-      <path stroke="none" d="M0 0h24v24H0z" fill="none" />
-      <path d="M12 3c.132 0 .263 0 .393 0a7.5 7.5 0 0 0 7.92 12.446a9 9 0 1 1 -8.313 -12.454z" />
-    </svg>
-  </symbol>
-  <symbol id="svg-sun-with-moon" viewBox="0 0 24 24">
-    <title>Auto light/dark, in light mode</title>
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
-      stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"
-      class="icon-custom-derived-from-feather-sun-and-tabler-moon">
-      <path style="opacity: 50%" d="M 5.411 14.504 C 5.471 14.504 5.532 14.504 5.591 14.504 C 3.639 16.319 4.383 19.569 6.931 20.352 C 7.693 20.586 8.512 20.551 9.25 20.252 C 8.023 23.207 4.056 23.725 2.11 21.184 C 0.166 18.642 1.702 14.949 4.874 14.536 C 5.051 14.512 5.231 14.5 5.411 14.5 L 5.411 14.504 Z"/>
-      <line x1="14.5" y1="3.25" x2="14.5" y2="1.25"/>
-      <line x1="14.5" y1="15.85" x2="14.5" y2="17.85"/>
-      <line x1="10.044" y1="5.094" x2="8.63" y2="3.68"/>
-      <line x1="19" y1="14.05" x2="20.414" y2="15.464"/>
-      <line x1="8.2" y1="9.55" x2="6.2" y2="9.55"/>
-      <line x1="20.8" y1="9.55" x2="22.8" y2="9.55"/>
-      <line x1="10.044" y1="14.006" x2="8.63" y2="15.42"/>
-      <line x1="19" y1="5.05" x2="20.414" y2="3.636"/>
-      <circle cx="14.5" cy="9.55" r="3.6"/>
-    </svg>
-  </symbol>
-  <symbol id="svg-moon-with-sun" viewBox="0 0 24 24">
-    <title>Auto light/dark, in dark mode</title>
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
-      stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"
-      class="icon-custom-derived-from-feather-sun-and-tabler-moon">
-      <path d="M 8.282 7.007 C 8.385 7.007 8.494 7.007 8.595 7.007 C 5.18 10.184 6.481 15.869 10.942 17.24 C 12.275 17.648 13.706 17.589 15 17.066 C 12.851 22.236 5.91 23.143 2.505 18.696 C -0.897 14.249 1.791 7.786 7.342 7.063 C 7.652 7.021 7.965 7 8.282 7 L 8.282 7.007 Z"/>
-      <line style="opacity: 50%" x1="18" y1="3.705" x2="18" y2="2.5"/>
-      <line style="opacity: 50%" x1="18" y1="11.295" x2="18" y2="12.5"/>
-      <line style="opacity: 50%" x1="15.316" y1="4.816" x2="14.464" y2="3.964"/>
-      <line style="opacity: 50%" x1="20.711" y1="10.212" x2="21.563" y2="11.063"/>
-      <line style="opacity: 50%" x1="14.205" y1="7.5" x2="13.001" y2="7.5"/>
-      <line style="opacity: 50%" x1="21.795" y1="7.5" x2="23" y2="7.5"/>
-      <line style="opacity: 50%" x1="15.316" y1="10.184" x2="14.464" y2="11.036"/>
-      <line style="opacity: 50%" x1="20.711" y1="4.789" x2="21.563" y2="3.937"/>
-      <circle style="opacity: 50%" cx="18" cy="7.5" r="2.169"/>
-    </svg>
-  </symbol>
-  <symbol id="svg-pencil" viewBox="0 0 24 24">
-    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
-      <path d="M15 13H1V14H15V13Z" fill="currentColor"/>
-      <path d="M12.7 4.5C13.1 4.1 13.1 3.5 12.7 3.1L10.9 1.3C10.5 0.9 9.9 0.9 9.5 1.3L2 8.8V12H5.2L12.7 4.5ZM10.2 2L12 3.8L10.5 5.3L8.7 3.5L10.2 2ZM3 11V9.2L8 4.2L9.8 6L4.8 11H3Z" fill="currentColor"/>
-    </svg>
-  </symbol>
-  <symbol id="svg-eye" viewBox="0 0 24 24">
-    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
-      <path d="M11 13.0002C11.5523 13.0002 12 12.5525 12 12.0002C12 11.4479 11.5523 11.0002 11 11.0002C10.4477 11.0002 10 11.4479 10 12.0002C10 12.5525 10.4477 13.0002 11 13.0002Z" fill="currentColor"/>
-      <path d="M14.8884 11.7394C14.5795 10.9524 14.0464 10.2734 13.3552 9.78646C12.664 9.29954 11.8451 9.02615 11 9.00017C10.1549 9.02615 9.33604 9.29954 8.64484 9.78646C7.95365 10.2734 7.42052 10.9524 7.11155 11.7394L7 12.0002L7.11155 12.2609C7.42052 13.0479 7.95365 13.727 8.64484 14.2139C9.33604 14.7008 10.1549 14.9742 11 15.0002C11.8451 14.9742 12.664 14.7008 13.3552 14.2139C14.0464 13.727 14.5795 13.0479 14.8884 12.2609L15 12.0002L14.8884 11.7394ZM11 14.0002C10.6044 14.0002 10.2178 13.8829 9.88886 13.6631C9.55996 13.4433 9.30362 13.131 9.15224 12.7655C9.00087 12.4001 8.96126 11.998 9.03843 11.61C9.1156 11.222 9.30608 10.8657 9.58579 10.586C9.86549 10.3063 10.2219 10.1158 10.6098 10.0386C10.9978 9.96143 11.3999 10.001 11.7654 10.1524C12.1308 10.3038 12.4432 10.5601 12.6629 10.889C12.8827 11.2179 13 11.6046 13 12.0002C12.9994 12.5304 12.7885 13.0388 12.4136 13.4137C12.0386 13.7887 11.5303 13.9996 11 14.0002Z" fill="currentColor"/>
-      <path d="M6 14.0002H4V2.00017H8V5.00017C8.00077 5.26515 8.10637 5.51906 8.29374 5.70643C8.48111 5.8938 8.73502 5.99941 9 6.00017H12V8.00017H13V5.00017C13.0018 4.93446 12.9893 4.86913 12.9634 4.80871C12.9375 4.74828 12.8988 4.6942 12.85 4.65017L9.35 1.15017C9.30599 1.10134 9.2519 1.06263 9.19147 1.03674C9.13104 1.01084 9.06572 0.998364 9 1.00017H4C3.73502 1.00094 3.48111 1.10654 3.29374 1.29391C3.10637 1.48128 3.00077 1.73519 3 2.00017V14.0002C3.00077 14.2652 3.10637 14.5191 3.29374 14.7064C3.48111 14.8938 3.73502 14.9994 4 15.0002H6V14.0002ZM9 2.20017L11.8 5.00017H9V2.20017Z" fill="currentColor"/>
-    </svg>
-  </symbol>
-</svg>
-
-<input type="checkbox" class="sidebar-toggle" name="__navigation" id="__navigation">
-<input type="checkbox" class="sidebar-toggle" name="__toc" id="__toc">
-<label class="overlay sidebar-overlay" for="__navigation">
-  <div class="visually-hidden">Hide navigation sidebar</div>
-</label>
-<label class="overlay toc-overlay" for="__toc">
-  <div class="visually-hidden">Hide table of contents sidebar</div>
-</label>
-
-<a class="skip-to-content muted-link" href="#furo-main-content">Skip to content</a>
-
-
-
-<div class="page">
-  <header class="mobile-header">
-    <div class="header-left">
-      <label class="nav-overlay-icon" for="__navigation">
-        <div class="visually-hidden">Toggle site navigation sidebar</div>
-        <i class="icon"><svg><use href="#svg-menu"></use></svg></i>
-      </label>
-    </div>
-    <div class="header-center">
-      <a href="../../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
-    </div>
-    <div class="header-right">
-      <div class="theme-toggle-container theme-toggle-header">
-        <button class="theme-toggle">
-          <div class="visually-hidden">Toggle Light / Dark / Auto color theme</div>
-          <svg class="theme-icon-when-auto-light"><use href="#svg-sun-with-moon"></use></svg>
-          <svg class="theme-icon-when-auto-dark"><use href="#svg-moon-with-sun"></use></svg>
-          <svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
-          <svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
-        </button>
-      </div>
-      <label class="toc-overlay-icon toc-header-icon no-toc" for="__toc">
-        <div class="visually-hidden">Toggle table of contents sidebar</div>
-        <i class="icon"><svg><use href="#svg-toc"></use></svg></i>
-      </label>
-    </div>
-  </header>
-  <aside class="sidebar-drawer">
-    <div class="sidebar-container">
-      
-      <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../../index.html">
-  
-  
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
-  
-</a>
-
-<p class="sidebar-ecosystem-link">
-  This project is part of the <a class="reference external" href="https://www.ibm.com/quantum/ecosystem">Qiskit ecosystem</a>
-</p><form class="sidebar-search-container" method="get" action="../../../../search.html" role="search">
-  <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
-  <input type="hidden" name="check_keywords" value="yes">
-  <input type="hidden" name="area" value="default">
-</form>
-<div id="searchbox"></div><div class="sidebar-scroll"><div class="sidebar-tree">
-  <ul>
-<li class="toctree-l1"><a class="reference internal" href="../../../../install.html">Installation</a></li>
-<li class="toctree-l1 has-children"><a class="reference internal" href="../../../../tutorials/index.html">Tutorials</a><input class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" role="switch" type="checkbox"/><label for="toctree-checkbox-1"><div class="visually-hidden">Toggle navigation of Tutorials</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
-<li class="toctree-l2"><a class="reference internal" href="../../../../tutorials/double-factorized-trotter.html">Implementing Trotter simulation of the double-factorized Hamiltonian</a></li>
-</ul>
-</li>
-<li class="toctree-l1 has-children"><a class="reference internal" href="../../../../explanations/index.html">Explanations</a><input class="toctree-checkbox" id="toctree-checkbox-2" name="toctree-checkbox-2" role="switch" type="checkbox"/><label for="toctree-checkbox-2"><div class="visually-hidden">Toggle navigation of Explanations</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
-<li class="toctree-l2"><a class="reference internal" href="../../../../explanations/state-vectors-and-gates.html">State vectors and gates</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../../explanations/hamiltonians.html">Hamiltonians</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../../explanations/orbital-rotation.html">Orbital rotations and quadratic Hamiltonians</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../../explanations/double-factorized.html">Double-factorized representation of the molecular Hamiltonian</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../../explanations/lucj.html">The local unitary cluster Jastrow (LUCJ) ansatz</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../../explanations/qiskit-gate-decompositions.html">Qubit gate decompositions of fermionic gates</a></li>
-</ul>
-</li>
-<li class="toctree-l1 has-children"><a class="reference internal" href="../../../../how-to-guides/index.html">How-to guides</a><input class="toctree-checkbox" id="toctree-checkbox-3" name="toctree-checkbox-3" role="switch" type="checkbox"/><label for="toctree-checkbox-3"><div class="visually-hidden">Toggle navigation of How-to guides</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
-<li class="toctree-l2"><a class="reference internal" href="../../../../how-to-guides/lucj.html">How to simulate the local unitary cluster Jastrow (LUCJ) ansatz</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../../how-to-guides/entanglement-forging.html">How to simulate entanglement forging</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../../how-to-guides/fermion-operator.html">How to use the FermionOperator class</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../../how-to-guides/qiskit-circuits.html">How to build and transpile Qiskit quantum circuits</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../../how-to-guides/qiskit-sampler.html">How to use ffsim’s Qiskit Sampler primitive</a></li>
-</ul>
-</li>
-<li class="toctree-l1 has-children"><a class="reference internal" href="../../../../api/index.html">API reference</a><input class="toctree-checkbox" id="toctree-checkbox-4" name="toctree-checkbox-4" role="switch" type="checkbox"/><label for="toctree-checkbox-4"><div class="visually-hidden">Toggle navigation of API reference</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
-<li class="toctree-l2"><a class="reference internal" href="../../../../api/ffsim.html">ffsim</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../../api/ffsim.contract.html">ffsim.contract</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../../api/ffsim.linalg.html">ffsim.linalg</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../../api/ffsim.optimize.html">ffsim.optimize</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../../api/ffsim.qiskit.html">ffsim.qiskit</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../../api/ffsim.random.html">ffsim.random</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../../api/ffsim.testing.html">ffsim.testing</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference external" href="https://github.com/qiskit-community/ffsim">GitHub</a></li>
-<li class="toctree-l1"><a class="reference external" href="https://github.com/qiskit-community/ffsim/blob/main/CONTRIBUTING.md">Developer guide</a></li>
-<li class="toctree-l1"><a class="reference external" href="https://github.com/qiskit-community/ffsim/releases">Release notes</a></li>
-<li class="toctree-l1"><a class="reference external" href="https://qiskit-community.github.io/ffsim/dev/">Development branch docs</a></li>
-</ul>
-
-</div></div>
-      </div>
-      
-    </div>
-  </aside>
-  <div class="main">
-    <div class="content">
-      <div class="article-container">
-        <a href="#" class="back-to-top muted-link">
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
-            <path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12z"></path>
-          </svg>
-          <span>Back to top</span>
-        </a>
-        <div class="content-icon-container">
-          <div class="theme-toggle-container theme-toggle-content">
-            <button class="theme-toggle">
-              <div class="visually-hidden">Toggle Light / Dark / Auto color theme</div>
-              <svg class="theme-icon-when-auto-light"><use href="#svg-sun-with-moon"></use></svg>
-              <svg class="theme-icon-when-auto-dark"><use href="#svg-moon-with-sun"></use></svg>
-              <svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
-              <svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
-            </button>
-          </div>
-          <label class="toc-overlay-icon toc-content-icon no-toc" for="__toc">
-            <div class="visually-hidden">Toggle table of contents sidebar</div>
-            <i class="icon"><svg><use href="#svg-toc"></use></svg></i>
-          </label>
-        </div>
-        <article role="main" id="furo-main-content">
-          <h1>Source code for ffsim.qiskit.gates.ucj_operator</h1><div class="highlight"><pre>
-<span></span><span class="c1"># (C) Copyright IBM 2024.</span>
-<span class="c1">#</span>
-<span class="c1"># This code is licensed under the Apache License, Version 2.0. You may</span>
-<span class="c1"># obtain a copy of this license in the LICENSE.txt file in the root directory</span>
-<span class="c1"># of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.</span>
-<span class="c1">#</span>
-<span class="c1"># Any modifications or derivative works of this code must retain this</span>
-<span class="c1"># copyright notice, and modified files need to carry a notice indicating</span>
-<span class="c1"># that they have been altered from the originals.</span>
-
-<span class="sd">&quot;&quot;&quot;(Local) unitary cluster Jastrow ansatz gate.&quot;&quot;&quot;</span>
-
-<span class="kn">from</span> <span class="nn">__future__</span> <span class="kn">import</span> <span class="n">annotations</span>
-
-<span class="kn">from</span> <span class="nn">collections.abc</span> <span class="kn">import</span> <span class="n">Iterator</span><span class="p">,</span> <span class="n">Sequence</span>
-
-<span class="kn">from</span> <span class="nn">qiskit.circuit</span> <span class="kn">import</span> <span class="p">(</span>
-    <span class="n">CircuitInstruction</span><span class="p">,</span>
-    <span class="n">Gate</span><span class="p">,</span>
-    <span class="n">QuantumCircuit</span><span class="p">,</span>
-    <span class="n">QuantumRegister</span><span class="p">,</span>
-    <span class="n">Qubit</span><span class="p">,</span>
-<span class="p">)</span>
-<span class="kn">from</span> <span class="nn">typing_extensions</span> <span class="kn">import</span> <span class="n">deprecated</span>
-
-<span class="kn">from</span> <span class="nn">ffsim.qiskit.gates.diag_coulomb</span> <span class="kn">import</span> <span class="n">DiagCoulombEvolutionJW</span>
-<span class="kn">from</span> <span class="nn">ffsim.qiskit.gates.orbital_rotation</span> <span class="kn">import</span> <span class="n">OrbitalRotationJW</span>
-<span class="kn">from</span> <span class="nn">ffsim.variational</span> <span class="kn">import</span> <span class="n">UCJOperator</span>
-
-
-<div class="viewcode-block" id="UCJOperatorJW">
-<a class="viewcode-back" href="../../../../api/ffsim.qiskit.html#ffsim.qiskit.UCJOperatorJW">[docs]</a>
-<span class="nd">@deprecated</span><span class="p">(</span><span class="s2">&quot;The UCJOperatorJW class is deprecated. Use UCJOpSpinBalancedJW instead.&quot;</span><span class="p">)</span>
-<span class="k">class</span> <span class="nc">UCJOperatorJW</span><span class="p">(</span><span class="n">Gate</span><span class="p">):</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Unitary cluster Jastrow operator under the Jordan-Wigner transformation.</span>
-
-<span class="sd">    .. warning::</span>
-<span class="sd">        This class is deprecated. Use :class:`ffsim.qiskit.UCJOpSpinBalancedJW` instead.</span>
-
-<span class="sd">    See :class:`ffsim.UCJOperator` for a description of this gate&#39;s unitary.</span>
-
-<span class="sd">    This gate assumes that qubits are ordered such that the first `norb` qubits</span>
-<span class="sd">    correspond to the alpha orbitals and the last `norb` qubits correspond to the</span>
-<span class="sd">    beta orbitals.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-<div class="viewcode-block" id="UCJOperatorJW.__init__">
-<a class="viewcode-back" href="../../../../api/ffsim.qiskit.html#ffsim.qiskit.UCJOperatorJW.__init__">[docs]</a>
-    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">ucj_operator</span><span class="p">:</span> <span class="n">UCJOperator</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">label</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">):</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Create a new unitary cluster Jastrow (UCJ) gate.</span>
-
-<span class="sd">        Args:</span>
-<span class="sd">            ucj_operator: The UCJ operator.</span>
-<span class="sd">            label: The label of the gate.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">ucj_operator</span> <span class="o">=</span> <span class="n">ucj_operator</span>
-        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="s2">&quot;ucj_jw&quot;</span><span class="p">,</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">ucj_operator</span><span class="o">.</span><span class="n">norb</span><span class="p">,</span> <span class="p">[],</span> <span class="n">label</span><span class="o">=</span><span class="n">label</span><span class="p">)</span></div>
-
-
-    <span class="k">def</span> <span class="nf">_define</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Gate decomposition.&quot;&quot;&quot;</span>
-        <span class="n">qubits</span> <span class="o">=</span> <span class="n">QuantumRegister</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">num_qubits</span><span class="p">)</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">definition</span> <span class="o">=</span> <span class="n">QuantumCircuit</span><span class="o">.</span><span class="n">from_instructions</span><span class="p">(</span>
-            <span class="n">_ucj_jw</span><span class="p">(</span><span class="n">qubits</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">ucj_operator</span><span class="p">),</span> <span class="n">qubits</span><span class="o">=</span><span class="n">qubits</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span>
-        <span class="p">)</span></div>
-
-
-
-<span class="k">def</span> <span class="nf">_ucj_jw</span><span class="p">(</span>
-    <span class="n">qubits</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Qubit</span><span class="p">],</span> <span class="n">ucj_op</span><span class="p">:</span> <span class="n">UCJOperator</span>
-<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Iterator</span><span class="p">[</span><span class="n">CircuitInstruction</span><span class="p">]:</span>
-    <span class="k">for</span> <span class="n">mat</span><span class="p">,</span> <span class="n">mat_alpha_beta</span><span class="p">,</span> <span class="n">orbital_rotation</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span>
-        <span class="n">ucj_op</span><span class="o">.</span><span class="n">diag_coulomb_mats_alpha_alpha</span><span class="p">,</span>
-        <span class="n">ucj_op</span><span class="o">.</span><span class="n">diag_coulomb_mats_alpha_beta</span><span class="p">,</span>
-        <span class="n">ucj_op</span><span class="o">.</span><span class="n">orbital_rotations</span><span class="p">,</span>
-    <span class="p">):</span>
-        <span class="k">yield</span> <span class="n">CircuitInstruction</span><span class="p">(</span>
-            <span class="n">OrbitalRotationJW</span><span class="p">(</span><span class="n">ucj_op</span><span class="o">.</span><span class="n">norb</span><span class="p">,</span> <span class="n">orbital_rotation</span><span class="o">.</span><span class="n">T</span><span class="o">.</span><span class="n">conj</span><span class="p">()),</span> <span class="n">qubits</span>
-        <span class="p">)</span>
-        <span class="k">yield</span> <span class="n">CircuitInstruction</span><span class="p">(</span>
-            <span class="n">DiagCoulombEvolutionJW</span><span class="p">(</span><span class="n">ucj_op</span><span class="o">.</span><span class="n">norb</span><span class="p">,</span> <span class="p">(</span><span class="n">mat</span><span class="p">,</span> <span class="n">mat_alpha_beta</span><span class="p">,</span> <span class="n">mat</span><span class="p">),</span> <span class="o">-</span><span class="mf">1.0</span><span class="p">),</span>
-            <span class="n">qubits</span><span class="p">,</span>
-        <span class="p">)</span>
-        <span class="k">yield</span> <span class="n">CircuitInstruction</span><span class="p">(</span>
-            <span class="n">OrbitalRotationJW</span><span class="p">(</span><span class="n">ucj_op</span><span class="o">.</span><span class="n">norb</span><span class="p">,</span> <span class="n">orbital_rotation</span><span class="p">),</span> <span class="n">qubits</span>
-        <span class="p">)</span>
-    <span class="k">if</span> <span class="n">ucj_op</span><span class="o">.</span><span class="n">final_orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="k">yield</span> <span class="n">CircuitInstruction</span><span class="p">(</span>
-            <span class="n">OrbitalRotationJW</span><span class="p">(</span><span class="n">ucj_op</span><span class="o">.</span><span class="n">norb</span><span class="p">,</span> <span class="n">ucj_op</span><span class="o">.</span><span class="n">final_orbital_rotation</span><span class="p">),</span> <span class="n">qubits</span>
-        <span class="p">)</span>
-</pre></div>
-        </article>
-      </div>
-      <footer>
-        
-        <div class="related-pages">
-          
-          
-        </div>
-        <div class="bottom-of-page">
-          <div class="left-details">
-            <div class="copyright">
-                Copyright &#169; 2023, IBM
-            </div>
-            Made with <a href="https://www.sphinx-doc.org/">Sphinx</a> and <a class="muted-link" href="https://pradyunsg.me">@pradyunsg</a>'s
-            
-            <a href="https://github.com/pradyunsg/furo">Furo</a>
-            
-          </div>
-          <div class="right-details">
-            
-          </div>
-        </div>
-        
-      </footer>
-    </div>
-    <aside class="toc-drawer no-toc">
-      
-      
-      
-    </aside>
-  </div>
-</div><script src="../../../../_static/documentation_options.js?v=4f34e5f2"></script>
-    <script src="../../../../_static/doctools.js?v=9bcbadda"></script>
-    <script src="../../../../_static/sphinx_highlight.js?v=dc90522c"></script>
-    <script src="../../../../_static/scripts/furo.js?v=5fa4622c"></script>
-    <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
-    </body>
-</html>
\ No newline at end of file
diff --git a/_modules/ffsim/qiskit/jordan_wigner.html b/_modules/ffsim/qiskit/jordan_wigner.html
index 1b1b697c2..4208e3388 100644
--- a/_modules/ffsim/qiskit/jordan_wigner.html
+++ b/_modules/ffsim/qiskit/jordan_wigner.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.qiskit.jordan_wigner - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.qiskit.jordan_wigner - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -376,7 +376,7 @@ <h1>Source code for ffsim.qiskit.jordan_wigner</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/qiskit/sampler.html b/_modules/ffsim/qiskit/sampler.html
index 85c8ee028..03df18184 100644
--- a/_modules/ffsim/qiskit/sampler.html
+++ b/_modules/ffsim/qiskit/sampler.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.qiskit.sampler - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.qiskit.sampler - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -524,7 +524,7 @@ <h1>Source code for ffsim.qiskit.sampler</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/qiskit/sim.html b/_modules/ffsim/qiskit/sim.html
index 8c6077d66..4b1489d42 100644
--- a/_modules/ffsim/qiskit/sim.html
+++ b/_modules/ffsim/qiskit/sim.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.qiskit.sim - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.qiskit.sim - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -287,8 +287,8 @@ <h1>Source code for ffsim.qiskit.sim</h1><div class="highlight"><pre>
 <span class="kn">from</span> <span class="nn">ffsim.qiskit.gates</span> <span class="kn">import</span> <span class="p">(</span>
     <span class="n">DiagCoulombEvolutionJW</span><span class="p">,</span>
     <span class="n">DiagCoulombEvolutionSpinlessJW</span><span class="p">,</span>
-    <span class="n">GivensAnsatzOperatorJW</span><span class="p">,</span>
-    <span class="n">GivensAnsatzOperatorSpinlessJW</span><span class="p">,</span>
+    <span class="n">GivensAnsatzOpJW</span><span class="p">,</span>
+    <span class="n">GivensAnsatzOpSpinlessJW</span><span class="p">,</span>
     <span class="n">OrbitalRotationJW</span><span class="p">,</span>
     <span class="n">OrbitalRotationSpinlessJW</span><span class="p">,</span>
     <span class="n">PrepareHartreeFockJW</span><span class="p">,</span>
@@ -296,7 +296,6 @@ <h1>Source code for ffsim.qiskit.sim</h1><div class="highlight"><pre>
     <span class="n">PrepareSlaterDeterminantJW</span><span class="p">,</span>
     <span class="n">PrepareSlaterDeterminantSpinlessJW</span><span class="p">,</span>
     <span class="n">SimulateTrotterDoubleFactorizedJW</span><span class="p">,</span>
-    <span class="n">UCJOperatorJW</span><span class="p">,</span>
     <span class="n">UCJOpSpinBalancedJW</span><span class="p">,</span>
     <span class="n">UCJOpSpinlessJW</span><span class="p">,</span>
     <span class="n">UCJOpSpinUnbalancedJW</span><span class="p">,</span>
@@ -405,14 +404,14 @@ <h1>Source code for ffsim.qiskit.sim</h1><div class="highlight"><pre>
         <span class="p">)</span>
         <span class="k">return</span> <span class="n">states</span><span class="o">.</span><span class="n">StateVector</span><span class="p">(</span><span class="n">vec</span><span class="o">=</span><span class="n">vec</span><span class="p">,</span> <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span> <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">)</span>
 
-    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">op</span><span class="p">,</span> <span class="n">GivensAnsatzOperatorSpinlessJW</span><span class="p">):</span>
+    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">op</span><span class="p">,</span> <span class="n">GivensAnsatzOpSpinlessJW</span><span class="p">):</span>
         <span class="k">if</span> <span class="ow">not</span> <span class="n">consecutive_sorted</span><span class="p">:</span>
             <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
                 <span class="sa">f</span><span class="s2">&quot;Gate of type &#39;</span><span class="si">{</span><span class="n">op</span><span class="o">.</span><span class="vm">__class__</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">&#39; must be applied to &quot;</span>
                 <span class="s2">&quot;consecutive qubits, in ascending order.&quot;</span>
             <span class="p">)</span>
         <span class="n">vec</span> <span class="o">=</span> <span class="n">protocols</span><span class="o">.</span><span class="n">apply_unitary</span><span class="p">(</span>
-            <span class="n">vec</span><span class="p">,</span> <span class="n">op</span><span class="o">.</span><span class="n">givens_ansatz_operator</span><span class="p">,</span> <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span> <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">,</span> <span class="n">copy</span><span class="o">=</span><span class="kc">False</span>
+            <span class="n">vec</span><span class="p">,</span> <span class="n">op</span><span class="o">.</span><span class="n">givens_ansatz_op</span><span class="p">,</span> <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span> <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">,</span> <span class="n">copy</span><span class="o">=</span><span class="kc">False</span>
         <span class="p">)</span>
         <span class="k">return</span> <span class="n">states</span><span class="o">.</span><span class="n">StateVector</span><span class="p">(</span><span class="n">vec</span><span class="o">=</span><span class="n">vec</span><span class="p">,</span> <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span> <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">)</span>
 
@@ -475,14 +474,14 @@ <h1>Source code for ffsim.qiskit.sim</h1><div class="highlight"><pre>
         <span class="p">)</span>
         <span class="k">return</span> <span class="n">states</span><span class="o">.</span><span class="n">StateVector</span><span class="p">(</span><span class="n">vec</span><span class="o">=</span><span class="n">vec</span><span class="p">,</span> <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span> <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">)</span>
 
-    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">op</span><span class="p">,</span> <span class="n">GivensAnsatzOperatorJW</span><span class="p">):</span>
+    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">op</span><span class="p">,</span> <span class="n">GivensAnsatzOpJW</span><span class="p">):</span>
         <span class="k">if</span> <span class="ow">not</span> <span class="n">consecutive_sorted</span><span class="p">:</span>
             <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
                 <span class="sa">f</span><span class="s2">&quot;Gate of type &#39;</span><span class="si">{</span><span class="n">op</span><span class="o">.</span><span class="vm">__class__</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">&#39; must be applied to &quot;</span>
                 <span class="s2">&quot;consecutive qubits, in ascending order.&quot;</span>
             <span class="p">)</span>
         <span class="n">vec</span> <span class="o">=</span> <span class="n">protocols</span><span class="o">.</span><span class="n">apply_unitary</span><span class="p">(</span>
-            <span class="n">vec</span><span class="p">,</span> <span class="n">op</span><span class="o">.</span><span class="n">givens_ansatz_operator</span><span class="p">,</span> <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span> <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">,</span> <span class="n">copy</span><span class="o">=</span><span class="kc">False</span>
+            <span class="n">vec</span><span class="p">,</span> <span class="n">op</span><span class="o">.</span><span class="n">givens_ansatz_op</span><span class="p">,</span> <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span> <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">,</span> <span class="n">copy</span><span class="o">=</span><span class="kc">False</span>
         <span class="p">)</span>
         <span class="k">return</span> <span class="n">states</span><span class="o">.</span><span class="n">StateVector</span><span class="p">(</span><span class="n">vec</span><span class="o">=</span><span class="n">vec</span><span class="p">,</span> <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span> <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">)</span>
 
@@ -532,17 +531,6 @@ <h1>Source code for ffsim.qiskit.sim</h1><div class="highlight"><pre>
         <span class="p">)</span>
         <span class="k">return</span> <span class="n">states</span><span class="o">.</span><span class="n">StateVector</span><span class="p">(</span><span class="n">vec</span><span class="o">=</span><span class="n">vec</span><span class="p">,</span> <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span> <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">)</span>
 
-    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">op</span><span class="p">,</span> <span class="n">UCJOperatorJW</span><span class="p">):</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="n">consecutive_sorted</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-                <span class="sa">f</span><span class="s2">&quot;Gate of type &#39;</span><span class="si">{</span><span class="n">op</span><span class="o">.</span><span class="vm">__class__</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">&#39; must be applied to &quot;</span>
-                <span class="s2">&quot;consecutive qubits, in ascending order.&quot;</span>
-            <span class="p">)</span>
-        <span class="n">vec</span> <span class="o">=</span> <span class="n">protocols</span><span class="o">.</span><span class="n">apply_unitary</span><span class="p">(</span>
-            <span class="n">vec</span><span class="p">,</span> <span class="n">op</span><span class="o">.</span><span class="n">ucj_operator</span><span class="p">,</span> <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span> <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">,</span> <span class="n">copy</span><span class="o">=</span><span class="kc">False</span>
-        <span class="p">)</span>
-        <span class="k">return</span> <span class="n">states</span><span class="o">.</span><span class="n">StateVector</span><span class="p">(</span><span class="n">vec</span><span class="o">=</span><span class="n">vec</span><span class="p">,</span> <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span> <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">)</span>
-
     <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">op</span><span class="p">,</span> <span class="n">Barrier</span><span class="p">):</span>
         <span class="k">return</span> <span class="n">state_vector</span>
 
@@ -584,7 +572,7 @@ <h1>Source code for ffsim.qiskit.sim</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/qiskit/transpiler_passes/drop_negligible.html b/_modules/ffsim/qiskit/transpiler_passes/drop_negligible.html
index 660eda270..9de94ded7 100644
--- a/_modules/ffsim/qiskit/transpiler_passes/drop_negligible.html
+++ b/_modules/ffsim/qiskit/transpiler_passes/drop_negligible.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../../genindex.html" /><link rel="search" title="Search" href="../../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.qiskit.transpiler_passes.drop_negligible - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.qiskit.transpiler_passes.drop_negligible - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -375,7 +375,7 @@ <h1>Source code for ffsim.qiskit.transpiler_passes.drop_negligible</h1><div clas
       
     </aside>
   </div>
-</div><script src="../../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/qiskit/transpiler_passes/merge_orbital_rotations.html b/_modules/ffsim/qiskit/transpiler_passes/merge_orbital_rotations.html
index 52bffc38f..164075316 100644
--- a/_modules/ffsim/qiskit/transpiler_passes/merge_orbital_rotations.html
+++ b/_modules/ffsim/qiskit/transpiler_passes/merge_orbital_rotations.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../../genindex.html" /><link rel="search" title="Search" href="../../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.qiskit.transpiler_passes.merge_orbital_rotations - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.qiskit.transpiler_passes.merge_orbital_rotations - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -410,7 +410,7 @@ <h1>Source code for ffsim.qiskit.transpiler_passes.merge_orbital_rotations</h1><
       
     </aside>
   </div>
-</div><script src="../../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/qiskit/transpiler_stages.html b/_modules/ffsim/qiskit/transpiler_stages.html
index 05c8ae895..61ffec982 100644
--- a/_modules/ffsim/qiskit/transpiler_stages.html
+++ b/_modules/ffsim/qiskit/transpiler_stages.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.qiskit.transpiler_stages - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.qiskit.transpiler_stages - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -344,7 +344,7 @@ <h1>Source code for ffsim.qiskit.transpiler_stages</h1><div class="highlight"><p
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/qiskit/util.html b/_modules/ffsim/qiskit/util.html
index fdd03a76f..b35d9932a 100644
--- a/_modules/ffsim/qiskit/util.html
+++ b/_modules/ffsim/qiskit/util.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.qiskit.util - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.qiskit.util - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -367,7 +367,7 @@ <h1>Source code for ffsim.qiskit.util</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/random/random.html b/_modules/ffsim/random/random.html
index 45e726e5e..9249bba38 100644
--- a/_modules/ffsim/random/random.html
+++ b/_modules/ffsim/random/random.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.random.random - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.random.random - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -283,6 +283,7 @@ <h1>Source code for ffsim.random.random</h1><div class="highlight"><pre>
 <span class="kn">from</span> <span class="nn">typing_extensions</span> <span class="kn">import</span> <span class="n">deprecated</span>
 
 <span class="kn">from</span> <span class="nn">ffsim</span> <span class="kn">import</span> <span class="n">hamiltonians</span><span class="p">,</span> <span class="n">operators</span><span class="p">,</span> <span class="n">variational</span>
+<span class="kn">from</span> <span class="nn">ffsim.variational.util</span> <span class="kn">import</span> <span class="n">validate_interaction_pairs</span>
 
 
 <div class="viewcode-block" id="random_statevector">
@@ -598,50 +599,43 @@ <h1>Source code for ffsim.random.random</h1><div class="highlight"><pre>
 
 
 
-<div class="viewcode-block" id="random_ucj_operator">
-<a class="viewcode-back" href="../../../api/ffsim.random.html#ffsim.random.random_ucj_operator">[docs]</a>
-<span class="nd">@deprecated</span><span class="p">(</span>
-    <span class="s2">&quot;The random_ucj_operator function is deprecated. Use &quot;</span>
-    <span class="s2">&quot;random_ucj_operator_closed_shell or random_ucj_operator_open_shell instead.&quot;</span>
-<span class="p">)</span>
-<span class="k">def</span> <span class="nf">random_ucj_operator</span><span class="p">(</span>
+<div class="viewcode-block" id="random_uccsd_restricted">
+<a class="viewcode-back" href="../../../api/ffsim.random.html#ffsim.random.random_uccsd_restricted">[docs]</a>
+<span class="k">def</span> <span class="nf">random_uccsd_restricted</span><span class="p">(</span>
     <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
+    <span class="n">nocc</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
     <span class="o">*</span><span class="p">,</span>
-    <span class="n">n_reps</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">1</span><span class="p">,</span>
     <span class="n">with_final_orbital_rotation</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+    <span class="n">real</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
     <span class="n">seed</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">variational</span><span class="o">.</span><span class="n">UCJOperator</span><span class="p">:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Sample a random unitary cluster Jastrow (UCJ) operator.</span>
+<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">variational</span><span class="o">.</span><span class="n">UCCSDOpRestrictedReal</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Sample a random UCCSD operator.</span>
 
 <span class="sd">    Args:</span>
-<span class="sd">        norb: The number of orbitals.</span>
-<span class="sd">        n_reps: The number of ansatz repetitions.</span>
+<span class="sd">        norb: The number of spatial orbitals.</span>
+<span class="sd">        nocc: The number of spatial orbitals that are occupied by electrons.</span>
 <span class="sd">        with_final_orbital_rotation: Whether to include a final orbital rotation</span>
 <span class="sd">            in the operator.</span>
+<span class="sd">        real: Whether to sample a real-valued object rather than a complex-valued one.</span>
 <span class="sd">        seed: A seed to initialize the pseudorandom number generator.</span>
 <span class="sd">            Should be a valid input to ``np.random.default_rng``.</span>
 
 <span class="sd">    Returns:</span>
-<span class="sd">        The sampled UCJ operator.</span>
+<span class="sd">        The sampled UCCSD operator.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="n">rng</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">default_rng</span><span class="p">(</span><span class="n">seed</span><span class="p">)</span>
-    <span class="n">diag_coulomb_mats_alpha_alpha</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">stack</span><span class="p">(</span>
-        <span class="p">[</span><span class="n">random_real_symmetric_matrix</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">seed</span><span class="o">=</span><span class="n">rng</span><span class="p">)</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">n_reps</span><span class="p">)]</span>
-    <span class="p">)</span>
-    <span class="n">diag_coulomb_mats_alpha_beta</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">stack</span><span class="p">(</span>
-        <span class="p">[</span><span class="n">random_real_symmetric_matrix</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">seed</span><span class="o">=</span><span class="n">rng</span><span class="p">)</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">n_reps</span><span class="p">)]</span>
-    <span class="p">)</span>
-    <span class="n">orbital_rotations</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">stack</span><span class="p">(</span>
-        <span class="p">[</span><span class="n">random_unitary</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">seed</span><span class="o">=</span><span class="n">rng</span><span class="p">)</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">n_reps</span><span class="p">)]</span>
-    <span class="p">)</span>
+    <span class="n">dtype</span> <span class="o">=</span> <span class="nb">float</span> <span class="k">if</span> <span class="n">real</span> <span class="k">else</span> <span class="nb">complex</span>
+    <span class="n">nvrt</span> <span class="o">=</span> <span class="n">norb</span> <span class="o">-</span> <span class="n">nocc</span>
+    <span class="n">t1</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">=</span> <span class="n">rng</span><span class="o">.</span><span class="n">standard_normal</span><span class="p">((</span><span class="n">nocc</span><span class="p">,</span> <span class="n">nvrt</span><span class="p">))</span><span class="o">.</span><span class="n">astype</span><span class="p">(</span><span class="n">dtype</span><span class="p">,</span> <span class="n">copy</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+    <span class="k">if</span> <span class="ow">not</span> <span class="n">real</span><span class="p">:</span>
+        <span class="n">t1</span> <span class="o">+=</span> <span class="mi">1</span><span class="n">j</span> <span class="o">*</span> <span class="n">rng</span><span class="o">.</span><span class="n">standard_normal</span><span class="p">((</span><span class="n">nocc</span><span class="p">,</span> <span class="n">nvrt</span><span class="p">))</span>
+    <span class="n">t2</span> <span class="o">=</span> <span class="n">random_t2_amplitudes</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">nocc</span><span class="p">,</span> <span class="n">seed</span><span class="o">=</span><span class="n">rng</span><span class="p">,</span> <span class="n">dtype</span><span class="o">=</span><span class="n">dtype</span><span class="p">)</span>
     <span class="n">final_orbital_rotation</span> <span class="o">=</span> <span class="kc">None</span>
     <span class="k">if</span> <span class="n">with_final_orbital_rotation</span><span class="p">:</span>
-        <span class="n">final_orbital_rotation</span> <span class="o">=</span> <span class="n">random_unitary</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">seed</span><span class="o">=</span><span class="n">rng</span><span class="p">)</span>
-    <span class="k">return</span> <span class="n">variational</span><span class="o">.</span><span class="n">UCJOperator</span><span class="p">(</span>
-        <span class="n">diag_coulomb_mats_alpha_alpha</span><span class="o">=</span><span class="n">diag_coulomb_mats_alpha_alpha</span><span class="p">,</span>
-        <span class="n">diag_coulomb_mats_alpha_beta</span><span class="o">=</span><span class="n">diag_coulomb_mats_alpha_beta</span><span class="p">,</span>
-        <span class="n">orbital_rotations</span><span class="o">=</span><span class="n">orbital_rotations</span><span class="p">,</span>
-        <span class="n">final_orbital_rotation</span><span class="o">=</span><span class="n">final_orbital_rotation</span><span class="p">,</span>
+        <span class="n">unitary_func</span> <span class="o">=</span> <span class="n">random_orthogonal</span> <span class="k">if</span> <span class="n">real</span> <span class="k">else</span> <span class="n">random_unitary</span>
+        <span class="n">final_orbital_rotation</span> <span class="o">=</span> <span class="n">unitary_func</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">seed</span><span class="o">=</span><span class="n">rng</span><span class="p">)</span>
+    <span class="k">return</span> <span class="n">variational</span><span class="o">.</span><span class="n">UCCSDOpRestrictedReal</span><span class="p">(</span>
+        <span class="n">t1</span><span class="o">=</span><span class="n">t1</span><span class="p">,</span> <span class="n">t2</span><span class="o">=</span><span class="n">t2</span><span class="p">,</span> <span class="n">final_orbital_rotation</span><span class="o">=</span><span class="n">final_orbital_rotation</span>
     <span class="p">)</span></div>
 
 
@@ -653,21 +647,41 @@ <h1>Source code for ffsim.random.random</h1><div class="highlight"><pre>
     <span class="o">*</span><span class="p">,</span>
     <span class="n">n_reps</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">1</span><span class="p">,</span>
     <span class="n">with_final_orbital_rotation</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+    <span class="n">interaction_pairs</span><span class="p">:</span> <span class="nb">tuple</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span><span class="p">]</span>
+    <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
     <span class="n">seed</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">variational</span><span class="o">.</span><span class="n">UCJOpSpinBalanced</span><span class="p">:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Sample a random spin-balanced unitary cluster Jastrow (UCJ) operator.</span>
+<span class="w">    </span><span class="sa">r</span><span class="sd">&quot;&quot;&quot;Sample a random spin-balanced unitary cluster Jastrow (UCJ) operator.</span>
 
 <span class="sd">    Args:</span>
 <span class="sd">        norb: The number of spatial orbitals.</span>
 <span class="sd">        n_reps: The number of ansatz repetitions.</span>
 <span class="sd">        with_final_orbital_rotation: Whether to include a final orbital rotation</span>
 <span class="sd">            in the operator.</span>
+<span class="sd">        interaction_pairs: Optional restrictions on allowed orbital interactions</span>
+<span class="sd">            for the diagonal Coulomb operators.</span>
+<span class="sd">            If specified, `interaction_pairs` should be a pair of lists,</span>
+<span class="sd">            for alpha-alpha and alpha-beta interactions, in that order.</span>
+<span class="sd">            Either list can be substituted with ``None`` to indicate no restrictions</span>
+<span class="sd">            on interactions.</span>
+<span class="sd">            Each list should contain pairs of integers representing the orbitals</span>
+<span class="sd">            that are allowed to interact. These pairs can also be interpreted as</span>
+<span class="sd">            indices of diagonal Coulomb matrix entries that are allowed to be</span>
+<span class="sd">            nonzero.</span>
+<span class="sd">            Each integer pair must be upper triangular, that is, of the form</span>
+<span class="sd">            :math:`(i, j)` where :math:`i \leq j`.</span>
 <span class="sd">        seed: A seed to initialize the pseudorandom number generator.</span>
 <span class="sd">            Should be a valid input to ``np.random.default_rng``.</span>
 
 <span class="sd">    Returns:</span>
 <span class="sd">        The sampled UCJ operator.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">if</span> <span class="n">interaction_pairs</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+        <span class="n">interaction_pairs</span> <span class="o">=</span> <span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
+    <span class="n">pairs_aa</span><span class="p">,</span> <span class="n">pairs_ab</span> <span class="o">=</span> <span class="n">interaction_pairs</span>
+    <span class="n">validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_aa</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+    <span class="n">validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_ab</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+
     <span class="n">rng</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">default_rng</span><span class="p">(</span><span class="n">seed</span><span class="p">)</span>
     <span class="n">diag_coulomb_mats</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">stack</span><span class="p">(</span>
         <span class="p">[</span>
@@ -686,6 +700,21 @@ <h1>Source code for ffsim.random.random</h1><div class="highlight"><pre>
     <span class="n">final_orbital_rotation</span> <span class="o">=</span> <span class="kc">None</span>
     <span class="k">if</span> <span class="n">with_final_orbital_rotation</span><span class="p">:</span>
         <span class="n">final_orbital_rotation</span> <span class="o">=</span> <span class="n">random_unitary</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">seed</span><span class="o">=</span><span class="n">rng</span><span class="p">)</span>
+
+    <span class="c1"># Zero out diagonal coulomb matrix entries if requested</span>
+    <span class="k">if</span> <span class="n">pairs_aa</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+        <span class="n">mask</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">bool</span><span class="p">)</span>
+        <span class="n">rows</span><span class="p">,</span> <span class="n">cols</span> <span class="o">=</span> <span class="nb">zip</span><span class="p">(</span><span class="o">*</span><span class="n">pairs_aa</span><span class="p">)</span>
+        <span class="n">mask</span><span class="p">[</span><span class="n">rows</span><span class="p">,</span> <span class="n">cols</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
+        <span class="n">mask</span><span class="p">[</span><span class="n">cols</span><span class="p">,</span> <span class="n">rows</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
+        <span class="n">diag_coulomb_mats</span><span class="p">[:,</span> <span class="mi">0</span><span class="p">]</span> <span class="o">*=</span> <span class="n">mask</span>
+    <span class="k">if</span> <span class="n">pairs_ab</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+        <span class="n">mask</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">bool</span><span class="p">)</span>
+        <span class="n">rows</span><span class="p">,</span> <span class="n">cols</span> <span class="o">=</span> <span class="nb">zip</span><span class="p">(</span><span class="o">*</span><span class="n">pairs_ab</span><span class="p">)</span>
+        <span class="n">mask</span><span class="p">[</span><span class="n">rows</span><span class="p">,</span> <span class="n">cols</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
+        <span class="n">mask</span><span class="p">[</span><span class="n">cols</span><span class="p">,</span> <span class="n">rows</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
+        <span class="n">diag_coulomb_mats</span><span class="p">[:,</span> <span class="mi">1</span><span class="p">]</span> <span class="o">*=</span> <span class="n">mask</span>
+
     <span class="k">return</span> <span class="n">variational</span><span class="o">.</span><span class="n">UCJOpSpinBalanced</span><span class="p">(</span>
         <span class="n">diag_coulomb_mats</span><span class="o">=</span><span class="n">diag_coulomb_mats</span><span class="p">,</span>
         <span class="n">orbital_rotations</span><span class="o">=</span><span class="n">orbital_rotations</span><span class="p">,</span>
@@ -700,14 +729,33 @@ <h1>Source code for ffsim.random.random</h1><div class="highlight"><pre>
     <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
     <span class="o">*</span><span class="p">,</span>
     <span class="n">n_reps</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">1</span><span class="p">,</span>
+    <span class="n">interaction_pairs</span><span class="p">:</span> <span class="nb">tuple</span><span class="p">[</span>
+        <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span>
+        <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span>
+        <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span>
+    <span class="p">]</span>
+    <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
     <span class="n">with_final_orbital_rotation</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
     <span class="n">seed</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">variational</span><span class="o">.</span><span class="n">UCJOpSpinUnbalanced</span><span class="p">:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Sample a random spin-unbalanced unitary cluster Jastrow (UCJ) operator.</span>
+<span class="w">    </span><span class="sa">r</span><span class="sd">&quot;&quot;&quot;Sample a random spin-unbalanced unitary cluster Jastrow (UCJ) operator.</span>
 
 <span class="sd">    Args:</span>
 <span class="sd">        norb: The number of orbitals.</span>
 <span class="sd">        n_reps: The number of ansatz repetitions.</span>
+<span class="sd">        interaction_pairs: Optional restrictions on allowed orbital interactions</span>
+<span class="sd">            for the diagonal Coulomb operators.</span>
+<span class="sd">            If specified, `interaction_pairs` should be a tuple of 3 lists,</span>
+<span class="sd">            for alpha-alpha, alpha-beta, and beta-beta interactions, in that order.</span>
+<span class="sd">            Any list can be substituted with ``None`` to indicate no restrictions</span>
+<span class="sd">            on interactions.</span>
+<span class="sd">            Each list should contain pairs of integers representing the orbitals</span>
+<span class="sd">            that are allowed to interact. These pairs can also be interpreted as</span>
+<span class="sd">            indices of diagonal Coulomb matrix entries that are allowed to be</span>
+<span class="sd">            nonzero.</span>
+<span class="sd">            For the alpha-alpha and beta-beta interactions, each integer</span>
+<span class="sd">            pair must be upper triangular, that is, of the form :math:`(i, j)` where</span>
+<span class="sd">            :math:`i \leq j`.</span>
 <span class="sd">        with_final_orbital_rotation: Whether to include a final orbital rotation</span>
 <span class="sd">            in the operator.</span>
 <span class="sd">        seed: A seed to initialize the pseudorandom number generator.</span>
@@ -716,6 +764,13 @@ <h1>Source code for ffsim.random.random</h1><div class="highlight"><pre>
 <span class="sd">    Returns:</span>
 <span class="sd">        The sampled UCJ operator.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">if</span> <span class="n">interaction_pairs</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+        <span class="n">interaction_pairs</span> <span class="o">=</span> <span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
+    <span class="n">pairs_aa</span><span class="p">,</span> <span class="n">pairs_ab</span><span class="p">,</span> <span class="n">pairs_bb</span> <span class="o">=</span> <span class="n">interaction_pairs</span>
+    <span class="n">validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_aa</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+    <span class="n">validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_bb</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+    <span class="n">validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_bb</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+
     <span class="n">rng</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">default_rng</span><span class="p">(</span><span class="n">seed</span><span class="p">)</span>
     <span class="n">diag_coulomb_mats</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">stack</span><span class="p">(</span>
         <span class="p">[</span>
@@ -740,6 +795,26 @@ <h1>Source code for ffsim.random.random</h1><div class="highlight"><pre>
         <span class="n">final_orbital_rotation</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">stack</span><span class="p">(</span>
             <span class="p">[</span><span class="n">random_unitary</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">seed</span><span class="o">=</span><span class="n">rng</span><span class="p">),</span> <span class="n">random_unitary</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">seed</span><span class="o">=</span><span class="n">rng</span><span class="p">)]</span>
         <span class="p">)</span>
+
+    <span class="c1"># Zero out diagonal coulomb matrix entries if requested</span>
+    <span class="k">if</span> <span class="n">pairs_aa</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+        <span class="n">mask</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">bool</span><span class="p">)</span>
+        <span class="n">rows</span><span class="p">,</span> <span class="n">cols</span> <span class="o">=</span> <span class="nb">zip</span><span class="p">(</span><span class="o">*</span><span class="n">pairs_aa</span><span class="p">)</span>
+        <span class="n">mask</span><span class="p">[</span><span class="n">rows</span><span class="p">,</span> <span class="n">cols</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
+        <span class="n">mask</span><span class="p">[</span><span class="n">cols</span><span class="p">,</span> <span class="n">rows</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
+        <span class="n">diag_coulomb_mats</span><span class="p">[:,</span> <span class="mi">0</span><span class="p">]</span> <span class="o">*=</span> <span class="n">mask</span>
+    <span class="k">if</span> <span class="n">pairs_ab</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+        <span class="n">mask</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">bool</span><span class="p">)</span>
+        <span class="n">rows</span><span class="p">,</span> <span class="n">cols</span> <span class="o">=</span> <span class="nb">zip</span><span class="p">(</span><span class="o">*</span><span class="n">pairs_ab</span><span class="p">)</span>
+        <span class="n">mask</span><span class="p">[</span><span class="n">rows</span><span class="p">,</span> <span class="n">cols</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
+        <span class="n">diag_coulomb_mats</span><span class="p">[:,</span> <span class="mi">1</span><span class="p">]</span> <span class="o">*=</span> <span class="n">mask</span>
+    <span class="k">if</span> <span class="n">pairs_bb</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+        <span class="n">mask</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">bool</span><span class="p">)</span>
+        <span class="n">rows</span><span class="p">,</span> <span class="n">cols</span> <span class="o">=</span> <span class="nb">zip</span><span class="p">(</span><span class="o">*</span><span class="n">pairs_bb</span><span class="p">)</span>
+        <span class="n">mask</span><span class="p">[</span><span class="n">rows</span><span class="p">,</span> <span class="n">cols</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
+        <span class="n">mask</span><span class="p">[</span><span class="n">cols</span><span class="p">,</span> <span class="n">rows</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
+        <span class="n">diag_coulomb_mats</span><span class="p">[:,</span> <span class="mi">2</span><span class="p">]</span> <span class="o">*=</span> <span class="n">mask</span>
+
     <span class="k">return</span> <span class="n">variational</span><span class="o">.</span><span class="n">UCJOpSpinUnbalanced</span><span class="p">(</span>
         <span class="n">diag_coulomb_mats</span><span class="o">=</span><span class="n">diag_coulomb_mats</span><span class="p">,</span>
         <span class="n">orbital_rotations</span><span class="o">=</span><span class="n">orbital_rotations</span><span class="p">,</span>
@@ -754,22 +829,33 @@ <h1>Source code for ffsim.random.random</h1><div class="highlight"><pre>
     <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
     <span class="o">*</span><span class="p">,</span>
     <span class="n">n_reps</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">1</span><span class="p">,</span>
+    <span class="n">interaction_pairs</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
     <span class="n">with_final_orbital_rotation</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
     <span class="n">seed</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">variational</span><span class="o">.</span><span class="n">UCJOpSpinless</span><span class="p">:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Sample a random spinless unitary cluster Jastrow (UCJ) operator.</span>
+<span class="w">    </span><span class="sa">r</span><span class="sd">&quot;&quot;&quot;Sample a random spinless unitary cluster Jastrow (UCJ) operator.</span>
 
 <span class="sd">    Args:</span>
 <span class="sd">        norb: The number of orbitals.</span>
 <span class="sd">        n_reps: The number of ansatz repetitions.</span>
 <span class="sd">        with_final_orbital_rotation: Whether to include a final orbital rotation</span>
 <span class="sd">            in the operator.</span>
+<span class="sd">        interaction_pairs: Optional restrictions on allowed orbital interactions</span>
+<span class="sd">            for the diagonal Coulomb operators.</span>
+<span class="sd">            If specified, `interaction_pairs` should be a list of integer pairs</span>
+<span class="sd">            representing the orbitals that are allowed to interact. These pairs</span>
+<span class="sd">            can also be interpreted as indices of diagonal Coulomb matrix entries</span>
+<span class="sd">            that are allowed to be nonzero.</span>
+<span class="sd">            Each integer pair must be upper triangular, that is, of the form</span>
+<span class="sd">            :math:`(i, j)` where :math:`i \leq j`.</span>
 <span class="sd">        seed: A seed to initialize the pseudorandom number generator.</span>
 <span class="sd">            Should be a valid input to ``np.random.default_rng``.</span>
 
 <span class="sd">    Returns:</span>
 <span class="sd">        The sampled UCJ operator.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
+    <span class="n">validate_interaction_pairs</span><span class="p">(</span><span class="n">interaction_pairs</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+
     <span class="n">rng</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">default_rng</span><span class="p">(</span><span class="n">seed</span><span class="p">)</span>
     <span class="n">diag_coulomb_mats</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">stack</span><span class="p">(</span>
         <span class="p">[</span><span class="n">random_real_symmetric_matrix</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">seed</span><span class="o">=</span><span class="n">rng</span><span class="p">)</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">n_reps</span><span class="p">)]</span>
@@ -780,6 +866,15 @@ <h1>Source code for ffsim.random.random</h1><div class="highlight"><pre>
     <span class="n">final_orbital_rotation</span> <span class="o">=</span> <span class="kc">None</span>
     <span class="k">if</span> <span class="n">with_final_orbital_rotation</span><span class="p">:</span>
         <span class="n">final_orbital_rotation</span> <span class="o">=</span> <span class="n">random_unitary</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">seed</span><span class="o">=</span><span class="n">rng</span><span class="p">)</span>
+
+    <span class="c1"># Zero out diagonal coulomb matrix entries if requested</span>
+    <span class="k">if</span> <span class="n">interaction_pairs</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+        <span class="n">mask</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">bool</span><span class="p">)</span>
+        <span class="n">rows</span><span class="p">,</span> <span class="n">cols</span> <span class="o">=</span> <span class="nb">zip</span><span class="p">(</span><span class="o">*</span><span class="n">interaction_pairs</span><span class="p">)</span>
+        <span class="n">mask</span><span class="p">[</span><span class="n">rows</span><span class="p">,</span> <span class="n">cols</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
+        <span class="n">mask</span><span class="p">[</span><span class="n">cols</span><span class="p">,</span> <span class="n">rows</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
+        <span class="n">diag_coulomb_mats</span> <span class="o">*=</span> <span class="n">mask</span>
+
     <span class="k">return</span> <span class="n">variational</span><span class="o">.</span><span class="n">UCJOpSpinless</span><span class="p">(</span>
         <span class="n">diag_coulomb_mats</span><span class="o">=</span><span class="n">diag_coulomb_mats</span><span class="p">,</span>
         <span class="n">orbital_rotations</span><span class="o">=</span><span class="n">orbital_rotations</span><span class="p">,</span>
@@ -997,7 +1092,7 @@ <h1>Source code for ffsim.random.random</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/spin.html b/_modules/ffsim/spin.html
index c5706c16e..3f1dc9375 100644
--- a/_modules/ffsim/spin.html
+++ b/_modules/ffsim/spin.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../genindex.html" /><link rel="search" title="Search" href="../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.spin - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.spin - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -345,7 +345,7 @@ <h1>Source code for ffsim.spin</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/states/bitstring.html b/_modules/ffsim/states/bitstring.html
index 82651aac1..b2b1e0074 100644
--- a/_modules/ffsim/states/bitstring.html
+++ b/_modules/ffsim/states/bitstring.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.states.bitstring - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.states.bitstring - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -742,7 +742,7 @@ <h1>Source code for ffsim.states.bitstring</h1><div class="highlight"><pre>
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">if</span> <span class="ow">not</span> <span class="nb">len</span><span class="p">(</span><span class="n">strings</span><span class="p">):</span>
         <span class="k">return</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([])</span>
-    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">strings</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">):</span>
+    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">strings</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">)</span> <span class="ow">and</span> <span class="n">strings</span><span class="o">.</span><span class="n">ndim</span> <span class="o">==</span> <span class="mi">2</span><span class="p">:</span>
         <span class="n">bitstring_type</span> <span class="o">=</span> <span class="n">BitstringType</span><span class="o">.</span><span class="n">BIT_ARRAY</span>
     <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">strings</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="nb">str</span><span class="p">):</span>
         <span class="n">bitstring_type</span> <span class="o">=</span> <span class="n">BitstringType</span><span class="o">.</span><span class="n">STRING</span>
@@ -762,6 +762,11 @@ <h1>Source code for ffsim.states.bitstring</h1><div class="highlight"><pre>
     <span class="n">dim_b</span> <span class="o">=</span> <span class="n">math</span><span class="o">.</span><span class="n">comb</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">n_beta</span><span class="p">)</span>
     <span class="k">return</span> <span class="n">addrs_a</span> <span class="o">*</span> <span class="n">dim_b</span> <span class="o">+</span> <span class="n">addrs_b</span></div>
 
+
+
+<span class="k">def</span> <span class="nf">bitstring_to_occupied_orbitals</span><span class="p">(</span><span class="n">bitstring</span><span class="p">:</span> <span class="nb">int</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">int</span><span class="p">]:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Return a list of bit indices where a bitstring is equal to one.&quot;&quot;&quot;</span>
+    <span class="k">return</span> <span class="p">[</span><span class="n">i</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">bitstring</span><span class="o">.</span><span class="n">bit_length</span><span class="p">())</span> <span class="k">if</span> <span class="n">bitstring</span> <span class="o">&gt;&gt;</span> <span class="n">i</span> <span class="o">&amp;</span> <span class="mi">1</span><span class="p">]</span>
 </pre></div>
         </article>
       </div>
@@ -794,7 +799,7 @@ <h1>Source code for ffsim.states.bitstring</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/states/product_state_sum.html b/_modules/ffsim/states/product_state_sum.html
index b35f27dbd..4da047b54 100644
--- a/_modules/ffsim/states/product_state_sum.html
+++ b/_modules/ffsim/states/product_state_sum.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.states.product_state_sum - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.states.product_state_sum - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -336,7 +336,7 @@ <h1>Source code for ffsim.states.product_state_sum</h1><div class="highlight"><p
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/states/rdm.html b/_modules/ffsim/states/rdm.html
index d59982b6a..cca628d0b 100644
--- a/_modules/ffsim/states/rdm.html
+++ b/_modules/ffsim/states/rdm.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.states.rdm - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.states.rdm - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -733,7 +733,7 @@ <h1>Source code for ffsim.states.rdm</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/states/sample_slater.html b/_modules/ffsim/states/sample_slater.html
new file mode 100644
index 000000000..139dd1ff5
--- /dev/null
+++ b/_modules/ffsim/states/sample_slater.html
@@ -0,0 +1,521 @@
+<!doctype html>
+<html class="no-js" lang="en">
+  <head><meta charset="utf-8"/>
+    <meta name="viewport" content="width=device-width,initial-scale=1"/>
+    <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
+
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.states.sample_slater - ffsim 0.0.48</title>
+      <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
+    <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
+    <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
+    <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo-extensions.css?v=302659d7" />
+    
+    
+
+
+<style>
+  body {
+    --color-code-background: #f8f8f8;
+  --color-code-foreground: black;
+  
+  }
+  @media not print {
+    body[data-theme="dark"] {
+      --color-code-background: #202020;
+  --color-code-foreground: #d0d0d0;
+  
+    }
+    @media (prefers-color-scheme: dark) {
+      body:not([data-theme="light"]) {
+        --color-code-background: #202020;
+  --color-code-foreground: #d0d0d0;
+  
+      }
+    }
+  }
+</style><link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin><link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;600&family=IBM+Plex+Sans:ital,wght@0,400;0,600;1,400;1,600&display=swap" rel="stylesheet"></head>
+  <body>
+    
+    <script>
+      document.body.dataset.theme = localStorage.getItem("theme") || "auto";
+    </script>
+    
+<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
+  <symbol id="svg-toc" viewBox="0 0 24 24">
+    <title>Contents</title>
+    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+      <path d="M14 2H2C1.73478 2 1.48043 2.10536 1.29289 2.29289C1.10536 2.48043 1 2.73478 1 3V13C1 13.2652 1.10536 13.5196 1.29289 13.7071C1.48043 13.8946 1.73478 14 2 14H14C14.2652 14 14.5196 13.8946 14.7071 13.7071C14.8946 13.5196 15 13.2652 15 13V3C15 2.73478 14.8946 2.48043 14.7071 2.29289C14.5196 2.10536 14.2652 2 14 2V2ZM2 3H10V13H2V3ZM14 13H11V3H14V13Z" fill="currentColor"/>
+    </svg>
+  </symbol>
+  <symbol id="svg-menu" viewBox="0 0 24 24">
+    <title>Menu</title>
+    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+      <path d="M14 3H2V4H14V3Z" fill="currentColor"/>
+      <path d="M14 12H2V13H14V12Z" fill="currentColor"/>
+      <path d="M14 6H2V7H14V6Z" fill="currentColor"/>
+      <path d="M14 9H2V10H14V9Z" fill="currentColor"/>
+    </svg>
+  </symbol>
+  <symbol id="svg-arrow-right" viewBox="0 0 24 24">
+    <title>Expand</title>
+    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+      <path d="M11 8L6.00005 13L5.30005 12.3L9.60005 8L5.30005 3.7L6.00005 3L11 8Z" fill="currentColor"/>
+    </svg>
+  </symbol>
+  <symbol id="svg-sun" viewBox="0 0 24 24">
+    <title>Light mode</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" class="feather-sun">
+      <circle cx="12" cy="12" r="5"></circle>
+      <line x1="12" y1="1" x2="12" y2="3"></line>
+      <line x1="12" y1="21" x2="12" y2="23"></line>
+      <line x1="4.22" y1="4.22" x2="5.64" y2="5.64"></line>
+      <line x1="18.36" y1="18.36" x2="19.78" y2="19.78"></line>
+      <line x1="1" y1="12" x2="3" y2="12"></line>
+      <line x1="21" y1="12" x2="23" y2="12"></line>
+      <line x1="4.22" y1="19.78" x2="5.64" y2="18.36"></line>
+      <line x1="18.36" y1="5.64" x2="19.78" y2="4.22"></line>
+    </svg>
+  </symbol>
+  <symbol id="svg-moon" viewBox="0 0 24 24">
+    <title>Dark mode</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-moon">
+      <path stroke="none" d="M0 0h24v24H0z" fill="none" />
+      <path d="M12 3c.132 0 .263 0 .393 0a7.5 7.5 0 0 0 7.92 12.446a9 9 0 1 1 -8.313 -12.454z" />
+    </svg>
+  </symbol>
+  <symbol id="svg-sun-with-moon" viewBox="0 0 24 24">
+    <title>Auto light/dark, in light mode</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"
+      class="icon-custom-derived-from-feather-sun-and-tabler-moon">
+      <path style="opacity: 50%" d="M 5.411 14.504 C 5.471 14.504 5.532 14.504 5.591 14.504 C 3.639 16.319 4.383 19.569 6.931 20.352 C 7.693 20.586 8.512 20.551 9.25 20.252 C 8.023 23.207 4.056 23.725 2.11 21.184 C 0.166 18.642 1.702 14.949 4.874 14.536 C 5.051 14.512 5.231 14.5 5.411 14.5 L 5.411 14.504 Z"/>
+      <line x1="14.5" y1="3.25" x2="14.5" y2="1.25"/>
+      <line x1="14.5" y1="15.85" x2="14.5" y2="17.85"/>
+      <line x1="10.044" y1="5.094" x2="8.63" y2="3.68"/>
+      <line x1="19" y1="14.05" x2="20.414" y2="15.464"/>
+      <line x1="8.2" y1="9.55" x2="6.2" y2="9.55"/>
+      <line x1="20.8" y1="9.55" x2="22.8" y2="9.55"/>
+      <line x1="10.044" y1="14.006" x2="8.63" y2="15.42"/>
+      <line x1="19" y1="5.05" x2="20.414" y2="3.636"/>
+      <circle cx="14.5" cy="9.55" r="3.6"/>
+    </svg>
+  </symbol>
+  <symbol id="svg-moon-with-sun" viewBox="0 0 24 24">
+    <title>Auto light/dark, in dark mode</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"
+      class="icon-custom-derived-from-feather-sun-and-tabler-moon">
+      <path d="M 8.282 7.007 C 8.385 7.007 8.494 7.007 8.595 7.007 C 5.18 10.184 6.481 15.869 10.942 17.24 C 12.275 17.648 13.706 17.589 15 17.066 C 12.851 22.236 5.91 23.143 2.505 18.696 C -0.897 14.249 1.791 7.786 7.342 7.063 C 7.652 7.021 7.965 7 8.282 7 L 8.282 7.007 Z"/>
+      <line style="opacity: 50%" x1="18" y1="3.705" x2="18" y2="2.5"/>
+      <line style="opacity: 50%" x1="18" y1="11.295" x2="18" y2="12.5"/>
+      <line style="opacity: 50%" x1="15.316" y1="4.816" x2="14.464" y2="3.964"/>
+      <line style="opacity: 50%" x1="20.711" y1="10.212" x2="21.563" y2="11.063"/>
+      <line style="opacity: 50%" x1="14.205" y1="7.5" x2="13.001" y2="7.5"/>
+      <line style="opacity: 50%" x1="21.795" y1="7.5" x2="23" y2="7.5"/>
+      <line style="opacity: 50%" x1="15.316" y1="10.184" x2="14.464" y2="11.036"/>
+      <line style="opacity: 50%" x1="20.711" y1="4.789" x2="21.563" y2="3.937"/>
+      <circle style="opacity: 50%" cx="18" cy="7.5" r="2.169"/>
+    </svg>
+  </symbol>
+  <symbol id="svg-pencil" viewBox="0 0 24 24">
+    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+      <path d="M15 13H1V14H15V13Z" fill="currentColor"/>
+      <path d="M12.7 4.5C13.1 4.1 13.1 3.5 12.7 3.1L10.9 1.3C10.5 0.9 9.9 0.9 9.5 1.3L2 8.8V12H5.2L12.7 4.5ZM10.2 2L12 3.8L10.5 5.3L8.7 3.5L10.2 2ZM3 11V9.2L8 4.2L9.8 6L4.8 11H3Z" fill="currentColor"/>
+    </svg>
+  </symbol>
+  <symbol id="svg-eye" viewBox="0 0 24 24">
+    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+      <path d="M11 13.0002C11.5523 13.0002 12 12.5525 12 12.0002C12 11.4479 11.5523 11.0002 11 11.0002C10.4477 11.0002 10 11.4479 10 12.0002C10 12.5525 10.4477 13.0002 11 13.0002Z" fill="currentColor"/>
+      <path d="M14.8884 11.7394C14.5795 10.9524 14.0464 10.2734 13.3552 9.78646C12.664 9.29954 11.8451 9.02615 11 9.00017C10.1549 9.02615 9.33604 9.29954 8.64484 9.78646C7.95365 10.2734 7.42052 10.9524 7.11155 11.7394L7 12.0002L7.11155 12.2609C7.42052 13.0479 7.95365 13.727 8.64484 14.2139C9.33604 14.7008 10.1549 14.9742 11 15.0002C11.8451 14.9742 12.664 14.7008 13.3552 14.2139C14.0464 13.727 14.5795 13.0479 14.8884 12.2609L15 12.0002L14.8884 11.7394ZM11 14.0002C10.6044 14.0002 10.2178 13.8829 9.88886 13.6631C9.55996 13.4433 9.30362 13.131 9.15224 12.7655C9.00087 12.4001 8.96126 11.998 9.03843 11.61C9.1156 11.222 9.30608 10.8657 9.58579 10.586C9.86549 10.3063 10.2219 10.1158 10.6098 10.0386C10.9978 9.96143 11.3999 10.001 11.7654 10.1524C12.1308 10.3038 12.4432 10.5601 12.6629 10.889C12.8827 11.2179 13 11.6046 13 12.0002C12.9994 12.5304 12.7885 13.0388 12.4136 13.4137C12.0386 13.7887 11.5303 13.9996 11 14.0002Z" fill="currentColor"/>
+      <path d="M6 14.0002H4V2.00017H8V5.00017C8.00077 5.26515 8.10637 5.51906 8.29374 5.70643C8.48111 5.8938 8.73502 5.99941 9 6.00017H12V8.00017H13V5.00017C13.0018 4.93446 12.9893 4.86913 12.9634 4.80871C12.9375 4.74828 12.8988 4.6942 12.85 4.65017L9.35 1.15017C9.30599 1.10134 9.2519 1.06263 9.19147 1.03674C9.13104 1.01084 9.06572 0.998364 9 1.00017H4C3.73502 1.00094 3.48111 1.10654 3.29374 1.29391C3.10637 1.48128 3.00077 1.73519 3 2.00017V14.0002C3.00077 14.2652 3.10637 14.5191 3.29374 14.7064C3.48111 14.8938 3.73502 14.9994 4 15.0002H6V14.0002ZM9 2.20017L11.8 5.00017H9V2.20017Z" fill="currentColor"/>
+    </svg>
+  </symbol>
+</svg>
+
+<input type="checkbox" class="sidebar-toggle" name="__navigation" id="__navigation">
+<input type="checkbox" class="sidebar-toggle" name="__toc" id="__toc">
+<label class="overlay sidebar-overlay" for="__navigation">
+  <div class="visually-hidden">Hide navigation sidebar</div>
+</label>
+<label class="overlay toc-overlay" for="__toc">
+  <div class="visually-hidden">Hide table of contents sidebar</div>
+</label>
+
+<a class="skip-to-content muted-link" href="#furo-main-content">Skip to content</a>
+
+
+
+<div class="page">
+  <header class="mobile-header">
+    <div class="header-left">
+      <label class="nav-overlay-icon" for="__navigation">
+        <div class="visually-hidden">Toggle site navigation sidebar</div>
+        <i class="icon"><svg><use href="#svg-menu"></use></svg></i>
+      </label>
+    </div>
+    <div class="header-center">
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
+    </div>
+    <div class="header-right">
+      <div class="theme-toggle-container theme-toggle-header">
+        <button class="theme-toggle">
+          <div class="visually-hidden">Toggle Light / Dark / Auto color theme</div>
+          <svg class="theme-icon-when-auto-light"><use href="#svg-sun-with-moon"></use></svg>
+          <svg class="theme-icon-when-auto-dark"><use href="#svg-moon-with-sun"></use></svg>
+          <svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
+          <svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
+        </button>
+      </div>
+      <label class="toc-overlay-icon toc-header-icon no-toc" for="__toc">
+        <div class="visually-hidden">Toggle table of contents sidebar</div>
+        <i class="icon"><svg><use href="#svg-toc"></use></svg></i>
+      </label>
+    </div>
+  </header>
+  <aside class="sidebar-drawer">
+    <div class="sidebar-container">
+      
+      <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
+  
+  
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
+  
+</a>
+
+<p class="sidebar-ecosystem-link">
+  This project is part of the <a class="reference external" href="https://www.ibm.com/quantum/ecosystem">Qiskit ecosystem</a>
+</p><form class="sidebar-search-container" method="get" action="../../../search.html" role="search">
+  <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
+  <input type="hidden" name="check_keywords" value="yes">
+  <input type="hidden" name="area" value="default">
+</form>
+<div id="searchbox"></div><div class="sidebar-scroll"><div class="sidebar-tree">
+  <ul>
+<li class="toctree-l1"><a class="reference internal" href="../../../install.html">Installation</a></li>
+<li class="toctree-l1 has-children"><a class="reference internal" href="../../../tutorials/index.html">Tutorials</a><input class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" role="switch" type="checkbox"/><label for="toctree-checkbox-1"><div class="visually-hidden">Toggle navigation of Tutorials</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../tutorials/double-factorized-trotter.html">Implementing Trotter simulation of the double-factorized Hamiltonian</a></li>
+</ul>
+</li>
+<li class="toctree-l1 has-children"><a class="reference internal" href="../../../explanations/index.html">Explanations</a><input class="toctree-checkbox" id="toctree-checkbox-2" name="toctree-checkbox-2" role="switch" type="checkbox"/><label for="toctree-checkbox-2"><div class="visually-hidden">Toggle navigation of Explanations</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../explanations/state-vectors-and-gates.html">State vectors and gates</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../explanations/hamiltonians.html">Hamiltonians</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../explanations/orbital-rotation.html">Orbital rotations and quadratic Hamiltonians</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../explanations/double-factorized.html">Double-factorized representation of the molecular Hamiltonian</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../explanations/lucj.html">The local unitary cluster Jastrow (LUCJ) ansatz</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../explanations/qiskit-gate-decompositions.html">Qubit gate decompositions of fermionic gates</a></li>
+</ul>
+</li>
+<li class="toctree-l1 has-children"><a class="reference internal" href="../../../how-to-guides/index.html">How-to guides</a><input class="toctree-checkbox" id="toctree-checkbox-3" name="toctree-checkbox-3" role="switch" type="checkbox"/><label for="toctree-checkbox-3"><div class="visually-hidden">Toggle navigation of How-to guides</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../how-to-guides/lucj.html">How to simulate the local unitary cluster Jastrow (LUCJ) ansatz</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../how-to-guides/entanglement-forging.html">How to simulate entanglement forging</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../how-to-guides/fermion-operator.html">How to use the FermionOperator class</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../how-to-guides/qiskit-circuits.html">How to build and transpile Qiskit quantum circuits</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../how-to-guides/qiskit-sampler.html">How to use ffsim’s Qiskit Sampler primitive</a></li>
+</ul>
+</li>
+<li class="toctree-l1 has-children"><a class="reference internal" href="../../../api/index.html">API reference</a><input class="toctree-checkbox" id="toctree-checkbox-4" name="toctree-checkbox-4" role="switch" type="checkbox"/><label for="toctree-checkbox-4"><div class="visually-hidden">Toggle navigation of API reference</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.html">ffsim</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.contract.html">ffsim.contract</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.linalg.html">ffsim.linalg</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.optimize.html">ffsim.optimize</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.qiskit.html">ffsim.qiskit</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.random.html">ffsim.random</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.testing.html">ffsim.testing</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference external" href="https://github.com/qiskit-community/ffsim">GitHub</a></li>
+<li class="toctree-l1"><a class="reference external" href="https://github.com/qiskit-community/ffsim/blob/main/CONTRIBUTING.md">Developer guide</a></li>
+<li class="toctree-l1"><a class="reference external" href="https://github.com/qiskit-community/ffsim/releases">Release notes</a></li>
+<li class="toctree-l1"><a class="reference external" href="https://qiskit-community.github.io/ffsim/dev/">Development branch docs</a></li>
+</ul>
+
+</div></div>
+      </div>
+      
+    </div>
+  </aside>
+  <div class="main">
+    <div class="content">
+      <div class="article-container">
+        <a href="#" class="back-to-top muted-link">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12z"></path>
+          </svg>
+          <span>Back to top</span>
+        </a>
+        <div class="content-icon-container">
+          <div class="theme-toggle-container theme-toggle-content">
+            <button class="theme-toggle">
+              <div class="visually-hidden">Toggle Light / Dark / Auto color theme</div>
+              <svg class="theme-icon-when-auto-light"><use href="#svg-sun-with-moon"></use></svg>
+              <svg class="theme-icon-when-auto-dark"><use href="#svg-moon-with-sun"></use></svg>
+              <svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
+              <svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
+            </button>
+          </div>
+          <label class="toc-overlay-icon toc-content-icon no-toc" for="__toc">
+            <div class="visually-hidden">Toggle table of contents sidebar</div>
+            <i class="icon"><svg><use href="#svg-toc"></use></svg></i>
+          </label>
+        </div>
+        <article role="main" id="furo-main-content">
+          <h1>Source code for ffsim.states.sample_slater</h1><div class="highlight"><pre>
+<span></span><span class="c1"># (C) Copyright IBM 2024.</span>
+<span class="c1">#</span>
+<span class="c1"># This code is licensed under the Apache License, Version 2.0. You may</span>
+<span class="c1"># obtain a copy of this license in the LICENSE.txt file in the root directory</span>
+<span class="c1"># of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.</span>
+<span class="c1">#</span>
+<span class="c1"># Any modifications or derivative works of this code must retain this</span>
+<span class="c1"># copyright notice, and modified files need to carry a notice indicating</span>
+<span class="c1"># that they have been altered from the originals.</span>
+
+<span class="sd">&quot;&quot;&quot;Function to sample bitstrings from a Slater determinant.&quot;&quot;&quot;</span>
+
+<span class="kn">from</span> <span class="nn">__future__</span> <span class="kn">import</span> <span class="n">annotations</span>
+
+<span class="kn">import</span> <span class="nn">itertools</span>
+<span class="kn">from</span> <span class="nn">collections.abc</span> <span class="kn">import</span> <span class="n">Sequence</span>
+<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">cast</span>
+
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+
+<span class="kn">from</span> <span class="nn">ffsim.states.bitstring</span> <span class="kn">import</span> <span class="p">(</span>
+    <span class="n">BitstringType</span><span class="p">,</span>
+    <span class="n">concatenate_bitstrings</span><span class="p">,</span>
+    <span class="n">convert_bitstring_type</span><span class="p">,</span>
+    <span class="n">restrict_bitstrings</span><span class="p">,</span>
+<span class="p">)</span>
+
+
+<div class="viewcode-block" id="sample_slater_determinant">
+<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.sample_slater_determinant">[docs]</a>
+<span class="k">def</span> <span class="nf">sample_slater_determinant</span><span class="p">(</span>
+    <span class="n">rdm</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">],</span>
+    <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
+    <span class="n">nelec</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">],</span>
+    <span class="o">*</span><span class="p">,</span>
+    <span class="n">orbs</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+    <span class="n">shots</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">1</span><span class="p">,</span>
+    <span class="n">concatenate</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
+    <span class="n">bitstring_type</span><span class="p">:</span> <span class="n">BitstringType</span> <span class="o">=</span> <span class="n">BitstringType</span><span class="o">.</span><span class="n">STRING</span><span class="p">,</span>
+    <span class="n">seed</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">Generator</span> <span class="o">|</span> <span class="nb">int</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">|</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">|</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Collect samples of electronic configurations from a Slater determinant.</span>
+
+<span class="sd">    The Slater determinant is defined by its one-body reduced density matrix (RDM).</span>
+<span class="sd">    The sampler uses a determinantal point process to auto-regressively produce</span>
+<span class="sd">    uncorrelated samples.</span>
+
+<span class="sd">    This sampling strategy is known as</span>
+<span class="sd">    `determinantal point processes &lt;https://arxiv.org/abs/1207.6083&gt;`</span>
+
+<span class="sd">    Args:</span>
+<span class="sd">        rdm: The one-body reduced density matrix that defines the Slater determinant</span>
+<span class="sd">            This is either a single Numpy array specifying the 1-RDM of a</span>
+<span class="sd">            spin-polarized system, or a pair of Numpy arrays where each element</span>
+<span class="sd">            of the pair contains the 1-RDM for each spin sector.</span>
+<span class="sd">        norb: The number of spatial orbitals.</span>
+<span class="sd">        nelec: Either a single integer representing the number of fermions for a</span>
+<span class="sd">            spinless system, or a pair of integers storing the numbers of spin alpha</span>
+<span class="sd">            and spin beta fermions.</span>
+<span class="sd">        shots: The number of bitstrings to sample.</span>
+<span class="sd">        concatenate: Whether to concatenate the spin-alpha and spin-beta parts of the</span>
+<span class="sd">            bitstrings. If True, then a single list of concatenated bitstrings is</span>
+<span class="sd">            returned. The strings are concatenated in the order :math:`s_b s_a`,</span>
+<span class="sd">            that is, the alpha string appears on the right.</span>
+<span class="sd">            If False, then two lists are returned, ``(strings_a, strings_b)``. Note that</span>
+<span class="sd">            the list of alpha strings appears first, that is, on the left.</span>
+<span class="sd">            In the spinless case (when `nelec` is an integer), this argument is ignored.</span>
+<span class="sd">        bitstring_type: The desired type of bitstring output.</span>
+<span class="sd">        seed: A seed to initialize the pseudorandom number generator.</span>
+<span class="sd">            Should be a valid input to ``np.random.default_rng``.</span>
+
+<span class="sd">    Returns:</span>
+<span class="sd">        A 2D Numpy array with samples of electronic configurations.</span>
+<span class="sd">        Each row is a sample.</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="n">rng</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">default_rng</span><span class="p">(</span><span class="n">seed</span><span class="p">)</span>
+
+    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">nelec</span><span class="p">,</span> <span class="nb">int</span><span class="p">):</span>
+        <span class="c1"># Spinless case</span>
+        <span class="n">rdm</span> <span class="o">=</span> <span class="n">cast</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">rdm</span><span class="p">)</span>
+        <span class="n">norb</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">rdm</span><span class="o">.</span><span class="n">shape</span>
+        <span class="k">if</span> <span class="n">orbs</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+            <span class="n">orbs</span> <span class="o">=</span> <span class="nb">range</span><span class="p">(</span><span class="n">norb</span><span class="p">)</span>
+        <span class="n">orbs</span> <span class="o">=</span> <span class="n">cast</span><span class="p">(</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">orbs</span><span class="p">)</span>
+        <span class="n">strings</span> <span class="o">=</span> <span class="n">_sample_slater_spinless</span><span class="p">(</span><span class="n">rdm</span><span class="p">,</span> <span class="n">nelec</span><span class="p">,</span> <span class="n">shots</span><span class="p">,</span> <span class="n">rng</span><span class="p">)</span>
+        <span class="n">strings</span> <span class="o">=</span> <span class="n">restrict_bitstrings</span><span class="p">(</span><span class="n">strings</span><span class="p">,</span> <span class="n">orbs</span><span class="p">,</span> <span class="n">bitstring_type</span><span class="o">=</span><span class="n">BitstringType</span><span class="o">.</span><span class="n">INT</span><span class="p">)</span>
+        <span class="k">return</span> <span class="n">convert_bitstring_type</span><span class="p">(</span>
+            <span class="n">strings</span><span class="p">,</span>
+            <span class="n">BitstringType</span><span class="o">.</span><span class="n">INT</span><span class="p">,</span>
+            <span class="n">bitstring_type</span><span class="p">,</span>
+            <span class="n">length</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">orbs</span><span class="p">),</span>
+        <span class="p">)</span>
+
+    <span class="c1"># Spinful case</span>
+    <span class="n">rdm_a</span><span class="p">,</span> <span class="n">rdm_b</span> <span class="o">=</span> <span class="n">rdm</span>
+    <span class="n">n_a</span><span class="p">,</span> <span class="n">n_b</span> <span class="o">=</span> <span class="n">nelec</span>
+    <span class="n">norb</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">rdm_a</span><span class="o">.</span><span class="n">shape</span>
+    <span class="k">if</span> <span class="n">orbs</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+        <span class="n">orbs</span> <span class="o">=</span> <span class="p">(</span><span class="nb">range</span><span class="p">(</span><span class="n">norb</span><span class="p">),</span> <span class="nb">range</span><span class="p">(</span><span class="n">norb</span><span class="p">))</span>
+    <span class="n">orbs_a</span><span class="p">,</span> <span class="n">orbs_b</span> <span class="o">=</span> <span class="n">orbs</span>
+    <span class="n">orbs_a</span> <span class="o">=</span> <span class="n">cast</span><span class="p">(</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">orbs_a</span><span class="p">)</span>
+    <span class="n">orbs_b</span> <span class="o">=</span> <span class="n">cast</span><span class="p">(</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">orbs_b</span><span class="p">)</span>
+    <span class="n">strings_a</span> <span class="o">=</span> <span class="n">_sample_slater_spinless</span><span class="p">(</span><span class="n">rdm_a</span><span class="p">,</span> <span class="n">n_a</span><span class="p">,</span> <span class="n">shots</span><span class="p">,</span> <span class="n">rng</span><span class="p">)</span>
+    <span class="n">strings_b</span> <span class="o">=</span> <span class="n">_sample_slater_spinless</span><span class="p">(</span><span class="n">rdm_b</span><span class="p">,</span> <span class="n">n_b</span><span class="p">,</span> <span class="n">shots</span><span class="p">,</span> <span class="n">rng</span><span class="p">)</span>
+    <span class="n">strings_a</span> <span class="o">=</span> <span class="n">restrict_bitstrings</span><span class="p">(</span><span class="n">strings_a</span><span class="p">,</span> <span class="n">orbs_a</span><span class="p">,</span> <span class="n">bitstring_type</span><span class="o">=</span><span class="n">BitstringType</span><span class="o">.</span><span class="n">INT</span><span class="p">)</span>
+    <span class="n">strings_b</span> <span class="o">=</span> <span class="n">restrict_bitstrings</span><span class="p">(</span><span class="n">strings_b</span><span class="p">,</span> <span class="n">orbs_b</span><span class="p">,</span> <span class="n">bitstring_type</span><span class="o">=</span><span class="n">BitstringType</span><span class="o">.</span><span class="n">INT</span><span class="p">)</span>
+
+    <span class="k">if</span> <span class="n">concatenate</span><span class="p">:</span>
+        <span class="n">strings</span> <span class="o">=</span> <span class="n">concatenate_bitstrings</span><span class="p">(</span>
+            <span class="n">strings_a</span><span class="p">,</span>
+            <span class="n">strings_b</span><span class="p">,</span>
+            <span class="n">BitstringType</span><span class="o">.</span><span class="n">INT</span><span class="p">,</span>
+            <span class="n">length</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">orbs_a</span><span class="p">),</span>
+        <span class="p">)</span>
+        <span class="k">return</span> <span class="n">convert_bitstring_type</span><span class="p">(</span>
+            <span class="n">strings</span><span class="p">,</span>
+            <span class="n">BitstringType</span><span class="o">.</span><span class="n">INT</span><span class="p">,</span>
+            <span class="n">bitstring_type</span><span class="p">,</span>
+            <span class="n">length</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">orbs_a</span><span class="p">)</span> <span class="o">+</span> <span class="nb">len</span><span class="p">(</span><span class="n">orbs_b</span><span class="p">),</span>
+        <span class="p">)</span>
+
+    <span class="k">return</span> <span class="n">convert_bitstring_type</span><span class="p">(</span>
+        <span class="n">strings_a</span><span class="p">,</span>
+        <span class="n">BitstringType</span><span class="o">.</span><span class="n">INT</span><span class="p">,</span>
+        <span class="n">bitstring_type</span><span class="p">,</span>
+        <span class="n">length</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">orbs_a</span><span class="p">),</span>
+    <span class="p">),</span> <span class="n">convert_bitstring_type</span><span class="p">(</span>
+        <span class="n">strings_b</span><span class="p">,</span>
+        <span class="n">BitstringType</span><span class="o">.</span><span class="n">INT</span><span class="p">,</span>
+        <span class="n">bitstring_type</span><span class="p">,</span>
+        <span class="n">length</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">orbs_b</span><span class="p">),</span>
+    <span class="p">)</span></div>
+
+
+
+<span class="k">def</span> <span class="nf">_sample_slater_spinless</span><span class="p">(</span>
+    <span class="n">rdm</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span>
+    <span class="n">nelec</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
+    <span class="n">shots</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
+    <span class="n">seed</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">Generator</span> <span class="o">|</span> <span class="nb">int</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+<span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">int</span><span class="p">]:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Collect samples of electronic configurations from a Slater determinant.</span>
+
+<span class="sd">    The Slater determinant is defined by its one-body reduced density matrix (RDM).</span>
+<span class="sd">    The sampler uses a determinantal point process to auto-regressively produce</span>
+<span class="sd">    uncorrelated samples.</span>
+
+<span class="sd">    Args:</span>
+<span class="sd">        rdm: The one-body reduced density matrix that defines the Slater determinant.</span>
+<span class="sd">        shots: Number of samples to collect.</span>
+<span class="sd">        seed: A seed to initialize the pseudorandom number generator.</span>
+<span class="sd">            Should be a valid input to ``np.random.default_rng``.</span>
+
+<span class="sd">    Returns:</span>
+<span class="sd">        The sampled bitstrings in integer format.</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="n">norb</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">rdm</span><span class="o">.</span><span class="n">shape</span>
+
+    <span class="k">if</span> <span class="n">nelec</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+        <span class="k">return</span> <span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">*</span> <span class="n">shots</span>
+
+    <span class="k">if</span> <span class="n">nelec</span> <span class="o">==</span> <span class="n">norb</span><span class="p">:</span>
+        <span class="k">return</span> <span class="p">[(</span><span class="mi">1</span> <span class="o">&lt;&lt;</span> <span class="n">norb</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span><span class="p">]</span> <span class="o">*</span> <span class="n">shots</span>
+
+    <span class="n">rng</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">default_rng</span><span class="p">(</span><span class="n">seed</span><span class="p">)</span>
+    <span class="n">samples</span> <span class="o">=</span> <span class="p">[</span><span class="n">_autoregressive_slater</span><span class="p">(</span><span class="n">rdm</span><span class="p">,</span> <span class="n">norb</span><span class="p">,</span> <span class="n">nelec</span><span class="p">,</span> <span class="n">rng</span><span class="p">)</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">shots</span><span class="p">)]</span>
+    <span class="k">return</span> <span class="p">[</span><span class="nb">sum</span><span class="p">(</span><span class="mi">1</span> <span class="o">&lt;&lt;</span> <span class="n">orb</span> <span class="k">for</span> <span class="n">orb</span> <span class="ow">in</span> <span class="n">sample</span><span class="p">)</span> <span class="k">for</span> <span class="n">sample</span> <span class="ow">in</span> <span class="n">samples</span><span class="p">]</span>
+
+
+<span class="k">def</span> <span class="nf">_autoregressive_slater</span><span class="p">(</span>
+    <span class="n">rdm</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span>
+    <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
+    <span class="n">nelec</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
+    <span class="n">seed</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">Generator</span> <span class="o">|</span> <span class="nb">int</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+<span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">set</span><span class="p">[</span><span class="nb">int</span><span class="p">]:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Autoregressively sample occupied orbitals for a Slater determinant.</span>
+
+<span class="sd">    Args:</span>
+<span class="sd">        rdm: The one-body reduced density matrix.</span>
+<span class="sd">        norb: The number of orbitals.</span>
+<span class="sd">        nelec: The number of electrons.</span>
+<span class="sd">        seed: A seed to initialize the pseudorandom number generator.</span>
+<span class="sd">            Should be a valid input to ``np.random.default_rng``.</span>
+
+<span class="sd">    Returns:</span>
+<span class="sd">        A set containing the occupied orbitals.</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="n">rng</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">default_rng</span><span class="p">(</span><span class="n">seed</span><span class="p">)</span>
+    <span class="n">orb</span> <span class="o">=</span> <span class="n">rng</span><span class="o">.</span><span class="n">choice</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">p</span><span class="o">=</span><span class="n">np</span><span class="o">.</span><span class="n">diag</span><span class="p">(</span><span class="n">rdm</span><span class="p">)</span><span class="o">.</span><span class="n">real</span> <span class="o">/</span> <span class="n">nelec</span><span class="p">)</span>
+    <span class="n">sample</span> <span class="o">=</span> <span class="p">{</span><span class="n">orb</span><span class="p">}</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">nelec</span> <span class="o">-</span> <span class="mi">1</span><span class="p">):</span>
+        <span class="n">index</span> <span class="o">=</span> <span class="n">rng</span><span class="o">.</span><span class="n">choice</span><span class="p">(</span><span class="n">norb</span> <span class="o">-</span> <span class="mi">1</span> <span class="o">-</span> <span class="n">i</span><span class="p">,</span> <span class="n">p</span><span class="o">=</span><span class="n">_generate_probs</span><span class="p">(</span><span class="n">rdm</span><span class="p">,</span> <span class="n">sample</span><span class="p">,</span> <span class="n">norb</span><span class="p">))</span>
+        <span class="n">empty_orbitals</span> <span class="o">=</span> <span class="p">(</span><span class="n">orb</span> <span class="k">for</span> <span class="n">orb</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">norb</span><span class="p">)</span> <span class="k">if</span> <span class="n">orb</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">sample</span><span class="p">)</span>
+        <span class="n">sample</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="nb">next</span><span class="p">(</span><span class="n">itertools</span><span class="o">.</span><span class="n">islice</span><span class="p">(</span><span class="n">empty_orbitals</span><span class="p">,</span> <span class="n">index</span><span class="p">,</span> <span class="kc">None</span><span class="p">)))</span>
+    <span class="k">return</span> <span class="n">sample</span>
+
+
+<span class="k">def</span> <span class="nf">_generate_probs</span><span class="p">(</span><span class="n">rdm</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">sample</span><span class="p">:</span> <span class="nb">set</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Computes the probabilities for the next occupied orbital.</span>
+
+<span class="sd">    This is a step of the autoregressive sampling, and uses Bayes&#39;s rule.</span>
+
+<span class="sd">    Args:</span>
+<span class="sd">        rdm: A Numpy array with the one-body reduced density matrix.</span>
+<span class="sd">        sample: The list of already occupied orbitals.</span>
+<span class="sd">        norb: The number of orbitals.</span>
+
+<span class="sd">    Returns:</span>
+<span class="sd">        The probabilities for the next empty orbital to occupy.</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="n">probs</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">(</span><span class="n">norb</span> <span class="o">-</span> <span class="nb">len</span><span class="p">(</span><span class="n">sample</span><span class="p">))</span>
+    <span class="n">empty_orbitals</span> <span class="o">=</span> <span class="p">(</span><span class="n">orb</span> <span class="k">for</span> <span class="n">orb</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">norb</span><span class="p">)</span> <span class="k">if</span> <span class="n">orb</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">sample</span><span class="p">)</span>
+    <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">orb</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">empty_orbitals</span><span class="p">):</span>
+        <span class="n">indices</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">sample</span> <span class="o">|</span> <span class="p">{</span><span class="n">orb</span><span class="p">})</span>
+        <span class="n">probs</span><span class="p">[</span><span class="n">i</span><span class="p">]</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">linalg</span><span class="o">.</span><span class="n">det</span><span class="p">(</span><span class="n">rdm</span><span class="p">[</span><span class="n">indices</span><span class="p">][:,</span> <span class="n">indices</span><span class="p">])</span><span class="o">.</span><span class="n">real</span>
+    <span class="k">return</span> <span class="n">probs</span> <span class="o">/</span> <span class="n">np</span><span class="o">.</span><span class="n">sum</span><span class="p">(</span><span class="n">probs</span><span class="p">)</span>
+</pre></div>
+        </article>
+      </div>
+      <footer>
+        
+        <div class="related-pages">
+          
+          
+        </div>
+        <div class="bottom-of-page">
+          <div class="left-details">
+            <div class="copyright">
+                Copyright &#169; 2023, IBM
+            </div>
+            Made with <a href="https://www.sphinx-doc.org/">Sphinx</a> and <a class="muted-link" href="https://pradyunsg.me">@pradyunsg</a>'s
+            
+            <a href="https://github.com/pradyunsg/furo">Furo</a>
+            
+          </div>
+          <div class="right-details">
+            
+          </div>
+        </div>
+        
+      </footer>
+    </div>
+    <aside class="toc-drawer no-toc">
+      
+      
+      
+    </aside>
+  </div>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
+    <script src="../../../_static/doctools.js?v=9bcbadda"></script>
+    <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
+    <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
+    <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+    </body>
+</html>
\ No newline at end of file
diff --git a/_modules/ffsim/states/slater.html b/_modules/ffsim/states/slater.html
index ab591cc10..8f0aed2fb 100644
--- a/_modules/ffsim/states/slater.html
+++ b/_modules/ffsim/states/slater.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.states.slater - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.states.slater - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -278,208 +278,369 @@ <h1>Source code for ffsim.states.slater</h1><div class="highlight"><pre>
 
 <span class="kn">from</span> <span class="nn">__future__</span> <span class="kn">import</span> <span class="n">annotations</span>
 
-<span class="kn">import</span> <span class="nn">itertools</span>
 <span class="kn">from</span> <span class="nn">collections.abc</span> <span class="kn">import</span> <span class="n">Sequence</span>
-<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">cast</span>
+<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">cast</span><span class="p">,</span> <span class="n">overload</span>
 
 <span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+<span class="kn">import</span> <span class="nn">scipy.linalg</span>
+<span class="kn">from</span> <span class="nn">pyscf.fci</span> <span class="kn">import</span> <span class="n">cistring</span>
+<span class="kn">from</span> <span class="nn">typing_extensions</span> <span class="kn">import</span> <span class="n">deprecated</span>
 
+<span class="kn">from</span> <span class="nn">ffsim</span> <span class="kn">import</span> <span class="n">linalg</span>
+<span class="kn">from</span> <span class="nn">ffsim.gates.orbital_rotation</span> <span class="kn">import</span> <span class="n">apply_orbital_rotation</span>
 <span class="kn">from</span> <span class="nn">ffsim.states.bitstring</span> <span class="kn">import</span> <span class="p">(</span>
-    <span class="n">BitstringType</span><span class="p">,</span>
-    <span class="n">concatenate_bitstrings</span><span class="p">,</span>
-    <span class="n">convert_bitstring_type</span><span class="p">,</span>
-    <span class="n">restrict_bitstrings</span><span class="p">,</span>
+    <span class="n">bitstring_to_occupied_orbitals</span><span class="p">,</span>
 <span class="p">)</span>
+<span class="kn">from</span> <span class="nn">ffsim.states.states</span> <span class="kn">import</span> <span class="n">dims</span>
 
 
-<div class="viewcode-block" id="sample_slater_determinant">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.sample_slater_determinant">[docs]</a>
-<span class="k">def</span> <span class="nf">sample_slater_determinant</span><span class="p">(</span>
-    <span class="n">rdm</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">],</span>
+<span class="nd">@overload</span>
+<span class="k">def</span> <span class="nf">slater_determinant</span><span class="p">(</span>
     <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-    <span class="n">nelec</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">],</span>
-    <span class="o">*</span><span class="p">,</span>
-    <span class="n">orbs</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-    <span class="n">shots</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">1</span><span class="p">,</span>
-    <span class="n">concatenate</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
-    <span class="n">bitstring_type</span><span class="p">:</span> <span class="n">BitstringType</span> <span class="o">=</span> <span class="n">BitstringType</span><span class="o">.</span><span class="n">STRING</span><span class="p">,</span>
-    <span class="n">seed</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">Generator</span> <span class="o">|</span> <span class="nb">int</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">|</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">|</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Collect samples of electronic configurations from a Slater determinant.</span>
+    <span class="n">occupied_orbitals</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span>
+    <span class="n">orbital_rotation</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span> <span class="o">...</span>
+<span class="nd">@overload</span>
+<span class="k">def</span> <span class="nf">slater_determinant</span><span class="p">(</span>
+    <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
+    <span class="n">occupied_orbitals</span><span class="p">:</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]],</span>
+    <span class="n">orbital_rotation</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span>
+    <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">]</span>
+    <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span> <span class="o">...</span>
+<div class="viewcode-block" id="slater_determinant">
+<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.slater_determinant">[docs]</a>
+<span class="k">def</span> <span class="nf">slater_determinant</span><span class="p">(</span>
+    <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
+    <span class="n">occupied_orbitals</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]],</span>
+    <span class="n">orbital_rotation</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span>
+    <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">]</span>
+    <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
+<span class="w">    </span><span class="sa">r</span><span class="sd">&quot;&quot;&quot;Return a Slater determinant.</span>
+
+<span class="sd">    A Slater determinant is a state of the form</span>
+
+<span class="sd">    .. math::</span>
+
+<span class="sd">        \mathcal{U} \lvert x \rangle,</span>
+
+<span class="sd">    where :math:`\mathcal{U}` is an</span>
+<span class="sd">    :doc:`orbital rotation &lt;/explanations/orbital-rotation&gt;` and</span>
+<span class="sd">    :math:`\lvert x \rangle` is an electronic configuration.</span>
+
+<span class="sd">    Args:</span>
+<span class="sd">        norb: The number of spatial orbitals.</span>
+<span class="sd">        occupied_orbitals: The occupied orbitals in the electronic configuration.</span>
+<span class="sd">            This is either a list of integers specifying spinless orbitals, or a</span>
+<span class="sd">            pair of lists, where the first list specifies the spin alpha orbitals and</span>
+<span class="sd">            the second list specifies the spin beta orbitals.</span>
+<span class="sd">        orbital_rotation: The optional orbital rotation.</span>
+<span class="sd">            You can pass either a single Numpy array specifying the orbital rotation</span>
+<span class="sd">            to apply to both spin sectors, or you can pass a pair of Numpy arrays</span>
+<span class="sd">            specifying independent orbital rotations for spin alpha and spin beta.</span>
+<span class="sd">            If passing a pair, you can use ``None`` for one of the</span>
+<span class="sd">            values in the pair to indicate that no operation should be applied to</span>
+<span class="sd">            that spin sector.</span>
+
+<span class="sd">    Returns:</span>
+<span class="sd">        The Slater determinant as a state vector.</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">if</span> <span class="n">norb</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+        <span class="k">return</span> <span class="n">np</span><span class="o">.</span><span class="n">ones</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">complex</span><span class="p">)</span>
+
+    <span class="k">if</span> <span class="ow">not</span> <span class="n">occupied_orbitals</span> <span class="ow">or</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">occupied_orbitals</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="p">(</span><span class="nb">int</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">integer</span><span class="p">)):</span>
+        <span class="n">occupied_orbitals</span> <span class="o">=</span> <span class="p">(</span><span class="n">cast</span><span class="p">(</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">occupied_orbitals</span><span class="p">),</span> <span class="p">[])</span>
+
+    <span class="n">alpha_orbitals</span><span class="p">,</span> <span class="n">beta_orbitals</span> <span class="o">=</span> <span class="n">cast</span><span class="p">(</span>
+        <span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]],</span> <span class="n">occupied_orbitals</span>
+    <span class="p">)</span>
+    <span class="n">n_alpha</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">alpha_orbitals</span><span class="p">)</span>
+    <span class="n">n_beta</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">beta_orbitals</span><span class="p">)</span>
+    <span class="n">nelec</span> <span class="o">=</span> <span class="p">(</span><span class="n">n_alpha</span><span class="p">,</span> <span class="n">n_beta</span><span class="p">)</span>
+    <span class="n">dim1</span><span class="p">,</span> <span class="n">dim2</span> <span class="o">=</span> <span class="n">dims</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">nelec</span><span class="p">)</span>
+    <span class="n">alpha_bits</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">bool</span><span class="p">)</span>
+    <span class="n">alpha_bits</span><span class="p">[</span><span class="nb">list</span><span class="p">(</span><span class="n">alpha_orbitals</span><span class="p">)]</span> <span class="o">=</span> <span class="mi">1</span>
+    <span class="n">alpha_string</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="s2">&quot;&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="s2">&quot;1&quot;</span> <span class="k">if</span> <span class="n">b</span> <span class="k">else</span> <span class="s2">&quot;0&quot;</span> <span class="k">for</span> <span class="n">b</span> <span class="ow">in</span> <span class="n">alpha_bits</span><span class="p">[::</span><span class="o">-</span><span class="mi">1</span><span class="p">]),</span> <span class="n">base</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">alpha_index</span> <span class="o">=</span> <span class="n">cistring</span><span class="o">.</span><span class="n">str2addr</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">n_alpha</span><span class="p">,</span> <span class="n">alpha_string</span><span class="p">)</span>
+    <span class="n">beta_bits</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">bool</span><span class="p">)</span>
+    <span class="n">beta_bits</span><span class="p">[</span><span class="nb">list</span><span class="p">(</span><span class="n">beta_orbitals</span><span class="p">)]</span> <span class="o">=</span> <span class="mi">1</span>
+    <span class="n">beta_string</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="s2">&quot;&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="s2">&quot;1&quot;</span> <span class="k">if</span> <span class="n">b</span> <span class="k">else</span> <span class="s2">&quot;0&quot;</span> <span class="k">for</span> <span class="n">b</span> <span class="ow">in</span> <span class="n">beta_bits</span><span class="p">[::</span><span class="o">-</span><span class="mi">1</span><span class="p">]),</span> <span class="n">base</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">beta_index</span> <span class="o">=</span> <span class="n">cistring</span><span class="o">.</span><span class="n">str2addr</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">n_beta</span><span class="p">,</span> <span class="n">beta_string</span><span class="p">)</span>
+    <span class="n">vec</span> <span class="o">=</span> <span class="n">linalg</span><span class="o">.</span><span class="n">one_hot</span><span class="p">(</span>
+        <span class="p">(</span><span class="n">dim1</span><span class="p">,</span> <span class="n">dim2</span><span class="p">),</span> <span class="p">(</span><span class="n">alpha_index</span><span class="p">,</span> <span class="n">beta_index</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">complex</span>
+    <span class="p">)</span><span class="o">.</span><span class="n">reshape</span><span class="p">(</span><span class="o">-</span><span class="mi">1</span><span class="p">)</span>
+    <span class="k">if</span> <span class="n">orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+        <span class="n">vec</span> <span class="o">=</span> <span class="n">apply_orbital_rotation</span><span class="p">(</span>
+            <span class="n">vec</span><span class="p">,</span> <span class="n">orbital_rotation</span><span class="p">,</span> <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span> <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">,</span> <span class="n">copy</span><span class="o">=</span><span class="kc">False</span>
+        <span class="p">)</span>
+    <span class="k">return</span> <span class="n">vec</span></div>
+
 
-<span class="sd">    The Slater determinant is defined by its one-body reduced density matrix (RDM).</span>
-<span class="sd">    The sampler uses a determinantal point process to auto-regressively produce</span>
-<span class="sd">    uncorrelated samples.</span>
 
-<span class="sd">    This sampling strategy is known as</span>
-<span class="sd">    `determinantal point processes &lt;https://arxiv.org/abs/1207.6083&gt;`</span>
+<div class="viewcode-block" id="hartree_fock_state">
+<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.hartree_fock_state">[docs]</a>
+<span class="k">def</span> <span class="nf">hartree_fock_state</span><span class="p">(</span><span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">nelec</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Return the Hartree-Fock state.</span>
 
 <span class="sd">    Args:</span>
-<span class="sd">        rdm: The one-body reduced density matrix that defines the Slater determinant</span>
-<span class="sd">            This is either a single Numpy array specifying the 1-RDM of a</span>
-<span class="sd">            spin-polarized system, or a pair of Numpy arrays where each element</span>
-<span class="sd">            of the pair contains the 1-RDM for each spin sector.</span>
 <span class="sd">        norb: The number of spatial orbitals.</span>
 <span class="sd">        nelec: Either a single integer representing the number of fermions for a</span>
 <span class="sd">            spinless system, or a pair of integers storing the numbers of spin alpha</span>
 <span class="sd">            and spin beta fermions.</span>
-<span class="sd">        shots: The number of bitstrings to sample.</span>
-<span class="sd">        concatenate: Whether to concatenate the spin-alpha and spin-beta parts of the</span>
-<span class="sd">            bitstrings. If True, then a single list of concatenated bitstrings is</span>
-<span class="sd">            returned. The strings are concatenated in the order :math:`s_b s_a`,</span>
-<span class="sd">            that is, the alpha string appears on the right.</span>
-<span class="sd">            If False, then two lists are returned, ``(strings_a, strings_b)``. Note that</span>
-<span class="sd">            the list of alpha strings appears first, that is, on the left.</span>
-<span class="sd">            In the spinless case (when `nelec` is an integer), this argument is ignored.</span>
-<span class="sd">        bitstring_type: The desired type of bitstring output.</span>
-<span class="sd">        seed: A seed to initialize the pseudorandom number generator.</span>
-<span class="sd">            Should be a valid input to ``np.random.default_rng``.</span>
 
 <span class="sd">    Returns:</span>
-<span class="sd">        A 2D Numpy array with samples of electronic configurations.</span>
-<span class="sd">        Each row is a sample.</span>
+<span class="sd">        The Hartree-Fock state as a state vector.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">rng</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">default_rng</span><span class="p">(</span><span class="n">seed</span><span class="p">)</span>
-
     <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">nelec</span><span class="p">,</span> <span class="nb">int</span><span class="p">):</span>
-        <span class="c1"># Spinless case</span>
-        <span class="n">rdm</span> <span class="o">=</span> <span class="n">cast</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">rdm</span><span class="p">)</span>
-        <span class="n">norb</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">rdm</span><span class="o">.</span><span class="n">shape</span>
-        <span class="k">if</span> <span class="n">orbs</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">orbs</span> <span class="o">=</span> <span class="nb">range</span><span class="p">(</span><span class="n">norb</span><span class="p">)</span>
-        <span class="n">orbs</span> <span class="o">=</span> <span class="n">cast</span><span class="p">(</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">orbs</span><span class="p">)</span>
-        <span class="n">strings</span> <span class="o">=</span> <span class="n">_sample_slater_spinless</span><span class="p">(</span><span class="n">rdm</span><span class="p">,</span> <span class="n">nelec</span><span class="p">,</span> <span class="n">shots</span><span class="p">,</span> <span class="n">rng</span><span class="p">)</span>
-        <span class="n">strings</span> <span class="o">=</span> <span class="n">restrict_bitstrings</span><span class="p">(</span><span class="n">strings</span><span class="p">,</span> <span class="n">orbs</span><span class="p">,</span> <span class="n">bitstring_type</span><span class="o">=</span><span class="n">BitstringType</span><span class="o">.</span><span class="n">INT</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">convert_bitstring_type</span><span class="p">(</span>
-            <span class="n">strings</span><span class="p">,</span>
-            <span class="n">BitstringType</span><span class="o">.</span><span class="n">INT</span><span class="p">,</span>
-            <span class="n">bitstring_type</span><span class="p">,</span>
-            <span class="n">length</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">orbs</span><span class="p">),</span>
-        <span class="p">)</span>
+        <span class="k">return</span> <span class="n">slater_determinant</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">occupied_orbitals</span><span class="o">=</span><span class="nb">range</span><span class="p">(</span><span class="n">nelec</span><span class="p">))</span>
 
-    <span class="c1"># Spinful case</span>
-    <span class="n">rdm_a</span><span class="p">,</span> <span class="n">rdm_b</span> <span class="o">=</span> <span class="n">rdm</span>
-    <span class="n">n_a</span><span class="p">,</span> <span class="n">n_b</span> <span class="o">=</span> <span class="n">nelec</span>
-    <span class="n">norb</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">rdm_a</span><span class="o">.</span><span class="n">shape</span>
-    <span class="k">if</span> <span class="n">orbs</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">orbs</span> <span class="o">=</span> <span class="p">(</span><span class="nb">range</span><span class="p">(</span><span class="n">norb</span><span class="p">),</span> <span class="nb">range</span><span class="p">(</span><span class="n">norb</span><span class="p">))</span>
-    <span class="n">orbs_a</span><span class="p">,</span> <span class="n">orbs_b</span> <span class="o">=</span> <span class="n">orbs</span>
-    <span class="n">orbs_a</span> <span class="o">=</span> <span class="n">cast</span><span class="p">(</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">orbs_a</span><span class="p">)</span>
-    <span class="n">orbs_b</span> <span class="o">=</span> <span class="n">cast</span><span class="p">(</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">orbs_b</span><span class="p">)</span>
-    <span class="n">strings_a</span> <span class="o">=</span> <span class="n">_sample_slater_spinless</span><span class="p">(</span><span class="n">rdm_a</span><span class="p">,</span> <span class="n">n_a</span><span class="p">,</span> <span class="n">shots</span><span class="p">,</span> <span class="n">rng</span><span class="p">)</span>
-    <span class="n">strings_b</span> <span class="o">=</span> <span class="n">_sample_slater_spinless</span><span class="p">(</span><span class="n">rdm_b</span><span class="p">,</span> <span class="n">n_b</span><span class="p">,</span> <span class="n">shots</span><span class="p">,</span> <span class="n">rng</span><span class="p">)</span>
-    <span class="n">strings_a</span> <span class="o">=</span> <span class="n">restrict_bitstrings</span><span class="p">(</span><span class="n">strings_a</span><span class="p">,</span> <span class="n">orbs_a</span><span class="p">,</span> <span class="n">bitstring_type</span><span class="o">=</span><span class="n">BitstringType</span><span class="o">.</span><span class="n">INT</span><span class="p">)</span>
-    <span class="n">strings_b</span> <span class="o">=</span> <span class="n">restrict_bitstrings</span><span class="p">(</span><span class="n">strings_b</span><span class="p">,</span> <span class="n">orbs_b</span><span class="p">,</span> <span class="n">bitstring_type</span><span class="o">=</span><span class="n">BitstringType</span><span class="o">.</span><span class="n">INT</span><span class="p">)</span>
-
-    <span class="k">if</span> <span class="n">concatenate</span><span class="p">:</span>
-        <span class="n">strings</span> <span class="o">=</span> <span class="n">concatenate_bitstrings</span><span class="p">(</span>
-            <span class="n">strings_a</span><span class="p">,</span>
-            <span class="n">strings_b</span><span class="p">,</span>
-            <span class="n">BitstringType</span><span class="o">.</span><span class="n">INT</span><span class="p">,</span>
-            <span class="n">length</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">orbs_a</span><span class="p">),</span>
-        <span class="p">)</span>
-        <span class="k">return</span> <span class="n">convert_bitstring_type</span><span class="p">(</span>
-            <span class="n">strings</span><span class="p">,</span>
-            <span class="n">BitstringType</span><span class="o">.</span><span class="n">INT</span><span class="p">,</span>
-            <span class="n">bitstring_type</span><span class="p">,</span>
-            <span class="n">length</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">orbs_a</span><span class="p">)</span> <span class="o">+</span> <span class="nb">len</span><span class="p">(</span><span class="n">orbs_b</span><span class="p">),</span>
-        <span class="p">)</span>
+    <span class="n">n_alpha</span><span class="p">,</span> <span class="n">n_beta</span> <span class="o">=</span> <span class="n">nelec</span>
+    <span class="k">return</span> <span class="n">slater_determinant</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">occupied_orbitals</span><span class="o">=</span><span class="p">(</span><span class="nb">range</span><span class="p">(</span><span class="n">n_alpha</span><span class="p">),</span> <span class="nb">range</span><span class="p">(</span><span class="n">n_beta</span><span class="p">)))</span></div>
 
-    <span class="k">return</span> <span class="n">convert_bitstring_type</span><span class="p">(</span>
-        <span class="n">strings_a</span><span class="p">,</span>
-        <span class="n">BitstringType</span><span class="o">.</span><span class="n">INT</span><span class="p">,</span>
-        <span class="n">bitstring_type</span><span class="p">,</span>
-        <span class="n">length</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">orbs_a</span><span class="p">),</span>
-    <span class="p">),</span> <span class="n">convert_bitstring_type</span><span class="p">(</span>
-        <span class="n">strings_b</span><span class="p">,</span>
-        <span class="n">BitstringType</span><span class="o">.</span><span class="n">INT</span><span class="p">,</span>
-        <span class="n">bitstring_type</span><span class="p">,</span>
-        <span class="n">length</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">orbs_b</span><span class="p">),</span>
-    <span class="p">)</span></div>
 
 
+<div class="viewcode-block" id="slater_determinant_rdm">
+<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.slater_determinant_rdm">[docs]</a>
+<span class="nd">@deprecated</span><span class="p">(</span>
+    <span class="s2">&quot;ffsim.slater_determinant_rdm is deprecated. &quot;</span>
+    <span class="s2">&quot;Instead, use ffsim.slater_determinant_rdms.&quot;</span>
+<span class="p">)</span>
+<span class="k">def</span> <span class="nf">slater_determinant_rdm</span><span class="p">(</span>
+    <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
+    <span class="n">occupied_orbitals</span><span class="p">:</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]],</span>
+    <span class="n">orbital_rotation</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span>
+    <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">]</span>
+    <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+    <span class="n">rank</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">1</span><span class="p">,</span>
+    <span class="n">spin_summed</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
+<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Return the reduced density matrix of a `Slater determinant`_.</span>
 
-<span class="k">def</span> <span class="nf">_sample_slater_spinless</span><span class="p">(</span>
-    <span class="n">rdm</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span>
-    <span class="n">nelec</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-    <span class="n">shots</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-    <span class="n">seed</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">Generator</span> <span class="o">|</span> <span class="nb">int</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-<span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">int</span><span class="p">]:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Collect samples of electronic configurations from a Slater determinant.</span>
+<span class="sd">    .. warning::</span>
+<span class="sd">        This function is deprecated. Use :func:`ffsim.slater_determinant_rdms` instead.</span>
 
-<span class="sd">    The Slater determinant is defined by its one-body reduced density matrix (RDM).</span>
-<span class="sd">    The sampler uses a determinantal point process to auto-regressively produce</span>
-<span class="sd">    uncorrelated samples.</span>
+<span class="sd">    Note:</span>
+<span class="sd">        Currently, only rank 1 is supported.</span>
 
 <span class="sd">    Args:</span>
-<span class="sd">        rdm: The one-body reduced density matrix that defines the Slater determinant.</span>
-<span class="sd">        shots: Number of samples to collect.</span>
-<span class="sd">        seed: A seed to initialize the pseudorandom number generator.</span>
-<span class="sd">            Should be a valid input to ``np.random.default_rng``.</span>
+<span class="sd">        norb: The number of spatial orbitals.</span>
+<span class="sd">        occupied_orbitals: The occupied orbitals in the electronic configuration.</span>
+<span class="sd">            This is a pair of lists of integers, where the first list specifies the</span>
+<span class="sd">            spin alpha orbitals and the second list specifies the spin beta</span>
+<span class="sd">            orbitals.</span>
+<span class="sd">        orbital_rotation: The optional orbital rotation.</span>
+<span class="sd">            You can pass either a single Numpy array specifying the orbital rotation</span>
+<span class="sd">            to apply to both spin sectors, or you can pass a pair of Numpy arrays</span>
+<span class="sd">            specifying independent orbital rotations for spin alpha and spin beta.</span>
+<span class="sd">            If passing a pair, you can use ``None`` for one of the</span>
+<span class="sd">            values in the pair to indicate that no operation should be applied to that</span>
+<span class="sd">            spin sector.</span>
+<span class="sd">        rank: The rank of the reduced density matrix. I.e., rank 1 corresponds to the</span>
+<span class="sd">            one-particle RDM, rank 2 corresponds to the 2-particle RDM, etc.</span>
+<span class="sd">        spin_summed: Whether to sum over the spin index.</span>
 
 <span class="sd">    Returns:</span>
-<span class="sd">        The sampled bitstrings in integer format.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">norb</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">rdm</span><span class="o">.</span><span class="n">shape</span>
-
-    <span class="k">if</span> <span class="n">nelec</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
-        <span class="k">return</span> <span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">*</span> <span class="n">shots</span>
+<span class="sd">        The reduced density matrix of the Slater determinant.</span>
 
-    <span class="k">if</span> <span class="n">nelec</span> <span class="o">==</span> <span class="n">norb</span><span class="p">:</span>
-        <span class="k">return</span> <span class="p">[(</span><span class="mi">1</span> <span class="o">&lt;&lt;</span> <span class="n">norb</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span><span class="p">]</span> <span class="o">*</span> <span class="n">shots</span>
+<span class="sd">    .. _Slater determinant: ffsim.html#ffsim.slater_determinant</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">if</span> <span class="n">rank</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+        <span class="n">rdm_a</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">complex</span><span class="p">)</span>
+        <span class="n">rdm_b</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">complex</span><span class="p">)</span>
+        <span class="n">alpha_orbitals</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">occupied_orbitals</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+        <span class="n">beta_orbitals</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">occupied_orbitals</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">alpha_orbitals</span><span class="p">):</span>
+            <span class="n">rdm_a</span><span class="p">[(</span><span class="n">alpha_orbitals</span><span class="p">,</span> <span class="n">alpha_orbitals</span><span class="p">)]</span> <span class="o">=</span> <span class="mi">1</span>
+        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">beta_orbitals</span><span class="p">):</span>
+            <span class="n">rdm_b</span><span class="p">[(</span><span class="n">beta_orbitals</span><span class="p">,</span> <span class="n">beta_orbitals</span><span class="p">)]</span> <span class="o">=</span> <span class="mi">1</span>
+        <span class="k">if</span> <span class="n">orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">orbital_rotation</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">):</span>
+                <span class="n">orbital_rotation_a</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="n">orbital_rotation</span>
+                <span class="n">orbital_rotation_b</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="n">orbital_rotation</span>
+            <span class="k">else</span><span class="p">:</span>
+                <span class="n">orbital_rotation_a</span><span class="p">,</span> <span class="n">orbital_rotation_b</span> <span class="o">=</span> <span class="n">orbital_rotation</span>
+            <span class="k">if</span> <span class="n">orbital_rotation_a</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+                <span class="n">rdm_a</span> <span class="o">=</span> <span class="n">orbital_rotation_a</span><span class="o">.</span><span class="n">conj</span><span class="p">()</span> <span class="o">@</span> <span class="n">rdm_a</span> <span class="o">@</span> <span class="n">orbital_rotation_a</span><span class="o">.</span><span class="n">T</span>
+            <span class="k">if</span> <span class="n">orbital_rotation_b</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+                <span class="n">rdm_b</span> <span class="o">=</span> <span class="n">orbital_rotation_b</span><span class="o">.</span><span class="n">conj</span><span class="p">()</span> <span class="o">@</span> <span class="n">rdm_b</span> <span class="o">@</span> <span class="n">orbital_rotation_b</span><span class="o">.</span><span class="n">T</span>
+        <span class="k">if</span> <span class="n">spin_summed</span><span class="p">:</span>
+            <span class="k">return</span> <span class="n">rdm_a</span> <span class="o">+</span> <span class="n">rdm_b</span>
+        <span class="k">return</span> <span class="n">scipy</span><span class="o">.</span><span class="n">linalg</span><span class="o">.</span><span class="n">block_diag</span><span class="p">(</span><span class="n">rdm_a</span><span class="p">,</span> <span class="n">rdm_b</span><span class="p">)</span>
+    <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">(</span>
+        <span class="sa">f</span><span class="s2">&quot;Returning the rank </span><span class="si">{</span><span class="n">rank</span><span class="si">}</span><span class="s2"> reduced density matrix is currently not supported.&quot;</span>
+    <span class="p">)</span></div>
 
-    <span class="n">rng</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">default_rng</span><span class="p">(</span><span class="n">seed</span><span class="p">)</span>
-    <span class="n">samples</span> <span class="o">=</span> <span class="p">[</span><span class="n">_autoregressive_slater</span><span class="p">(</span><span class="n">rdm</span><span class="p">,</span> <span class="n">norb</span><span class="p">,</span> <span class="n">nelec</span><span class="p">,</span> <span class="n">rng</span><span class="p">)</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">shots</span><span class="p">)]</span>
-    <span class="k">return</span> <span class="p">[</span><span class="nb">sum</span><span class="p">(</span><span class="mi">1</span> <span class="o">&lt;&lt;</span> <span class="n">orb</span> <span class="k">for</span> <span class="n">orb</span> <span class="ow">in</span> <span class="n">sample</span><span class="p">)</span> <span class="k">for</span> <span class="n">sample</span> <span class="ow">in</span> <span class="n">samples</span><span class="p">]</span>
 
 
-<span class="k">def</span> <span class="nf">_autoregressive_slater</span><span class="p">(</span>
-    <span class="n">rdm</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span>
+<span class="nd">@overload</span>
+<span class="k">def</span> <span class="nf">slater_determinant_rdms</span><span class="p">(</span>
+    <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
+    <span class="n">occupied_orbitals</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span>
+    <span class="n">orbital_rotation</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+    <span class="o">*</span><span class="p">,</span>
+    <span class="n">rank</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">1</span><span class="p">,</span>
+<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span> <span class="o">...</span>
+<span class="nd">@overload</span>
+<span class="k">def</span> <span class="nf">slater_determinant_rdms</span><span class="p">(</span>
+    <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
+    <span class="n">occupied_orbitals</span><span class="p">:</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]],</span>
+    <span class="n">orbital_rotation</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span>
+    <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">]</span>
+    <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+    <span class="o">*</span><span class="p">,</span>
+    <span class="n">rank</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">1</span><span class="p">,</span>
+<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span> <span class="o">...</span>
+<div class="viewcode-block" id="slater_determinant_rdms">
+<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.slater_determinant_rdms">[docs]</a>
+<span class="k">def</span> <span class="nf">slater_determinant_rdms</span><span class="p">(</span>
     <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-    <span class="n">nelec</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-    <span class="n">seed</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">Generator</span> <span class="o">|</span> <span class="nb">int</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-<span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">set</span><span class="p">[</span><span class="nb">int</span><span class="p">]:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Autoregressively sample occupied orbitals for a Slater determinant.</span>
+    <span class="n">occupied_orbitals</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]],</span>
+    <span class="n">orbital_rotation</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span>
+    <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">]</span>
+    <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+    <span class="o">*</span><span class="p">,</span>
+    <span class="n">rank</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">1</span><span class="p">,</span>
+<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Return the reduced density matrices of a `Slater determinant`_.</span>
+
+<span class="sd">    Note:</span>
+<span class="sd">        Currently, only rank 1 is supported.</span>
 
 <span class="sd">    Args:</span>
-<span class="sd">        rdm: The one-body reduced density matrix.</span>
-<span class="sd">        norb: The number of orbitals.</span>
-<span class="sd">        nelec: The number of electrons.</span>
-<span class="sd">        seed: A seed to initialize the pseudorandom number generator.</span>
-<span class="sd">            Should be a valid input to ``np.random.default_rng``.</span>
+<span class="sd">        norb: The number of spatial orbitals.</span>
+<span class="sd">        occupied_orbitals: The occupied orbitals in the electronic configuration.</span>
+<span class="sd">            This is either a list of integers specifying spinless orbitals, or a</span>
+<span class="sd">            pair of lists, where the first list specifies the spin alpha orbitals and</span>
+<span class="sd">            the second list specifies the spin beta orbitals.</span>
+<span class="sd">        orbital_rotation: The optional orbital rotation.</span>
+<span class="sd">            You can pass either a single Numpy array specifying the orbital rotation</span>
+<span class="sd">            to apply to both spin sectors, or you can pass a pair of Numpy arrays</span>
+<span class="sd">            specifying independent orbital rotations for spin alpha and spin beta.</span>
+<span class="sd">            If passing a pair, you can use ``None`` for one of the</span>
+<span class="sd">            values in the pair to indicate that no operation should be applied to</span>
+<span class="sd">            that spin sector.</span>
+<span class="sd">        rank: The rank of the reduced density matrix. I.e., rank 1 corresponds to the</span>
+<span class="sd">            one-particle RDM, rank 2 corresponds to the 2-particle RDM, etc.</span>
 
 <span class="sd">    Returns:</span>
-<span class="sd">        A set containing the occupied orbitals.</span>
+<span class="sd">        The reduced density matrices of the Slater determinant.</span>
+<span class="sd">        All RDMs up to and including the specified rank are returned, in increasing</span>
+<span class="sd">        order of rank. For example, if `rank=2` then a tuple `(rdm1, rdm2)` is returned.</span>
+<span class="sd">        The representation of an RDM depends on whether `occupied_orbitals` is a</span>
+<span class="sd">        sequence of integers (spinless case), or a pair of such sequences</span>
+<span class="sd">        (spinful case). In the spinless case, the full RDM is returned.</span>
+<span class="sd">        In the spinful case, each RDM is represented as a stacked Numpy</span>
+<span class="sd">        array of sub-RDMs. For example, the 1-RDMs are: (alpha-alpha, alpha-beta), and</span>
+<span class="sd">        the 2-RDMs are: (alpha-alpha, alpha-beta, beta-beta).</span>
+
+<span class="sd">    .. _Slater determinant: ffsim.html#ffsim.slater_determinant</span>
 <span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">rng</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">default_rng</span><span class="p">(</span><span class="n">seed</span><span class="p">)</span>
-    <span class="n">orb</span> <span class="o">=</span> <span class="n">rng</span><span class="o">.</span><span class="n">choice</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">p</span><span class="o">=</span><span class="n">np</span><span class="o">.</span><span class="n">diag</span><span class="p">(</span><span class="n">rdm</span><span class="p">)</span><span class="o">.</span><span class="n">real</span> <span class="o">/</span> <span class="n">nelec</span><span class="p">)</span>
-    <span class="n">sample</span> <span class="o">=</span> <span class="p">{</span><span class="n">orb</span><span class="p">}</span>
-    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">nelec</span> <span class="o">-</span> <span class="mi">1</span><span class="p">):</span>
-        <span class="n">index</span> <span class="o">=</span> <span class="n">rng</span><span class="o">.</span><span class="n">choice</span><span class="p">(</span><span class="n">norb</span> <span class="o">-</span> <span class="mi">1</span> <span class="o">-</span> <span class="n">i</span><span class="p">,</span> <span class="n">p</span><span class="o">=</span><span class="n">_generate_probs</span><span class="p">(</span><span class="n">rdm</span><span class="p">,</span> <span class="n">sample</span><span class="p">,</span> <span class="n">norb</span><span class="p">))</span>
-        <span class="n">empty_orbitals</span> <span class="o">=</span> <span class="p">(</span><span class="n">orb</span> <span class="k">for</span> <span class="n">orb</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">norb</span><span class="p">)</span> <span class="k">if</span> <span class="n">orb</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">sample</span><span class="p">)</span>
-        <span class="n">sample</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="nb">next</span><span class="p">(</span><span class="n">itertools</span><span class="o">.</span><span class="n">islice</span><span class="p">(</span><span class="n">empty_orbitals</span><span class="p">,</span> <span class="n">index</span><span class="p">,</span> <span class="kc">None</span><span class="p">)))</span>
-    <span class="k">return</span> <span class="n">sample</span>
-
-
-<span class="k">def</span> <span class="nf">_generate_probs</span><span class="p">(</span><span class="n">rdm</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">sample</span><span class="p">:</span> <span class="nb">set</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Computes the probabilities for the next occupied orbital.</span>
-
-<span class="sd">    This is a step of the autoregressive sampling, and uses Bayes&#39;s rule.</span>
+    <span class="k">if</span> <span class="ow">not</span> <span class="n">occupied_orbitals</span> <span class="ow">or</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">occupied_orbitals</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="p">(</span><span class="nb">int</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">integer</span><span class="p">)):</span>
+        <span class="c1"># Spinless case</span>
+        <span class="n">occupied_orbitals</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">cast</span><span class="p">(</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">occupied_orbitals</span><span class="p">))</span>
+        <span class="k">if</span> <span class="n">rank</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+            <span class="n">rdm</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">complex</span><span class="p">)</span>
+            <span class="k">if</span> <span class="n">occupied_orbitals</span><span class="p">:</span>
+                <span class="n">rdm</span><span class="p">[(</span><span class="n">occupied_orbitals</span><span class="p">,</span> <span class="n">occupied_orbitals</span><span class="p">)]</span> <span class="o">=</span> <span class="mi">1</span>
+            <span class="k">if</span> <span class="n">orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+                <span class="n">orbital_rotation</span> <span class="o">=</span> <span class="n">cast</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">orbital_rotation</span><span class="p">)</span>
+                <span class="n">rdm</span> <span class="o">=</span> <span class="n">orbital_rotation</span><span class="o">.</span><span class="n">conj</span><span class="p">()</span> <span class="o">@</span> <span class="n">rdm</span> <span class="o">@</span> <span class="n">orbital_rotation</span><span class="o">.</span><span class="n">T</span>
+            <span class="k">return</span> <span class="n">rdm</span>
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">(</span>
+            <span class="sa">f</span><span class="s2">&quot;Returning the rank </span><span class="si">{</span><span class="n">rank</span><span class="si">}</span><span class="s2"> reduced density matrix is currently not &quot;</span>
+            <span class="s2">&quot;supported.&quot;</span>
+        <span class="p">)</span>
+    <span class="k">else</span><span class="p">:</span>
+        <span class="c1"># Spinful case</span>
+        <span class="n">alpha_orbitals</span><span class="p">,</span> <span class="n">beta_orbitals</span> <span class="o">=</span> <span class="n">cast</span><span class="p">(</span>
+            <span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]],</span> <span class="n">occupied_orbitals</span>
+        <span class="p">)</span>
+        <span class="n">alpha_orbitals</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">alpha_orbitals</span><span class="p">)</span>
+        <span class="n">beta_orbitals</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">beta_orbitals</span><span class="p">)</span>
+        <span class="k">if</span> <span class="n">rank</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+            <span class="n">rdm_a</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">))</span>
+            <span class="n">rdm_b</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">))</span>
+            <span class="k">if</span> <span class="n">alpha_orbitals</span><span class="p">:</span>
+                <span class="n">rdm_a</span><span class="p">[(</span><span class="n">alpha_orbitals</span><span class="p">,</span> <span class="n">alpha_orbitals</span><span class="p">)]</span> <span class="o">=</span> <span class="mi">1</span>
+            <span class="k">if</span> <span class="n">beta_orbitals</span><span class="p">:</span>
+                <span class="n">rdm_b</span><span class="p">[(</span><span class="n">beta_orbitals</span><span class="p">,</span> <span class="n">beta_orbitals</span><span class="p">)]</span> <span class="o">=</span> <span class="mi">1</span>
+            <span class="k">if</span> <span class="n">orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+                <span class="k">if</span> <span class="p">(</span>
+                    <span class="nb">isinstance</span><span class="p">(</span><span class="n">orbital_rotation</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">)</span>
+                    <span class="ow">and</span> <span class="n">orbital_rotation</span><span class="o">.</span><span class="n">ndim</span> <span class="o">==</span> <span class="mi">2</span>
+                <span class="p">):</span>
+                    <span class="n">orbital_rotation_a</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="n">orbital_rotation</span>
+                    <span class="n">orbital_rotation_b</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="n">orbital_rotation</span>
+                <span class="k">else</span><span class="p">:</span>
+                    <span class="n">orbital_rotation_a</span><span class="p">,</span> <span class="n">orbital_rotation_b</span> <span class="o">=</span> <span class="n">orbital_rotation</span>
+                <span class="k">if</span> <span class="n">orbital_rotation_a</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+                    <span class="n">rdm_a</span> <span class="o">=</span> <span class="n">orbital_rotation_a</span><span class="o">.</span><span class="n">conj</span><span class="p">()</span> <span class="o">@</span> <span class="n">rdm_a</span> <span class="o">@</span> <span class="n">orbital_rotation_a</span><span class="o">.</span><span class="n">T</span>
+                <span class="k">if</span> <span class="n">orbital_rotation_b</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+                    <span class="n">rdm_b</span> <span class="o">=</span> <span class="n">orbital_rotation_b</span><span class="o">.</span><span class="n">conj</span><span class="p">()</span> <span class="o">@</span> <span class="n">rdm_b</span> <span class="o">@</span> <span class="n">orbital_rotation_b</span><span class="o">.</span><span class="n">T</span>
+            <span class="k">return</span> <span class="n">np</span><span class="o">.</span><span class="n">stack</span><span class="p">([</span><span class="n">rdm_a</span><span class="p">,</span> <span class="n">rdm_b</span><span class="p">])</span>
+        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">(</span>
+            <span class="sa">f</span><span class="s2">&quot;Returning the rank </span><span class="si">{</span><span class="n">rank</span><span class="si">}</span><span class="s2"> reduced density matrix is currently not &quot;</span>
+            <span class="s2">&quot;supported.&quot;</span>
+        <span class="p">)</span></div>
+
+
+
+<div class="viewcode-block" id="slater_determinant_amplitudes">
+<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.slater_determinant_amplitudes">[docs]</a>
+<span class="k">def</span> <span class="nf">slater_determinant_amplitudes</span><span class="p">(</span>
+    <span class="n">bitstrings</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]],</span>
+    <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
+    <span class="n">occupied_orbitals</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]],</span>
+    <span class="n">orbital_rotation</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">],</span>
+<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Compute state vector amplitudes for a Slater determinant.</span>
 
 <span class="sd">    Args:</span>
-<span class="sd">        rdm: A Numpy array with the one-body reduced density matrix.</span>
-<span class="sd">        sample: The list of already occupied orbitals.</span>
-<span class="sd">        norb: The number of orbitals.</span>
+<span class="sd">        bitstrings: The bitstrings to return the amplitudes for, in integer</span>
+<span class="sd">            representation. In the spinless case this is a list of integers. In the</span>
+<span class="sd">            spinful case, this is a pair of lists of equal length specifying the</span>
+<span class="sd">            alpha and beta parts of the bitstrings.</span>
+<span class="sd">        norb: The number of spatial orbitals.</span>
+<span class="sd">        occupied_orbitals: The occupied orbitals in the electronic configuration.</span>
+<span class="sd">            This is either a list of integers specifying spinless orbitals, or a</span>
+<span class="sd">            pair of lists, where the first list specifies the spin alpha orbitals and</span>
+<span class="sd">            the second list specifies the spin beta orbitals.</span>
+<span class="sd">        orbital_rotation: The orbital rotation describing the Slater determinant.</span>
+<span class="sd">            You can pass either a single Numpy array specifying the orbital rotation</span>
+<span class="sd">            to apply to both spin sectors, or you can pass a pair of Numpy arrays</span>
+<span class="sd">            specifying independent orbital rotations for spin alpha and spin beta.</span>
 
 <span class="sd">    Returns:</span>
-<span class="sd">        The probabilities for the next empty orbital to occupy.</span>
+<span class="sd">        The amplitudes of the requested bitstrings.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">probs</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">(</span><span class="n">norb</span> <span class="o">-</span> <span class="nb">len</span><span class="p">(</span><span class="n">sample</span><span class="p">))</span>
-    <span class="n">empty_orbitals</span> <span class="o">=</span> <span class="p">(</span><span class="n">orb</span> <span class="k">for</span> <span class="n">orb</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">norb</span><span class="p">)</span> <span class="k">if</span> <span class="n">orb</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">sample</span><span class="p">)</span>
-    <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">orb</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">empty_orbitals</span><span class="p">):</span>
-        <span class="n">indices</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">sample</span> <span class="o">|</span> <span class="p">{</span><span class="n">orb</span><span class="p">})</span>
-        <span class="n">probs</span><span class="p">[</span><span class="n">i</span><span class="p">]</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">linalg</span><span class="o">.</span><span class="n">det</span><span class="p">(</span><span class="n">rdm</span><span class="p">[</span><span class="n">indices</span><span class="p">][:,</span> <span class="n">indices</span><span class="p">])</span><span class="o">.</span><span class="n">real</span>
-    <span class="k">return</span> <span class="n">probs</span> <span class="o">/</span> <span class="n">np</span><span class="o">.</span><span class="n">sum</span><span class="p">(</span><span class="n">probs</span><span class="p">)</span>
+    <span class="k">if</span> <span class="ow">not</span> <span class="n">occupied_orbitals</span> <span class="ow">or</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">occupied_orbitals</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="p">(</span><span class="nb">int</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">integer</span><span class="p">)):</span>
+        <span class="c1"># Spinless case</span>
+        <span class="n">vecs</span> <span class="o">=</span> <span class="n">cast</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">orbital_rotation</span><span class="p">)[:,</span> <span class="n">occupied_orbitals</span><span class="p">]</span>
+        <span class="n">amplitudes</span> <span class="o">=</span> <span class="p">[]</span>
+        <span class="k">for</span> <span class="n">bitstring</span> <span class="ow">in</span> <span class="n">cast</span><span class="p">(</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">bitstrings</span><span class="p">):</span>
+            <span class="n">orbs</span> <span class="o">=</span> <span class="n">bitstring_to_occupied_orbitals</span><span class="p">(</span><span class="n">bitstring</span><span class="p">)</span>
+            <span class="n">amplitudes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">scipy</span><span class="o">.</span><span class="n">linalg</span><span class="o">.</span><span class="n">det</span><span class="p">(</span><span class="n">vecs</span><span class="p">[</span><span class="n">orbs</span><span class="p">]))</span>
+        <span class="k">return</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">amplitudes</span><span class="p">)</span>
+
+    <span class="c1"># Spinful case</span>
+    <span class="n">occupied_orbitals_a</span><span class="p">,</span> <span class="n">occupied_orbitals_b</span> <span class="o">=</span> <span class="n">cast</span><span class="p">(</span>
+        <span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]],</span> <span class="n">occupied_orbitals</span>
+    <span class="p">)</span>
+    <span class="n">bitstrings_a</span><span class="p">,</span> <span class="n">bitstrings_b</span> <span class="o">=</span> <span class="n">cast</span><span class="p">(</span><span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]],</span> <span class="n">bitstrings</span><span class="p">)</span>
+    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">orbital_rotation</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">)</span> <span class="ow">and</span> <span class="n">orbital_rotation</span><span class="o">.</span><span class="n">ndim</span> <span class="o">==</span> <span class="mi">2</span><span class="p">:</span>
+        <span class="n">orbital_rotation_a</span> <span class="o">=</span> <span class="n">orbital_rotation</span>
+        <span class="n">orbital_rotation_b</span> <span class="o">=</span> <span class="n">orbital_rotation</span>
+    <span class="k">else</span><span class="p">:</span>
+        <span class="n">orbital_rotation_a</span><span class="p">,</span> <span class="n">orbital_rotation_b</span> <span class="o">=</span> <span class="n">orbital_rotation</span>
+    <span class="n">amplitudes_a</span> <span class="o">=</span> <span class="n">slater_determinant_amplitudes</span><span class="p">(</span>
+        <span class="n">bitstrings_a</span><span class="p">,</span> <span class="n">norb</span><span class="p">,</span> <span class="n">occupied_orbitals_a</span><span class="p">,</span> <span class="n">orbital_rotation_a</span>
+    <span class="p">)</span>
+    <span class="n">amplitudes_b</span> <span class="o">=</span> <span class="n">slater_determinant_amplitudes</span><span class="p">(</span>
+        <span class="n">bitstrings_b</span><span class="p">,</span> <span class="n">norb</span><span class="p">,</span> <span class="n">occupied_orbitals_b</span><span class="p">,</span> <span class="n">orbital_rotation_b</span>
+    <span class="p">)</span>
+    <span class="k">return</span> <span class="n">amplitudes_a</span> <span class="o">*</span> <span class="n">amplitudes_b</span></div>
+
 </pre></div>
         </article>
       </div>
@@ -512,7 +673,7 @@ <h1>Source code for ffsim.states.slater</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/states/states.html b/_modules/ffsim/states/states.html
index 5910e3b6e..9a7d3e23c 100644
--- a/_modules/ffsim/states/states.html
+++ b/_modules/ffsim/states/states.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.states.states - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.states.states - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -281,16 +281,12 @@ <h1>Source code for ffsim.states.states</h1><div class="highlight"><pre>
 <span class="kn">import</span> <span class="nn">math</span>
 <span class="kn">from</span> <span class="nn">collections.abc</span> <span class="kn">import</span> <span class="n">Sequence</span>
 <span class="kn">from</span> <span class="nn">dataclasses</span> <span class="kn">import</span> <span class="n">dataclass</span>
-<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span><span class="p">,</span> <span class="n">cast</span><span class="p">,</span> <span class="n">overload</span>
+<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span><span class="p">,</span> <span class="n">cast</span>
 
 <span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
-<span class="kn">import</span> <span class="nn">scipy.linalg</span>
-<span class="kn">from</span> <span class="nn">pyscf.fci</span> <span class="kn">import</span> <span class="n">cistring</span>
 <span class="kn">from</span> <span class="nn">pyscf.fci.spin_op</span> <span class="kn">import</span> <span class="n">contract_ss</span>
 <span class="kn">from</span> <span class="nn">typing_extensions</span> <span class="kn">import</span> <span class="n">deprecated</span>
 
-<span class="kn">from</span> <span class="nn">ffsim</span> <span class="kn">import</span> <span class="n">linalg</span>
-<span class="kn">from</span> <span class="nn">ffsim.gates.orbital_rotation</span> <span class="kn">import</span> <span class="n">apply_orbital_rotation</span>
 <span class="kn">from</span> <span class="nn">ffsim.states.bitstring</span> <span class="kn">import</span> <span class="p">(</span>
     <span class="n">BitstringType</span><span class="p">,</span>
     <span class="n">addresses_to_strings</span><span class="p">,</span>
@@ -397,298 +393,6 @@ <h1>Source code for ffsim.states.states</h1><div class="highlight"><pre>
 
 
 
-<span class="nd">@overload</span>
-<span class="k">def</span> <span class="nf">slater_determinant</span><span class="p">(</span>
-    <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-    <span class="n">occupied_orbitals</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span>
-    <span class="n">orbital_rotation</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span> <span class="o">...</span>
-<span class="nd">@overload</span>
-<span class="k">def</span> <span class="nf">slater_determinant</span><span class="p">(</span>
-    <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-    <span class="n">occupied_orbitals</span><span class="p">:</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]],</span>
-    <span class="n">orbital_rotation</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span>
-    <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">]</span>
-    <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span> <span class="o">...</span>
-<div class="viewcode-block" id="slater_determinant">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.slater_determinant">[docs]</a>
-<span class="k">def</span> <span class="nf">slater_determinant</span><span class="p">(</span>
-    <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-    <span class="n">occupied_orbitals</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]],</span>
-    <span class="n">orbital_rotation</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span>
-    <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">]</span>
-    <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
-<span class="w">    </span><span class="sa">r</span><span class="sd">&quot;&quot;&quot;Return a Slater determinant.</span>
-
-<span class="sd">    A Slater determinant is a state of the form</span>
-
-<span class="sd">    .. math::</span>
-
-<span class="sd">        \mathcal{U} \lvert x \rangle,</span>
-
-<span class="sd">    where :math:`\mathcal{U}` is an</span>
-<span class="sd">    :doc:`orbital rotation &lt;/explanations/orbital-rotation&gt;` and</span>
-<span class="sd">    :math:`\lvert x \rangle` is an electronic configuration.</span>
-
-<span class="sd">    Args:</span>
-<span class="sd">        norb: The number of spatial orbitals.</span>
-<span class="sd">        occupied_orbitals: The occupied orbitals in the electronic configuration.</span>
-<span class="sd">            This is either a list of integers specifying spinless orbitals, or a</span>
-<span class="sd">            pair of lists, where the first list specifies the spin alpha orbitals and</span>
-<span class="sd">            the second list specifies the spin beta orbitals.</span>
-<span class="sd">        orbital_rotation: The optional orbital rotation.</span>
-<span class="sd">            You can pass either a single Numpy array specifying the orbital rotation</span>
-<span class="sd">            to apply to both spin sectors, or you can pass a pair of Numpy arrays</span>
-<span class="sd">            specifying independent orbital rotations for spin alpha and spin beta.</span>
-<span class="sd">            If passing a pair, you can use ``None`` for one of the</span>
-<span class="sd">            values in the pair to indicate that no operation should be applied to</span>
-<span class="sd">            that spin sector.</span>
-
-<span class="sd">    Returns:</span>
-<span class="sd">        The Slater determinant as a state vector.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="k">if</span> <span class="n">norb</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
-        <span class="k">return</span> <span class="n">np</span><span class="o">.</span><span class="n">ones</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">complex</span><span class="p">)</span>
-
-    <span class="k">if</span> <span class="ow">not</span> <span class="n">occupied_orbitals</span> <span class="ow">or</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">occupied_orbitals</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="p">(</span><span class="nb">int</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">integer</span><span class="p">)):</span>
-        <span class="n">occupied_orbitals</span> <span class="o">=</span> <span class="p">(</span><span class="n">cast</span><span class="p">(</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">occupied_orbitals</span><span class="p">),</span> <span class="p">[])</span>
-
-    <span class="n">alpha_orbitals</span><span class="p">,</span> <span class="n">beta_orbitals</span> <span class="o">=</span> <span class="n">cast</span><span class="p">(</span>
-        <span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]],</span> <span class="n">occupied_orbitals</span>
-    <span class="p">)</span>
-    <span class="n">n_alpha</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">alpha_orbitals</span><span class="p">)</span>
-    <span class="n">n_beta</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">beta_orbitals</span><span class="p">)</span>
-    <span class="n">nelec</span> <span class="o">=</span> <span class="p">(</span><span class="n">n_alpha</span><span class="p">,</span> <span class="n">n_beta</span><span class="p">)</span>
-    <span class="n">dim1</span><span class="p">,</span> <span class="n">dim2</span> <span class="o">=</span> <span class="n">dims</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">nelec</span><span class="p">)</span>
-    <span class="n">alpha_bits</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">bool</span><span class="p">)</span>
-    <span class="n">alpha_bits</span><span class="p">[</span><span class="nb">list</span><span class="p">(</span><span class="n">alpha_orbitals</span><span class="p">)]</span> <span class="o">=</span> <span class="mi">1</span>
-    <span class="n">alpha_string</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="s2">&quot;&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="s2">&quot;1&quot;</span> <span class="k">if</span> <span class="n">b</span> <span class="k">else</span> <span class="s2">&quot;0&quot;</span> <span class="k">for</span> <span class="n">b</span> <span class="ow">in</span> <span class="n">alpha_bits</span><span class="p">[::</span><span class="o">-</span><span class="mi">1</span><span class="p">]),</span> <span class="n">base</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>
-    <span class="n">alpha_index</span> <span class="o">=</span> <span class="n">cistring</span><span class="o">.</span><span class="n">str2addr</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">n_alpha</span><span class="p">,</span> <span class="n">alpha_string</span><span class="p">)</span>
-    <span class="n">beta_bits</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">bool</span><span class="p">)</span>
-    <span class="n">beta_bits</span><span class="p">[</span><span class="nb">list</span><span class="p">(</span><span class="n">beta_orbitals</span><span class="p">)]</span> <span class="o">=</span> <span class="mi">1</span>
-    <span class="n">beta_string</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="s2">&quot;&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="s2">&quot;1&quot;</span> <span class="k">if</span> <span class="n">b</span> <span class="k">else</span> <span class="s2">&quot;0&quot;</span> <span class="k">for</span> <span class="n">b</span> <span class="ow">in</span> <span class="n">beta_bits</span><span class="p">[::</span><span class="o">-</span><span class="mi">1</span><span class="p">]),</span> <span class="n">base</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>
-    <span class="n">beta_index</span> <span class="o">=</span> <span class="n">cistring</span><span class="o">.</span><span class="n">str2addr</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">n_beta</span><span class="p">,</span> <span class="n">beta_string</span><span class="p">)</span>
-    <span class="n">vec</span> <span class="o">=</span> <span class="n">linalg</span><span class="o">.</span><span class="n">one_hot</span><span class="p">(</span>
-        <span class="p">(</span><span class="n">dim1</span><span class="p">,</span> <span class="n">dim2</span><span class="p">),</span> <span class="p">(</span><span class="n">alpha_index</span><span class="p">,</span> <span class="n">beta_index</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">complex</span>
-    <span class="p">)</span><span class="o">.</span><span class="n">reshape</span><span class="p">(</span><span class="o">-</span><span class="mi">1</span><span class="p">)</span>
-    <span class="k">if</span> <span class="n">orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">vec</span> <span class="o">=</span> <span class="n">apply_orbital_rotation</span><span class="p">(</span>
-            <span class="n">vec</span><span class="p">,</span> <span class="n">orbital_rotation</span><span class="p">,</span> <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span> <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">,</span> <span class="n">copy</span><span class="o">=</span><span class="kc">False</span>
-        <span class="p">)</span>
-    <span class="k">return</span> <span class="n">vec</span></div>
-
-
-
-<div class="viewcode-block" id="hartree_fock_state">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.hartree_fock_state">[docs]</a>
-<span class="k">def</span> <span class="nf">hartree_fock_state</span><span class="p">(</span><span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">nelec</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Return the Hartree-Fock state.</span>
-
-<span class="sd">    Args:</span>
-<span class="sd">        norb: The number of spatial orbitals.</span>
-<span class="sd">        nelec: Either a single integer representing the number of fermions for a</span>
-<span class="sd">            spinless system, or a pair of integers storing the numbers of spin alpha</span>
-<span class="sd">            and spin beta fermions.</span>
-
-<span class="sd">    Returns:</span>
-<span class="sd">        The Hartree-Fock state as a state vector.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">nelec</span><span class="p">,</span> <span class="nb">int</span><span class="p">):</span>
-        <span class="k">return</span> <span class="n">slater_determinant</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">occupied_orbitals</span><span class="o">=</span><span class="nb">range</span><span class="p">(</span><span class="n">nelec</span><span class="p">))</span>
-
-    <span class="n">n_alpha</span><span class="p">,</span> <span class="n">n_beta</span> <span class="o">=</span> <span class="n">nelec</span>
-    <span class="k">return</span> <span class="n">slater_determinant</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">occupied_orbitals</span><span class="o">=</span><span class="p">(</span><span class="nb">range</span><span class="p">(</span><span class="n">n_alpha</span><span class="p">),</span> <span class="nb">range</span><span class="p">(</span><span class="n">n_beta</span><span class="p">)))</span></div>
-
-
-
-<div class="viewcode-block" id="slater_determinant_rdm">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.slater_determinant_rdm">[docs]</a>
-<span class="nd">@deprecated</span><span class="p">(</span>
-    <span class="s2">&quot;ffsim.slater_determinant_rdm is deprecated. &quot;</span>
-    <span class="s2">&quot;Instead, use ffsim.slater_determinant_rdms.&quot;</span>
-<span class="p">)</span>
-<span class="k">def</span> <span class="nf">slater_determinant_rdm</span><span class="p">(</span>
-    <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-    <span class="n">occupied_orbitals</span><span class="p">:</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]],</span>
-    <span class="n">orbital_rotation</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span>
-    <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">]</span>
-    <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-    <span class="n">rank</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">1</span><span class="p">,</span>
-    <span class="n">spin_summed</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
-<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Return the reduced density matrix of a `Slater determinant`_.</span>
-
-<span class="sd">    .. warning::</span>
-<span class="sd">        This function is deprecated. Use :func:`ffsim.slater_determinant_rdms` instead.</span>
-
-<span class="sd">    Note:</span>
-<span class="sd">        Currently, only rank 1 is supported.</span>
-
-<span class="sd">    Args:</span>
-<span class="sd">        norb: The number of spatial orbitals.</span>
-<span class="sd">        occupied_orbitals: The occupied orbitals in the electronic configuration.</span>
-<span class="sd">            This is a pair of lists of integers, where the first list specifies the</span>
-<span class="sd">            spin alpha orbitals and the second list specifies the spin beta</span>
-<span class="sd">            orbitals.</span>
-<span class="sd">        orbital_rotation: The optional orbital rotation.</span>
-<span class="sd">            You can pass either a single Numpy array specifying the orbital rotation</span>
-<span class="sd">            to apply to both spin sectors, or you can pass a pair of Numpy arrays</span>
-<span class="sd">            specifying independent orbital rotations for spin alpha and spin beta.</span>
-<span class="sd">            If passing a pair, you can use ``None`` for one of the</span>
-<span class="sd">            values in the pair to indicate that no operation should be applied to that</span>
-<span class="sd">            spin sector.</span>
-<span class="sd">        rank: The rank of the reduced density matrix. I.e., rank 1 corresponds to the</span>
-<span class="sd">            one-particle RDM, rank 2 corresponds to the 2-particle RDM, etc.</span>
-<span class="sd">        spin_summed: Whether to sum over the spin index.</span>
-
-<span class="sd">    Returns:</span>
-<span class="sd">        The reduced density matrix of the Slater determinant.</span>
-
-<span class="sd">    .. _Slater determinant: ffsim.html#ffsim.slater_determinant</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="k">if</span> <span class="n">rank</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
-        <span class="n">rdm_a</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">complex</span><span class="p">)</span>
-        <span class="n">rdm_b</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">complex</span><span class="p">)</span>
-        <span class="n">alpha_orbitals</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">occupied_orbitals</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
-        <span class="n">beta_orbitals</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">occupied_orbitals</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
-        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">alpha_orbitals</span><span class="p">):</span>
-            <span class="n">rdm_a</span><span class="p">[(</span><span class="n">alpha_orbitals</span><span class="p">,</span> <span class="n">alpha_orbitals</span><span class="p">)]</span> <span class="o">=</span> <span class="mi">1</span>
-        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">beta_orbitals</span><span class="p">):</span>
-            <span class="n">rdm_b</span><span class="p">[(</span><span class="n">beta_orbitals</span><span class="p">,</span> <span class="n">beta_orbitals</span><span class="p">)]</span> <span class="o">=</span> <span class="mi">1</span>
-        <span class="k">if</span> <span class="n">orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">orbital_rotation</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">):</span>
-                <span class="n">orbital_rotation_a</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="n">orbital_rotation</span>
-                <span class="n">orbital_rotation_b</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="n">orbital_rotation</span>
-            <span class="k">else</span><span class="p">:</span>
-                <span class="n">orbital_rotation_a</span><span class="p">,</span> <span class="n">orbital_rotation_b</span> <span class="o">=</span> <span class="n">orbital_rotation</span>
-            <span class="k">if</span> <span class="n">orbital_rotation_a</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="n">rdm_a</span> <span class="o">=</span> <span class="n">orbital_rotation_a</span><span class="o">.</span><span class="n">conj</span><span class="p">()</span> <span class="o">@</span> <span class="n">rdm_a</span> <span class="o">@</span> <span class="n">orbital_rotation_a</span><span class="o">.</span><span class="n">T</span>
-            <span class="k">if</span> <span class="n">orbital_rotation_b</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="n">rdm_b</span> <span class="o">=</span> <span class="n">orbital_rotation_b</span><span class="o">.</span><span class="n">conj</span><span class="p">()</span> <span class="o">@</span> <span class="n">rdm_b</span> <span class="o">@</span> <span class="n">orbital_rotation_b</span><span class="o">.</span><span class="n">T</span>
-        <span class="k">if</span> <span class="n">spin_summed</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">rdm_a</span> <span class="o">+</span> <span class="n">rdm_b</span>
-        <span class="k">return</span> <span class="n">scipy</span><span class="o">.</span><span class="n">linalg</span><span class="o">.</span><span class="n">block_diag</span><span class="p">(</span><span class="n">rdm_a</span><span class="p">,</span> <span class="n">rdm_b</span><span class="p">)</span>
-    <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">(</span>
-        <span class="sa">f</span><span class="s2">&quot;Returning the rank </span><span class="si">{</span><span class="n">rank</span><span class="si">}</span><span class="s2"> reduced density matrix is currently not supported.&quot;</span>
-    <span class="p">)</span></div>
-
-
-
-<span class="nd">@overload</span>
-<span class="k">def</span> <span class="nf">slater_determinant_rdms</span><span class="p">(</span>
-    <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-    <span class="n">occupied_orbitals</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span>
-    <span class="n">orbital_rotation</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-    <span class="o">*</span><span class="p">,</span>
-    <span class="n">rank</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">1</span><span class="p">,</span>
-<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span> <span class="o">...</span>
-<span class="nd">@overload</span>
-<span class="k">def</span> <span class="nf">slater_determinant_rdms</span><span class="p">(</span>
-    <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-    <span class="n">occupied_orbitals</span><span class="p">:</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]],</span>
-    <span class="n">orbital_rotation</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span>
-    <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">]</span>
-    <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-    <span class="o">*</span><span class="p">,</span>
-    <span class="n">rank</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">1</span><span class="p">,</span>
-<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span> <span class="o">...</span>
-<div class="viewcode-block" id="slater_determinant_rdms">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.slater_determinant_rdms">[docs]</a>
-<span class="k">def</span> <span class="nf">slater_determinant_rdms</span><span class="p">(</span>
-    <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-    <span class="n">occupied_orbitals</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]],</span>
-    <span class="n">orbital_rotation</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span>
-    <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">]</span>
-    <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-    <span class="o">*</span><span class="p">,</span>
-    <span class="n">rank</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">1</span><span class="p">,</span>
-<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;Return the reduced density matrices of a `Slater determinant`_.</span>
-
-<span class="sd">    Note:</span>
-<span class="sd">        Currently, only rank 1 is supported.</span>
-
-<span class="sd">    Args:</span>
-<span class="sd">        norb: The number of spatial orbitals.</span>
-<span class="sd">        occupied_orbitals: The occupied orbitals in the electronic configuration.</span>
-<span class="sd">            This is either a list of integers specifying spinless orbitals, or a</span>
-<span class="sd">            pair of lists, where the first list specifies the spin alpha orbitals and</span>
-<span class="sd">            the second list specifies the spin beta orbitals.</span>
-<span class="sd">        orbital_rotation: The optional orbital rotation.</span>
-<span class="sd">            You can pass either a single Numpy array specifying the orbital rotation</span>
-<span class="sd">            to apply to both spin sectors, or you can pass a pair of Numpy arrays</span>
-<span class="sd">            specifying independent orbital rotations for spin alpha and spin beta.</span>
-<span class="sd">            If passing a pair, you can use ``None`` for one of the</span>
-<span class="sd">            values in the pair to indicate that no operation should be applied to</span>
-<span class="sd">            that spin sector.</span>
-<span class="sd">        rank: The rank of the reduced density matrix. I.e., rank 1 corresponds to the</span>
-<span class="sd">            one-particle RDM, rank 2 corresponds to the 2-particle RDM, etc.</span>
-
-<span class="sd">    Returns:</span>
-<span class="sd">        The reduced density matrices of the Slater determinant.</span>
-<span class="sd">        All RDMs up to and including the specified rank are returned, in increasing</span>
-<span class="sd">        order of rank. For example, if `rank=2` then a tuple `(rdm1, rdm2)` is returned.</span>
-<span class="sd">        The representation of an RDM depends on whether `occupied_orbitals` is a</span>
-<span class="sd">        sequence of integers (spinless case), or a pair of such sequences</span>
-<span class="sd">        (spinful case). In the spinless case, the full RDM is returned.</span>
-<span class="sd">        In the spinful case, each RDM is represented as a stacked Numpy</span>
-<span class="sd">        array of sub-RDMs. For example, the 1-RDMs are: (alpha-alpha, alpha-beta), and</span>
-<span class="sd">        the 2-RDMs are: (alpha-alpha, alpha-beta, beta-beta).</span>
-
-<span class="sd">    .. _Slater determinant: ffsim.html#ffsim.slater_determinant</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="k">if</span> <span class="ow">not</span> <span class="n">occupied_orbitals</span> <span class="ow">or</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">occupied_orbitals</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="p">(</span><span class="nb">int</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">integer</span><span class="p">)):</span>
-        <span class="c1"># Spinless case</span>
-        <span class="n">occupied_orbitals</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">cast</span><span class="p">(</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">occupied_orbitals</span><span class="p">))</span>
-        <span class="k">if</span> <span class="n">rank</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
-            <span class="n">rdm</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">complex</span><span class="p">)</span>
-            <span class="k">if</span> <span class="n">occupied_orbitals</span><span class="p">:</span>
-                <span class="n">rdm</span><span class="p">[(</span><span class="n">occupied_orbitals</span><span class="p">,</span> <span class="n">occupied_orbitals</span><span class="p">)]</span> <span class="o">=</span> <span class="mi">1</span>
-            <span class="k">if</span> <span class="n">orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="n">orbital_rotation</span> <span class="o">=</span> <span class="n">cast</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">orbital_rotation</span><span class="p">)</span>
-                <span class="n">rdm</span> <span class="o">=</span> <span class="n">orbital_rotation</span><span class="o">.</span><span class="n">conj</span><span class="p">()</span> <span class="o">@</span> <span class="n">rdm</span> <span class="o">@</span> <span class="n">orbital_rotation</span><span class="o">.</span><span class="n">T</span>
-            <span class="k">return</span> <span class="n">rdm</span>
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">(</span>
-            <span class="sa">f</span><span class="s2">&quot;Returning the rank </span><span class="si">{</span><span class="n">rank</span><span class="si">}</span><span class="s2"> reduced density matrix is currently not &quot;</span>
-            <span class="s2">&quot;supported.&quot;</span>
-        <span class="p">)</span>
-    <span class="k">else</span><span class="p">:</span>
-        <span class="c1"># Spinful case</span>
-        <span class="n">alpha_orbitals</span><span class="p">,</span> <span class="n">beta_orbitals</span> <span class="o">=</span> <span class="n">cast</span><span class="p">(</span>
-            <span class="nb">tuple</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">Sequence</span><span class="p">[</span><span class="nb">int</span><span class="p">]],</span> <span class="n">occupied_orbitals</span>
-        <span class="p">)</span>
-        <span class="n">alpha_orbitals</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">alpha_orbitals</span><span class="p">)</span>
-        <span class="n">beta_orbitals</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">beta_orbitals</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">rank</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
-            <span class="n">rdm_a</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">))</span>
-            <span class="n">rdm_b</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">))</span>
-            <span class="k">if</span> <span class="n">alpha_orbitals</span><span class="p">:</span>
-                <span class="n">rdm_a</span><span class="p">[(</span><span class="n">alpha_orbitals</span><span class="p">,</span> <span class="n">alpha_orbitals</span><span class="p">)]</span> <span class="o">=</span> <span class="mi">1</span>
-            <span class="k">if</span> <span class="n">beta_orbitals</span><span class="p">:</span>
-                <span class="n">rdm_b</span><span class="p">[(</span><span class="n">beta_orbitals</span><span class="p">,</span> <span class="n">beta_orbitals</span><span class="p">)]</span> <span class="o">=</span> <span class="mi">1</span>
-            <span class="k">if</span> <span class="n">orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="k">if</span> <span class="p">(</span>
-                    <span class="nb">isinstance</span><span class="p">(</span><span class="n">orbital_rotation</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">)</span>
-                    <span class="ow">and</span> <span class="n">orbital_rotation</span><span class="o">.</span><span class="n">ndim</span> <span class="o">==</span> <span class="mi">2</span>
-                <span class="p">):</span>
-                    <span class="n">orbital_rotation_a</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="n">orbital_rotation</span>
-                    <span class="n">orbital_rotation_b</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="n">orbital_rotation</span>
-                <span class="k">else</span><span class="p">:</span>
-                    <span class="n">orbital_rotation_a</span><span class="p">,</span> <span class="n">orbital_rotation_b</span> <span class="o">=</span> <span class="n">orbital_rotation</span>
-                <span class="k">if</span> <span class="n">orbital_rotation_a</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                    <span class="n">rdm_a</span> <span class="o">=</span> <span class="n">orbital_rotation_a</span><span class="o">.</span><span class="n">conj</span><span class="p">()</span> <span class="o">@</span> <span class="n">rdm_a</span> <span class="o">@</span> <span class="n">orbital_rotation_a</span><span class="o">.</span><span class="n">T</span>
-                <span class="k">if</span> <span class="n">orbital_rotation_b</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                    <span class="n">rdm_b</span> <span class="o">=</span> <span class="n">orbital_rotation_b</span><span class="o">.</span><span class="n">conj</span><span class="p">()</span> <span class="o">@</span> <span class="n">rdm_b</span> <span class="o">@</span> <span class="n">orbital_rotation_b</span><span class="o">.</span><span class="n">T</span>
-            <span class="k">return</span> <span class="n">np</span><span class="o">.</span><span class="n">stack</span><span class="p">([</span><span class="n">rdm_a</span><span class="p">,</span> <span class="n">rdm_b</span><span class="p">])</span>
-        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">(</span>
-            <span class="sa">f</span><span class="s2">&quot;Returning the rank </span><span class="si">{</span><span class="n">rank</span><span class="si">}</span><span class="s2"> reduced density matrix is currently not &quot;</span>
-            <span class="s2">&quot;supported.&quot;</span>
-        <span class="p">)</span></div>
-
-
-
 <span class="c1"># source: pyscf.fci.spin_op.spin_square0</span>
 <span class="c1"># modified to support complex wavefunction</span>
 <div class="viewcode-block" id="spin_square">
@@ -898,7 +602,7 @@ <h1>Source code for ffsim.states.states</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/states/wick.html b/_modules/ffsim/states/wick.html
index 1ed12f590..d2ca88a76 100644
--- a/_modules/ffsim/states/wick.html
+++ b/_modules/ffsim/states/wick.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.states.wick - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.states.wick - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -434,7 +434,7 @@ <h1>Source code for ffsim.states.wick</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/testing/testing.html b/_modules/ffsim/testing/testing.html
index 334294993..08a8357e8 100644
--- a/_modules/ffsim/testing/testing.html
+++ b/_modules/ffsim/testing/testing.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.testing.testing - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.testing.testing - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -472,7 +472,7 @@ <h1>Source code for ffsim.testing.testing</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/trotter/diagonal_coulomb.html b/_modules/ffsim/trotter/diagonal_coulomb.html
index c10f6ad94..dacff051f 100644
--- a/_modules/ffsim/trotter/diagonal_coulomb.html
+++ b/_modules/ffsim/trotter/diagonal_coulomb.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.trotter.diagonal_coulomb - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.trotter.diagonal_coulomb - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -442,7 +442,7 @@ <h1>Source code for ffsim.trotter.diagonal_coulomb</h1><div class="highlight"><p
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/trotter/double_factorized.html b/_modules/ffsim/trotter/double_factorized.html
index 8ca63c352..60febfa16 100644
--- a/_modules/ffsim/trotter/double_factorized.html
+++ b/_modules/ffsim/trotter/double_factorized.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.trotter.double_factorized - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.trotter.double_factorized - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -448,7 +448,7 @@ <h1>Source code for ffsim.trotter.double_factorized</h1><div class="highlight"><
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/trotter/qdrift.html b/_modules/ffsim/trotter/qdrift.html
index 86bf68708..c4f61fc26 100644
--- a/_modules/ffsim/trotter/qdrift.html
+++ b/_modules/ffsim/trotter/qdrift.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.trotter.qdrift - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.trotter.qdrift - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -914,7 +914,7 @@ <h1>Source code for ffsim.trotter.qdrift</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/variational/givens.html b/_modules/ffsim/variational/givens.html
index 0e69fd6d7..7e699e52a 100644
--- a/_modules/ffsim/variational/givens.html
+++ b/_modules/ffsim/variational/givens.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.variational.givens - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.variational.givens - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -285,91 +285,12 @@ <h1>Source code for ffsim.variational.givens</h1><div class="highlight"><pre>
 <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">cast</span>
 
 <span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
-<span class="kn">from</span> <span class="nn">scipy.linalg.blas</span> <span class="kn">import</span> <span class="n">drot</span>
 <span class="kn">from</span> <span class="nn">scipy.linalg.lapack</span> <span class="kn">import</span> <span class="n">zrot</span>
-<span class="kn">from</span> <span class="nn">typing_extensions</span> <span class="kn">import</span> <span class="n">deprecated</span>
 
 <span class="kn">from</span> <span class="nn">ffsim</span> <span class="kn">import</span> <span class="n">linalg</span>
 <span class="kn">from</span> <span class="nn">ffsim.gates</span> <span class="kn">import</span> <span class="n">apply_orbital_rotation</span>
 
 
-<div class="viewcode-block" id="GivensAnsatzOperator">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.GivensAnsatzOperator">[docs]</a>
-<span class="nd">@dataclass</span><span class="p">(</span><span class="n">frozen</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-<span class="nd">@deprecated</span><span class="p">(</span><span class="s2">&quot;GivensAnsatzOperator is deprecated. Use GivensAnsatzOp instead.&quot;</span><span class="p">)</span>
-<span class="k">class</span> <span class="nc">GivensAnsatzOperator</span><span class="p">:</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;A Givens rotation ansatz operator.</span>
-
-<span class="sd">    .. warning::</span>
-<span class="sd">        This class is deprecated. Use :class:`ffsim.GivensAnsatzOp` instead.</span>
-
-<span class="sd">    The Givens rotation ansatz consists of a sequence of `Givens rotations`_.</span>
-
-<span class="sd">    Note that this ansatz does not implement any interactions between spin alpha and</span>
-<span class="sd">    spin beta orbitals.</span>
-
-<span class="sd">    Attributes:</span>
-<span class="sd">        norb (int): The number of spatial orbitals.</span>
-<span class="sd">        interaction_pairs (list[tuple[int, int]]): The orbital pairs to apply the Givens</span>
-<span class="sd">            rotations to.</span>
-<span class="sd">        thetas (np.ndarray): The angles for the Givens rotations.</span>
-
-<span class="sd">    .. _Givens rotations: ffsim.html#ffsim.apply_givens_rotation</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span>
-    <span class="n">interaction_pairs</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span>
-    <span class="n">thetas</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span>
-
-    <span class="k">def</span> <span class="nf">_apply_unitary_</span><span class="p">(</span>
-        <span class="bp">self</span><span class="p">,</span> <span class="n">vec</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">nelec</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">],</span> <span class="n">copy</span><span class="p">:</span> <span class="nb">bool</span>
-    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Apply the operator to a vector.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="n">apply_orbital_rotation</span><span class="p">(</span>
-            <span class="n">vec</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">to_orbital_rotation</span><span class="p">(),</span> <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span> <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">,</span> <span class="n">copy</span><span class="o">=</span><span class="n">copy</span>
-        <span class="p">)</span>
-
-<div class="viewcode-block" id="GivensAnsatzOperator.to_parameters">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.GivensAnsatzOperator.to_parameters">[docs]</a>
-    <span class="k">def</span> <span class="nf">to_parameters</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Convert the operator to a real-valued parameter vector.&quot;&quot;&quot;</span>
-        <span class="n">num_params</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">thetas</span><span class="p">)</span>
-        <span class="n">params</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">(</span><span class="n">num_params</span><span class="p">)</span>
-        <span class="n">params</span><span class="p">[:</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">thetas</span><span class="p">)]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">thetas</span>
-        <span class="k">return</span> <span class="n">params</span></div>
-
-
-<div class="viewcode-block" id="GivensAnsatzOperator.from_parameters">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.GivensAnsatzOperator.from_parameters">[docs]</a>
-    <span class="nd">@staticmethod</span>
-    <span class="k">def</span> <span class="nf">from_parameters</span><span class="p">(</span>
-        <span class="n">params</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">interaction_pairs</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span>
-    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">GivensAnsatzOperator</span><span class="p">:</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Initialize the operator from a real-valued parameter vector.</span>
-
-<span class="sd">        Args:</span>
-<span class="sd">            params: The real-valued parameter vector.</span>
-<span class="sd">            norb: The number of spatial orbitals.</span>
-<span class="sd">            interaction_pairs: The orbital pairs to apply the Givens rotation gates to.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="n">GivensAnsatzOperator</span><span class="p">(</span>
-            <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span> <span class="n">interaction_pairs</span><span class="o">=</span><span class="n">interaction_pairs</span><span class="p">,</span> <span class="n">thetas</span><span class="o">=</span><span class="n">params</span>
-        <span class="p">)</span></div>
-
-
-    <span class="k">def</span> <span class="nf">to_orbital_rotation</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
-        <span class="n">orbital_rotation</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">eye</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">norb</span><span class="p">)</span>
-        <span class="k">for</span> <span class="p">(</span><span class="n">i</span><span class="p">,</span> <span class="n">j</span><span class="p">),</span> <span class="n">theta</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">interaction_pairs</span><span class="p">[::</span><span class="o">-</span><span class="mi">1</span><span class="p">],</span> <span class="bp">self</span><span class="o">.</span><span class="n">thetas</span><span class="p">[::</span><span class="o">-</span><span class="mi">1</span><span class="p">]):</span>
-            <span class="n">orbital_rotation</span><span class="p">[:,</span> <span class="n">j</span><span class="p">],</span> <span class="n">orbital_rotation</span><span class="p">[:,</span> <span class="n">i</span><span class="p">]</span> <span class="o">=</span> <span class="n">drot</span><span class="p">(</span>
-                <span class="n">orbital_rotation</span><span class="p">[:,</span> <span class="n">j</span><span class="p">],</span>
-                <span class="n">orbital_rotation</span><span class="p">[:,</span> <span class="n">i</span><span class="p">],</span>
-                <span class="n">math</span><span class="o">.</span><span class="n">cos</span><span class="p">(</span><span class="n">theta</span><span class="p">),</span>
-                <span class="n">math</span><span class="o">.</span><span class="n">sin</span><span class="p">(</span><span class="n">theta</span><span class="p">),</span>
-            <span class="p">)</span>
-        <span class="k">return</span> <span class="n">orbital_rotation</span></div>
-
-
-
 <div class="viewcode-block" id="GivensAnsatzOp">
 <a class="viewcode-back" href="../../../api/ffsim.html#ffsim.GivensAnsatzOp">[docs]</a>
 <span class="nd">@dataclass</span><span class="p">(</span><span class="n">frozen</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
@@ -404,7 +325,7 @@ <h1>Source code for ffsim.variational.givens</h1><div class="highlight"><pre>
         <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">thetas</span><span class="p">)</span> <span class="o">!=</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">interaction_pairs</span><span class="p">):</span>
             <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
                 <span class="s2">&quot;The number of thetas must equal the number of interaction pairs. &quot;</span>
-                <span class="sa">f</span><span class="s2">&quot;Got </span><span class="si">{</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">phis</span><span class="p">)</span><span class="si">}</span><span class="s2"> and </span><span class="si">{</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">interaction_pairs</span><span class="p">)</span><span class="si">}</span><span class="s2">.&quot;</span>
+                <span class="sa">f</span><span class="s2">&quot;Got </span><span class="si">{</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">thetas</span><span class="p">)</span><span class="si">}</span><span class="s2"> and </span><span class="si">{</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">interaction_pairs</span><span class="p">)</span><span class="si">}</span><span class="s2">.&quot;</span>
             <span class="p">)</span>
         <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">phis</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">phis</span><span class="p">)</span> <span class="o">!=</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">interaction_pairs</span><span class="p">):</span>
             <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
@@ -678,7 +599,7 @@ <h1>Source code for ffsim.variational.givens</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/variational/hopgate.html b/_modules/ffsim/variational/hopgate.html
index a2f665d40..d95355e2b 100644
--- a/_modules/ffsim/variational/hopgate.html
+++ b/_modules/ffsim/variational/hopgate.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.variational.hopgate - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.variational.hopgate - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -280,6 +280,7 @@ <h1>Source code for ffsim.variational.hopgate</h1><div class="highlight"><pre>
 
 <span class="kn">import</span> <span class="nn">itertools</span>
 <span class="kn">from</span> <span class="nn">dataclasses</span> <span class="kn">import</span> <span class="n">dataclass</span>
+<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">cast</span>
 
 <span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
 
@@ -386,7 +387,29 @@ <h1>Source code for ffsim.variational.hopgate</h1><div class="highlight"><pre>
             <span class="n">thetas</span><span class="o">=</span><span class="n">params</span><span class="p">,</span>
             <span class="n">final_orbital_rotation</span><span class="o">=</span><span class="n">final_orbital_rotation</span><span class="p">,</span>
         <span class="p">)</span></div>
-</div>
+
+
+    <span class="k">def</span> <span class="nf">_approx_eq_</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">other</span><span class="p">,</span> <span class="n">rtol</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">atol</span><span class="p">:</span> <span class="nb">float</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
+        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">other</span><span class="p">,</span> <span class="n">HopGateAnsatzOperator</span><span class="p">):</span>
+            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">norb</span> <span class="o">!=</span> <span class="n">other</span><span class="o">.</span><span class="n">norb</span><span class="p">:</span>
+                <span class="k">return</span> <span class="kc">False</span>
+            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">interaction_pairs</span> <span class="o">!=</span> <span class="n">other</span><span class="o">.</span><span class="n">interaction_pairs</span><span class="p">:</span>
+                <span class="k">return</span> <span class="kc">False</span>
+            <span class="k">if</span> <span class="ow">not</span> <span class="n">np</span><span class="o">.</span><span class="n">allclose</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">thetas</span><span class="p">,</span> <span class="n">other</span><span class="o">.</span><span class="n">thetas</span><span class="p">,</span> <span class="n">rtol</span><span class="o">=</span><span class="n">rtol</span><span class="p">,</span> <span class="n">atol</span><span class="o">=</span><span class="n">atol</span><span class="p">):</span>
+                <span class="k">return</span> <span class="kc">False</span>
+            <span class="k">if</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">)</span> <span class="o">!=</span> <span class="p">(</span>
+                <span class="n">other</span><span class="o">.</span><span class="n">final_orbital_rotation</span> <span class="ow">is</span> <span class="kc">None</span>
+            <span class="p">):</span>
+                <span class="k">return</span> <span class="kc">False</span>
+            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+                <span class="k">return</span> <span class="n">np</span><span class="o">.</span><span class="n">allclose</span><span class="p">(</span>
+                    <span class="n">cast</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span><span class="p">),</span>
+                    <span class="n">cast</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">other</span><span class="o">.</span><span class="n">final_orbital_rotation</span><span class="p">),</span>
+                    <span class="n">rtol</span><span class="o">=</span><span class="n">rtol</span><span class="p">,</span>
+                    <span class="n">atol</span><span class="o">=</span><span class="n">atol</span><span class="p">,</span>
+                <span class="p">)</span>
+            <span class="k">return</span> <span class="kc">True</span>
+        <span class="k">return</span> <span class="bp">NotImplemented</span></div>
 
 </pre></div>
         </article>
@@ -420,7 +443,7 @@ <h1>Source code for ffsim.variational.hopgate</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/variational/multireference.html b/_modules/ffsim/variational/multireference.html
index f713af1d0..1ed265b66 100644
--- a/_modules/ffsim/variational/multireference.html
+++ b/_modules/ffsim/variational/multireference.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.variational.multireference - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.variational.multireference - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -426,7 +426,7 @@ <h1>Source code for ffsim.variational.multireference</h1><div class="highlight">
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/variational/num_num.html b/_modules/ffsim/variational/num_num.html
index 33ca16ef8..7c074dfef 100644
--- a/_modules/ffsim/variational/num_num.html
+++ b/_modules/ffsim/variational/num_num.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.variational.num_num - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.variational.num_num - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -355,7 +355,9 @@ <h1>Source code for ffsim.variational.num_num</h1><div class="highlight"><pre>
 <div class="viewcode-block" id="NumNumAnsatzOpSpinBalanced.n_params">
 <a class="viewcode-back" href="../../../api/ffsim.html#ffsim.NumNumAnsatzOpSpinBalanced.n_params">[docs]</a>
     <span class="nd">@staticmethod</span>
-    <span class="k">def</span> <span class="nf">n_params</span><span class="p">(</span><span class="n">interaction_pairs</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]])</span> <span class="o">-&gt;</span> <span class="nb">int</span><span class="p">:</span>
+    <span class="k">def</span> <span class="nf">n_params</span><span class="p">(</span>
+        <span class="n">interaction_pairs</span><span class="p">:</span> <span class="nb">tuple</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]],</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]],</span>
+    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">int</span><span class="p">:</span>
 <span class="w">        </span><span class="sd">&quot;&quot;&quot;Return the number of parameters of an ansatz with given settings.</span>
 
 <span class="sd">        Args:</span>
@@ -506,7 +508,7 @@ <h1>Source code for ffsim.variational.num_num</h1><div class="highlight"><pre>
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/variational/uccsd.html b/_modules/ffsim/variational/uccsd.html
new file mode 100644
index 000000000..f759e7c63
--- /dev/null
+++ b/_modules/ffsim/variational/uccsd.html
@@ -0,0 +1,571 @@
+<!doctype html>
+<html class="no-js" lang="en">
+  <head><meta charset="utf-8"/>
+    <meta name="viewport" content="width=device-width,initial-scale=1"/>
+    <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
+
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.variational.uccsd - ffsim 0.0.48</title>
+      <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
+    <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
+    <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
+    <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo-extensions.css?v=302659d7" />
+    
+    
+
+
+<style>
+  body {
+    --color-code-background: #f8f8f8;
+  --color-code-foreground: black;
+  
+  }
+  @media not print {
+    body[data-theme="dark"] {
+      --color-code-background: #202020;
+  --color-code-foreground: #d0d0d0;
+  
+    }
+    @media (prefers-color-scheme: dark) {
+      body:not([data-theme="light"]) {
+        --color-code-background: #202020;
+  --color-code-foreground: #d0d0d0;
+  
+      }
+    }
+  }
+</style><link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin><link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;600&family=IBM+Plex+Sans:ital,wght@0,400;0,600;1,400;1,600&display=swap" rel="stylesheet"></head>
+  <body>
+    
+    <script>
+      document.body.dataset.theme = localStorage.getItem("theme") || "auto";
+    </script>
+    
+<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
+  <symbol id="svg-toc" viewBox="0 0 24 24">
+    <title>Contents</title>
+    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+      <path d="M14 2H2C1.73478 2 1.48043 2.10536 1.29289 2.29289C1.10536 2.48043 1 2.73478 1 3V13C1 13.2652 1.10536 13.5196 1.29289 13.7071C1.48043 13.8946 1.73478 14 2 14H14C14.2652 14 14.5196 13.8946 14.7071 13.7071C14.8946 13.5196 15 13.2652 15 13V3C15 2.73478 14.8946 2.48043 14.7071 2.29289C14.5196 2.10536 14.2652 2 14 2V2ZM2 3H10V13H2V3ZM14 13H11V3H14V13Z" fill="currentColor"/>
+    </svg>
+  </symbol>
+  <symbol id="svg-menu" viewBox="0 0 24 24">
+    <title>Menu</title>
+    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+      <path d="M14 3H2V4H14V3Z" fill="currentColor"/>
+      <path d="M14 12H2V13H14V12Z" fill="currentColor"/>
+      <path d="M14 6H2V7H14V6Z" fill="currentColor"/>
+      <path d="M14 9H2V10H14V9Z" fill="currentColor"/>
+    </svg>
+  </symbol>
+  <symbol id="svg-arrow-right" viewBox="0 0 24 24">
+    <title>Expand</title>
+    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+      <path d="M11 8L6.00005 13L5.30005 12.3L9.60005 8L5.30005 3.7L6.00005 3L11 8Z" fill="currentColor"/>
+    </svg>
+  </symbol>
+  <symbol id="svg-sun" viewBox="0 0 24 24">
+    <title>Light mode</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" class="feather-sun">
+      <circle cx="12" cy="12" r="5"></circle>
+      <line x1="12" y1="1" x2="12" y2="3"></line>
+      <line x1="12" y1="21" x2="12" y2="23"></line>
+      <line x1="4.22" y1="4.22" x2="5.64" y2="5.64"></line>
+      <line x1="18.36" y1="18.36" x2="19.78" y2="19.78"></line>
+      <line x1="1" y1="12" x2="3" y2="12"></line>
+      <line x1="21" y1="12" x2="23" y2="12"></line>
+      <line x1="4.22" y1="19.78" x2="5.64" y2="18.36"></line>
+      <line x1="18.36" y1="5.64" x2="19.78" y2="4.22"></line>
+    </svg>
+  </symbol>
+  <symbol id="svg-moon" viewBox="0 0 24 24">
+    <title>Dark mode</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-moon">
+      <path stroke="none" d="M0 0h24v24H0z" fill="none" />
+      <path d="M12 3c.132 0 .263 0 .393 0a7.5 7.5 0 0 0 7.92 12.446a9 9 0 1 1 -8.313 -12.454z" />
+    </svg>
+  </symbol>
+  <symbol id="svg-sun-with-moon" viewBox="0 0 24 24">
+    <title>Auto light/dark, in light mode</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"
+      class="icon-custom-derived-from-feather-sun-and-tabler-moon">
+      <path style="opacity: 50%" d="M 5.411 14.504 C 5.471 14.504 5.532 14.504 5.591 14.504 C 3.639 16.319 4.383 19.569 6.931 20.352 C 7.693 20.586 8.512 20.551 9.25 20.252 C 8.023 23.207 4.056 23.725 2.11 21.184 C 0.166 18.642 1.702 14.949 4.874 14.536 C 5.051 14.512 5.231 14.5 5.411 14.5 L 5.411 14.504 Z"/>
+      <line x1="14.5" y1="3.25" x2="14.5" y2="1.25"/>
+      <line x1="14.5" y1="15.85" x2="14.5" y2="17.85"/>
+      <line x1="10.044" y1="5.094" x2="8.63" y2="3.68"/>
+      <line x1="19" y1="14.05" x2="20.414" y2="15.464"/>
+      <line x1="8.2" y1="9.55" x2="6.2" y2="9.55"/>
+      <line x1="20.8" y1="9.55" x2="22.8" y2="9.55"/>
+      <line x1="10.044" y1="14.006" x2="8.63" y2="15.42"/>
+      <line x1="19" y1="5.05" x2="20.414" y2="3.636"/>
+      <circle cx="14.5" cy="9.55" r="3.6"/>
+    </svg>
+  </symbol>
+  <symbol id="svg-moon-with-sun" viewBox="0 0 24 24">
+    <title>Auto light/dark, in dark mode</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"
+      class="icon-custom-derived-from-feather-sun-and-tabler-moon">
+      <path d="M 8.282 7.007 C 8.385 7.007 8.494 7.007 8.595 7.007 C 5.18 10.184 6.481 15.869 10.942 17.24 C 12.275 17.648 13.706 17.589 15 17.066 C 12.851 22.236 5.91 23.143 2.505 18.696 C -0.897 14.249 1.791 7.786 7.342 7.063 C 7.652 7.021 7.965 7 8.282 7 L 8.282 7.007 Z"/>
+      <line style="opacity: 50%" x1="18" y1="3.705" x2="18" y2="2.5"/>
+      <line style="opacity: 50%" x1="18" y1="11.295" x2="18" y2="12.5"/>
+      <line style="opacity: 50%" x1="15.316" y1="4.816" x2="14.464" y2="3.964"/>
+      <line style="opacity: 50%" x1="20.711" y1="10.212" x2="21.563" y2="11.063"/>
+      <line style="opacity: 50%" x1="14.205" y1="7.5" x2="13.001" y2="7.5"/>
+      <line style="opacity: 50%" x1="21.795" y1="7.5" x2="23" y2="7.5"/>
+      <line style="opacity: 50%" x1="15.316" y1="10.184" x2="14.464" y2="11.036"/>
+      <line style="opacity: 50%" x1="20.711" y1="4.789" x2="21.563" y2="3.937"/>
+      <circle style="opacity: 50%" cx="18" cy="7.5" r="2.169"/>
+    </svg>
+  </symbol>
+  <symbol id="svg-pencil" viewBox="0 0 24 24">
+    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+      <path d="M15 13H1V14H15V13Z" fill="currentColor"/>
+      <path d="M12.7 4.5C13.1 4.1 13.1 3.5 12.7 3.1L10.9 1.3C10.5 0.9 9.9 0.9 9.5 1.3L2 8.8V12H5.2L12.7 4.5ZM10.2 2L12 3.8L10.5 5.3L8.7 3.5L10.2 2ZM3 11V9.2L8 4.2L9.8 6L4.8 11H3Z" fill="currentColor"/>
+    </svg>
+  </symbol>
+  <symbol id="svg-eye" viewBox="0 0 24 24">
+    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+      <path d="M11 13.0002C11.5523 13.0002 12 12.5525 12 12.0002C12 11.4479 11.5523 11.0002 11 11.0002C10.4477 11.0002 10 11.4479 10 12.0002C10 12.5525 10.4477 13.0002 11 13.0002Z" fill="currentColor"/>
+      <path d="M14.8884 11.7394C14.5795 10.9524 14.0464 10.2734 13.3552 9.78646C12.664 9.29954 11.8451 9.02615 11 9.00017C10.1549 9.02615 9.33604 9.29954 8.64484 9.78646C7.95365 10.2734 7.42052 10.9524 7.11155 11.7394L7 12.0002L7.11155 12.2609C7.42052 13.0479 7.95365 13.727 8.64484 14.2139C9.33604 14.7008 10.1549 14.9742 11 15.0002C11.8451 14.9742 12.664 14.7008 13.3552 14.2139C14.0464 13.727 14.5795 13.0479 14.8884 12.2609L15 12.0002L14.8884 11.7394ZM11 14.0002C10.6044 14.0002 10.2178 13.8829 9.88886 13.6631C9.55996 13.4433 9.30362 13.131 9.15224 12.7655C9.00087 12.4001 8.96126 11.998 9.03843 11.61C9.1156 11.222 9.30608 10.8657 9.58579 10.586C9.86549 10.3063 10.2219 10.1158 10.6098 10.0386C10.9978 9.96143 11.3999 10.001 11.7654 10.1524C12.1308 10.3038 12.4432 10.5601 12.6629 10.889C12.8827 11.2179 13 11.6046 13 12.0002C12.9994 12.5304 12.7885 13.0388 12.4136 13.4137C12.0386 13.7887 11.5303 13.9996 11 14.0002Z" fill="currentColor"/>
+      <path d="M6 14.0002H4V2.00017H8V5.00017C8.00077 5.26515 8.10637 5.51906 8.29374 5.70643C8.48111 5.8938 8.73502 5.99941 9 6.00017H12V8.00017H13V5.00017C13.0018 4.93446 12.9893 4.86913 12.9634 4.80871C12.9375 4.74828 12.8988 4.6942 12.85 4.65017L9.35 1.15017C9.30599 1.10134 9.2519 1.06263 9.19147 1.03674C9.13104 1.01084 9.06572 0.998364 9 1.00017H4C3.73502 1.00094 3.48111 1.10654 3.29374 1.29391C3.10637 1.48128 3.00077 1.73519 3 2.00017V14.0002C3.00077 14.2652 3.10637 14.5191 3.29374 14.7064C3.48111 14.8938 3.73502 14.9994 4 15.0002H6V14.0002ZM9 2.20017L11.8 5.00017H9V2.20017Z" fill="currentColor"/>
+    </svg>
+  </symbol>
+</svg>
+
+<input type="checkbox" class="sidebar-toggle" name="__navigation" id="__navigation">
+<input type="checkbox" class="sidebar-toggle" name="__toc" id="__toc">
+<label class="overlay sidebar-overlay" for="__navigation">
+  <div class="visually-hidden">Hide navigation sidebar</div>
+</label>
+<label class="overlay toc-overlay" for="__toc">
+  <div class="visually-hidden">Hide table of contents sidebar</div>
+</label>
+
+<a class="skip-to-content muted-link" href="#furo-main-content">Skip to content</a>
+
+
+
+<div class="page">
+  <header class="mobile-header">
+    <div class="header-left">
+      <label class="nav-overlay-icon" for="__navigation">
+        <div class="visually-hidden">Toggle site navigation sidebar</div>
+        <i class="icon"><svg><use href="#svg-menu"></use></svg></i>
+      </label>
+    </div>
+    <div class="header-center">
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
+    </div>
+    <div class="header-right">
+      <div class="theme-toggle-container theme-toggle-header">
+        <button class="theme-toggle">
+          <div class="visually-hidden">Toggle Light / Dark / Auto color theme</div>
+          <svg class="theme-icon-when-auto-light"><use href="#svg-sun-with-moon"></use></svg>
+          <svg class="theme-icon-when-auto-dark"><use href="#svg-moon-with-sun"></use></svg>
+          <svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
+          <svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
+        </button>
+      </div>
+      <label class="toc-overlay-icon toc-header-icon no-toc" for="__toc">
+        <div class="visually-hidden">Toggle table of contents sidebar</div>
+        <i class="icon"><svg><use href="#svg-toc"></use></svg></i>
+      </label>
+    </div>
+  </header>
+  <aside class="sidebar-drawer">
+    <div class="sidebar-container">
+      
+      <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
+  
+  
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
+  
+</a>
+
+<p class="sidebar-ecosystem-link">
+  This project is part of the <a class="reference external" href="https://www.ibm.com/quantum/ecosystem">Qiskit ecosystem</a>
+</p><form class="sidebar-search-container" method="get" action="../../../search.html" role="search">
+  <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
+  <input type="hidden" name="check_keywords" value="yes">
+  <input type="hidden" name="area" value="default">
+</form>
+<div id="searchbox"></div><div class="sidebar-scroll"><div class="sidebar-tree">
+  <ul>
+<li class="toctree-l1"><a class="reference internal" href="../../../install.html">Installation</a></li>
+<li class="toctree-l1 has-children"><a class="reference internal" href="../../../tutorials/index.html">Tutorials</a><input class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" role="switch" type="checkbox"/><label for="toctree-checkbox-1"><div class="visually-hidden">Toggle navigation of Tutorials</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../tutorials/double-factorized-trotter.html">Implementing Trotter simulation of the double-factorized Hamiltonian</a></li>
+</ul>
+</li>
+<li class="toctree-l1 has-children"><a class="reference internal" href="../../../explanations/index.html">Explanations</a><input class="toctree-checkbox" id="toctree-checkbox-2" name="toctree-checkbox-2" role="switch" type="checkbox"/><label for="toctree-checkbox-2"><div class="visually-hidden">Toggle navigation of Explanations</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../explanations/state-vectors-and-gates.html">State vectors and gates</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../explanations/hamiltonians.html">Hamiltonians</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../explanations/orbital-rotation.html">Orbital rotations and quadratic Hamiltonians</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../explanations/double-factorized.html">Double-factorized representation of the molecular Hamiltonian</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../explanations/lucj.html">The local unitary cluster Jastrow (LUCJ) ansatz</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../explanations/qiskit-gate-decompositions.html">Qubit gate decompositions of fermionic gates</a></li>
+</ul>
+</li>
+<li class="toctree-l1 has-children"><a class="reference internal" href="../../../how-to-guides/index.html">How-to guides</a><input class="toctree-checkbox" id="toctree-checkbox-3" name="toctree-checkbox-3" role="switch" type="checkbox"/><label for="toctree-checkbox-3"><div class="visually-hidden">Toggle navigation of How-to guides</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../how-to-guides/lucj.html">How to simulate the local unitary cluster Jastrow (LUCJ) ansatz</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../how-to-guides/entanglement-forging.html">How to simulate entanglement forging</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../how-to-guides/fermion-operator.html">How to use the FermionOperator class</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../how-to-guides/qiskit-circuits.html">How to build and transpile Qiskit quantum circuits</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../how-to-guides/qiskit-sampler.html">How to use ffsim’s Qiskit Sampler primitive</a></li>
+</ul>
+</li>
+<li class="toctree-l1 has-children"><a class="reference internal" href="../../../api/index.html">API reference</a><input class="toctree-checkbox" id="toctree-checkbox-4" name="toctree-checkbox-4" role="switch" type="checkbox"/><label for="toctree-checkbox-4"><div class="visually-hidden">Toggle navigation of API reference</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.html">ffsim</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.contract.html">ffsim.contract</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.linalg.html">ffsim.linalg</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.optimize.html">ffsim.optimize</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.qiskit.html">ffsim.qiskit</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.random.html">ffsim.random</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.testing.html">ffsim.testing</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference external" href="https://github.com/qiskit-community/ffsim">GitHub</a></li>
+<li class="toctree-l1"><a class="reference external" href="https://github.com/qiskit-community/ffsim/blob/main/CONTRIBUTING.md">Developer guide</a></li>
+<li class="toctree-l1"><a class="reference external" href="https://github.com/qiskit-community/ffsim/releases">Release notes</a></li>
+<li class="toctree-l1"><a class="reference external" href="https://qiskit-community.github.io/ffsim/dev/">Development branch docs</a></li>
+</ul>
+
+</div></div>
+      </div>
+      
+    </div>
+  </aside>
+  <div class="main">
+    <div class="content">
+      <div class="article-container">
+        <a href="#" class="back-to-top muted-link">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12z"></path>
+          </svg>
+          <span>Back to top</span>
+        </a>
+        <div class="content-icon-container">
+          <div class="theme-toggle-container theme-toggle-content">
+            <button class="theme-toggle">
+              <div class="visually-hidden">Toggle Light / Dark / Auto color theme</div>
+              <svg class="theme-icon-when-auto-light"><use href="#svg-sun-with-moon"></use></svg>
+              <svg class="theme-icon-when-auto-dark"><use href="#svg-moon-with-sun"></use></svg>
+              <svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
+              <svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
+            </button>
+          </div>
+          <label class="toc-overlay-icon toc-content-icon no-toc" for="__toc">
+            <div class="visually-hidden">Toggle table of contents sidebar</div>
+            <i class="icon"><svg><use href="#svg-toc"></use></svg></i>
+          </label>
+        </div>
+        <article role="main" id="furo-main-content">
+          <h1>Source code for ffsim.variational.uccsd</h1><div class="highlight"><pre>
+<span></span><span class="c1"># (C) Copyright IBM 2024.</span>
+<span class="c1">#</span>
+<span class="c1"># This code is licensed under the Apache License, Version 2.0. You may</span>
+<span class="c1"># obtain a copy of this license in the LICENSE.txt file in the root directory</span>
+<span class="c1"># of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.</span>
+<span class="c1">#</span>
+<span class="c1"># Any modifications or derivative works of this code must retain this</span>
+<span class="c1"># copyright notice, and modified files need to carry a notice indicating</span>
+<span class="c1"># that they have been altered from the originals.</span>
+
+<span class="sd">&quot;&quot;&quot;Unitary coupled cluster, singles and doubles ansatz.&quot;&quot;&quot;</span>
+
+<span class="kn">from</span> <span class="nn">__future__</span> <span class="kn">import</span> <span class="n">annotations</span>
+
+<span class="kn">import</span> <span class="nn">itertools</span>
+<span class="kn">from</span> <span class="nn">dataclasses</span> <span class="kn">import</span> <span class="n">InitVar</span><span class="p">,</span> <span class="n">dataclass</span>
+<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">cast</span>
+
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+<span class="kn">import</span> <span class="nn">scipy.linalg</span>
+<span class="kn">import</span> <span class="nn">scipy.sparse.linalg</span>
+
+<span class="kn">from</span> <span class="nn">ffsim</span> <span class="kn">import</span> <span class="n">gates</span><span class="p">,</span> <span class="n">hamiltonians</span><span class="p">,</span> <span class="n">linalg</span><span class="p">,</span> <span class="n">protocols</span>
+<span class="kn">from</span> <span class="nn">ffsim.variational.util</span> <span class="kn">import</span> <span class="p">(</span>
+    <span class="n">orbital_rotation_from_parameters</span><span class="p">,</span>
+    <span class="n">orbital_rotation_to_parameters</span><span class="p">,</span>
+<span class="p">)</span>
+
+
+<div class="viewcode-block" id="UCCSDOpRestrictedReal">
+<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.UCCSDOpRestrictedReal">[docs]</a>
+<span class="nd">@dataclass</span><span class="p">(</span><span class="n">frozen</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+<span class="k">class</span> <span class="nc">UCCSDOpRestrictedReal</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Real-valued restricted unitary coupled cluster, singles and doubles operator.&quot;&quot;&quot;</span>
+
+    <span class="n">t1</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span>  <span class="c1"># shape: (nocc, nvrt)</span>
+    <span class="n">t2</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span>  <span class="c1"># shape: (nocc, nocc, nvrt, nvrt)</span>
+    <span class="n">final_orbital_rotation</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># shape: (norb, norb)</span>
+    <span class="n">validate</span><span class="p">:</span> <span class="n">InitVar</span><span class="p">[</span><span class="nb">bool</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
+    <span class="n">rtol</span><span class="p">:</span> <span class="n">InitVar</span><span class="p">[</span><span class="nb">float</span><span class="p">]</span> <span class="o">=</span> <span class="mf">1e-5</span>
+    <span class="n">atol</span><span class="p">:</span> <span class="n">InitVar</span><span class="p">[</span><span class="nb">float</span><span class="p">]</span> <span class="o">=</span> <span class="mf">1e-8</span>
+
+    <span class="k">def</span> <span class="nf">__post_init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">validate</span><span class="p">:</span> <span class="nb">bool</span><span class="p">,</span> <span class="n">rtol</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">atol</span><span class="p">:</span> <span class="nb">float</span><span class="p">):</span>
+        <span class="k">if</span> <span class="n">np</span><span class="o">.</span><span class="n">iscomplexobj</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">t1</span><span class="p">):</span>
+            <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span>
+                <span class="s2">&quot;UCCSDOpRestricted only accepts real-valued t1 amplitudes. &quot;</span>
+                <span class="s2">&quot;Please pass a t1 amplitudes tensor with a real-valued data type.&quot;</span>
+            <span class="p">)</span>
+        <span class="k">if</span> <span class="n">np</span><span class="o">.</span><span class="n">iscomplexobj</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">t2</span><span class="p">):</span>
+            <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span>
+                <span class="s2">&quot;UCCSDOpRestricted only accepts real-valued t2 amplitudes. &quot;</span>
+                <span class="s2">&quot;Please pass a t2 amplitudes tensor with a real-valued data type.&quot;</span>
+            <span class="p">)</span>
+        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">np</span><span class="o">.</span><span class="n">iscomplexobj</span><span class="p">(</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span>
+        <span class="p">):</span>
+            <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span>
+                <span class="s2">&quot;UCCSDOpRestricted only accepts a real-valued final &quot;</span>
+                <span class="s2">&quot;orbital rotation. Please pass a final orbital rotation with a &quot;</span>
+                <span class="s2">&quot;real-valued data type.&quot;</span>
+            <span class="p">)</span>
+        <span class="k">if</span> <span class="n">validate</span><span class="p">:</span>
+            <span class="c1"># Validate shapes</span>
+            <span class="n">nocc</span><span class="p">,</span> <span class="n">nvrt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">t1</span><span class="o">.</span><span class="n">shape</span>
+            <span class="n">norb</span> <span class="o">=</span> <span class="n">nocc</span> <span class="o">+</span> <span class="n">nvrt</span>
+            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">t2</span><span class="o">.</span><span class="n">shape</span> <span class="o">!=</span> <span class="p">(</span><span class="n">nocc</span><span class="p">,</span> <span class="n">nocc</span><span class="p">,</span> <span class="n">nvrt</span><span class="p">,</span> <span class="n">nvrt</span><span class="p">):</span>
+                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+                    <span class="s2">&quot;t2 shape not consistent with t1 shape. &quot;</span>
+                    <span class="sa">f</span><span class="s2">&quot;Expected </span><span class="si">{</span><span class="p">(</span><span class="n">nocc</span><span class="p">,</span><span class="w"> </span><span class="n">nocc</span><span class="p">,</span><span class="w"> </span><span class="n">nvrt</span><span class="p">,</span><span class="w"> </span><span class="n">nvrt</span><span class="p">)</span><span class="si">}</span><span class="s2"> but got </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">t2</span><span class="o">.</span><span class="n">shape</span><span class="si">}</span><span class="s2">&quot;</span>
+                <span class="p">)</span>
+            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span><span class="o">.</span><span class="n">shape</span> <span class="o">!=</span> <span class="p">(</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">):</span>
+                    <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+                        <span class="s2">&quot;Final orbital rotation shape not consistent with t1 shape. &quot;</span>
+                        <span class="sa">f</span><span class="s2">&quot;Expected </span><span class="si">{</span><span class="p">(</span><span class="n">norb</span><span class="p">,</span><span class="w"> </span><span class="n">norb</span><span class="p">)</span><span class="si">}</span><span class="s2"> but got &quot;</span>
+                        <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span><span class="o">.</span><span class="n">shape</span><span class="si">}</span><span class="s2">&quot;</span>
+                    <span class="p">)</span>
+                <span class="k">if</span> <span class="ow">not</span> <span class="n">linalg</span><span class="o">.</span><span class="n">is_unitary</span><span class="p">(</span>
+                    <span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span><span class="p">,</span> <span class="n">rtol</span><span class="o">=</span><span class="n">rtol</span><span class="p">,</span> <span class="n">atol</span><span class="o">=</span><span class="n">atol</span>
+                <span class="p">):</span>
+                    <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Final orbital rotation was not unitary.&quot;</span><span class="p">)</span>
+
+    <span class="nd">@property</span>
+    <span class="k">def</span> <span class="nf">norb</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;The number of spatial orbitals.&quot;&quot;&quot;</span>
+        <span class="n">nocc</span><span class="p">,</span> <span class="n">nvrt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">t1</span><span class="o">.</span><span class="n">shape</span>
+        <span class="k">return</span> <span class="n">nocc</span> <span class="o">+</span> <span class="n">nvrt</span>
+
+<div class="viewcode-block" id="UCCSDOpRestrictedReal.n_params">
+<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.UCCSDOpRestrictedReal.n_params">[docs]</a>
+    <span class="nd">@staticmethod</span>
+    <span class="k">def</span> <span class="nf">n_params</span><span class="p">(</span>
+        <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">nocc</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">with_final_orbital_rotation</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span>
+    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">int</span><span class="p">:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Return the number of parameters of an ansatz with given settings.</span>
+
+<span class="sd">        Args:</span>
+<span class="sd">            norb: The number of spatial orbitals.</span>
+<span class="sd">            nocc: The number of spatial orbitals that are occupied by electrons.</span>
+<span class="sd">            with_final_orbital_rotation: Whether to include a final orbital rotation</span>
+<span class="sd">                in the operator.</span>
+
+<span class="sd">        Returns:</span>
+<span class="sd">            The number of parameters of the ansatz.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="n">nvrt</span> <span class="o">=</span> <span class="n">norb</span> <span class="o">-</span> <span class="n">nocc</span>
+        <span class="c1"># Number of occupied-virtual pairs</span>
+        <span class="n">n_pairs</span> <span class="o">=</span> <span class="n">nocc</span> <span class="o">*</span> <span class="n">nvrt</span>
+        <span class="c1"># t1 has n_pairs parameters</span>
+        <span class="c1"># t2 has n_pairs * (n_pairs + 1) // 2 parameters</span>
+        <span class="c1"># Final orbital rotation has norb * (norb - 1) // 2 parameters</span>
+        <span class="k">return</span> <span class="p">(</span>
+            <span class="n">n_pairs</span>
+            <span class="o">+</span> <span class="n">n_pairs</span> <span class="o">*</span> <span class="p">(</span><span class="n">n_pairs</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">//</span> <span class="mi">2</span>
+            <span class="o">+</span> <span class="n">with_final_orbital_rotation</span> <span class="o">*</span> <span class="n">norb</span> <span class="o">*</span> <span class="p">(</span><span class="n">norb</span> <span class="o">-</span> <span class="mi">1</span><span class="p">)</span> <span class="o">//</span> <span class="mi">2</span>
+        <span class="p">)</span></div>
+
+
+<div class="viewcode-block" id="UCCSDOpRestrictedReal.from_parameters">
+<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.UCCSDOpRestrictedReal.from_parameters">[docs]</a>
+    <span class="nd">@staticmethod</span>
+    <span class="k">def</span> <span class="nf">from_parameters</span><span class="p">(</span>
+        <span class="n">params</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span>
+        <span class="o">*</span><span class="p">,</span>
+        <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
+        <span class="n">nocc</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
+        <span class="n">with_final_orbital_rotation</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">UCCSDOpRestrictedReal</span><span class="p">:</span>
+<span class="w">        </span><span class="sa">r</span><span class="sd">&quot;&quot;&quot;Initialize the UCCSD operator from a real-valued parameter vector.</span>
+
+<span class="sd">        Args:</span>
+<span class="sd">            params: The real-valued parameter vector.</span>
+<span class="sd">            norb: The number of spatial orbitals.</span>
+<span class="sd">            nocc: The number of spatial orbitals that are occupied by electrons.</span>
+<span class="sd">            with_final_orbital_rotation: Whether to include a final orbital rotation</span>
+<span class="sd">                in the operator.</span>
+
+<span class="sd">        Returns:</span>
+<span class="sd">            The UCCSD operator constructed from the given parameters.</span>
+
+<span class="sd">        Raises:</span>
+<span class="sd">            ValueError: The number of parameters passed did not match the number</span>
+<span class="sd">                expected based on the function inputs.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="n">n_params</span> <span class="o">=</span> <span class="n">UCCSDOpRestrictedReal</span><span class="o">.</span><span class="n">n_params</span><span class="p">(</span>
+            <span class="n">norb</span><span class="p">,</span> <span class="n">nocc</span><span class="p">,</span> <span class="n">with_final_orbital_rotation</span><span class="o">=</span><span class="n">with_final_orbital_rotation</span>
+        <span class="p">)</span>
+        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">params</span><span class="p">)</span> <span class="o">!=</span> <span class="n">n_params</span><span class="p">:</span>
+            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+                <span class="s2">&quot;The number of parameters passed did not match the number expected &quot;</span>
+                <span class="s2">&quot;based on the function inputs. &quot;</span>
+                <span class="sa">f</span><span class="s2">&quot;Expected </span><span class="si">{</span><span class="n">n_params</span><span class="si">}</span><span class="s2"> but got </span><span class="si">{</span><span class="nb">len</span><span class="p">(</span><span class="n">params</span><span class="p">)</span><span class="si">}</span><span class="s2">.&quot;</span>
+            <span class="p">)</span>
+        <span class="n">nvrt</span> <span class="o">=</span> <span class="n">norb</span> <span class="o">-</span> <span class="n">nocc</span>
+        <span class="n">t1</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">nocc</span><span class="p">,</span> <span class="n">nvrt</span><span class="p">))</span>
+        <span class="n">t2</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">nocc</span><span class="p">,</span> <span class="n">nocc</span><span class="p">,</span> <span class="n">nvrt</span><span class="p">,</span> <span class="n">nvrt</span><span class="p">))</span>
+        <span class="n">occ_vrt_pairs</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">itertools</span><span class="o">.</span><span class="n">product</span><span class="p">(</span><span class="nb">range</span><span class="p">(</span><span class="n">nocc</span><span class="p">),</span> <span class="nb">range</span><span class="p">(</span><span class="n">nocc</span><span class="p">,</span> <span class="n">norb</span><span class="p">)))</span>
+        <span class="n">index</span> <span class="o">=</span> <span class="mi">0</span>
+        <span class="c1"># t1</span>
+        <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">a</span> <span class="ow">in</span> <span class="n">occ_vrt_pairs</span><span class="p">:</span>
+            <span class="n">t1</span><span class="p">[</span><span class="n">i</span><span class="p">,</span> <span class="n">a</span> <span class="o">-</span> <span class="n">nocc</span><span class="p">]</span> <span class="o">=</span> <span class="n">params</span><span class="p">[</span><span class="n">index</span><span class="p">]</span>
+            <span class="n">index</span> <span class="o">+=</span> <span class="mi">1</span>
+        <span class="c1"># t2</span>
+        <span class="k">for</span> <span class="p">(</span><span class="n">i</span><span class="p">,</span> <span class="n">a</span><span class="p">),</span> <span class="p">(</span><span class="n">j</span><span class="p">,</span> <span class="n">b</span><span class="p">)</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">combinations_with_replacement</span><span class="p">(</span><span class="n">occ_vrt_pairs</span><span class="p">,</span> <span class="mi">2</span><span class="p">):</span>
+            <span class="n">t2</span><span class="p">[</span><span class="n">i</span><span class="p">,</span> <span class="n">j</span><span class="p">,</span> <span class="n">a</span> <span class="o">-</span> <span class="n">nocc</span><span class="p">,</span> <span class="n">b</span> <span class="o">-</span> <span class="n">nocc</span><span class="p">]</span> <span class="o">=</span> <span class="n">params</span><span class="p">[</span><span class="n">index</span><span class="p">]</span>
+            <span class="n">t2</span><span class="p">[</span><span class="n">j</span><span class="p">,</span> <span class="n">i</span><span class="p">,</span> <span class="n">b</span> <span class="o">-</span> <span class="n">nocc</span><span class="p">,</span> <span class="n">a</span> <span class="o">-</span> <span class="n">nocc</span><span class="p">]</span> <span class="o">=</span> <span class="n">params</span><span class="p">[</span><span class="n">index</span><span class="p">]</span>
+            <span class="n">index</span> <span class="o">+=</span> <span class="mi">1</span>
+        <span class="c1"># Final orbital rotation</span>
+        <span class="n">final_orbital_rotation</span> <span class="o">=</span> <span class="kc">None</span>
+        <span class="k">if</span> <span class="n">with_final_orbital_rotation</span><span class="p">:</span>
+            <span class="n">final_orbital_rotation</span> <span class="o">=</span> <span class="n">orbital_rotation_from_parameters</span><span class="p">(</span>
+                <span class="n">params</span><span class="p">[</span><span class="n">index</span><span class="p">:],</span> <span class="n">norb</span><span class="p">,</span> <span class="n">real</span><span class="o">=</span><span class="kc">True</span>
+            <span class="p">)</span>
+        <span class="k">return</span> <span class="n">UCCSDOpRestrictedReal</span><span class="p">(</span>
+            <span class="n">t1</span><span class="o">=</span><span class="n">t1</span><span class="p">,</span> <span class="n">t2</span><span class="o">=</span><span class="n">t2</span><span class="p">,</span> <span class="n">final_orbital_rotation</span><span class="o">=</span><span class="n">final_orbital_rotation</span>
+        <span class="p">)</span></div>
+
+
+<div class="viewcode-block" id="UCCSDOpRestrictedReal.to_parameters">
+<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.UCCSDOpRestrictedReal.to_parameters">[docs]</a>
+    <span class="k">def</span> <span class="nf">to_parameters</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
+<span class="w">        </span><span class="sa">r</span><span class="sd">&quot;&quot;&quot;Convert the UCCSD operator to a real-valued parameter vector.</span>
+
+<span class="sd">        Returns:</span>
+<span class="sd">            The real-valued parameter vector.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="n">nocc</span><span class="p">,</span> <span class="n">nvrt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">t1</span><span class="o">.</span><span class="n">shape</span>
+        <span class="n">norb</span> <span class="o">=</span> <span class="n">nocc</span> <span class="o">+</span> <span class="n">nvrt</span>
+        <span class="n">n_params</span> <span class="o">=</span> <span class="n">UCCSDOpRestrictedReal</span><span class="o">.</span><span class="n">n_params</span><span class="p">(</span>
+            <span class="n">norb</span><span class="p">,</span>
+            <span class="n">nocc</span><span class="p">,</span>
+            <span class="n">with_final_orbital_rotation</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">,</span>
+        <span class="p">)</span>
+        <span class="n">params</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">(</span><span class="n">n_params</span><span class="p">)</span>
+        <span class="n">occ_vrt_pairs</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">itertools</span><span class="o">.</span><span class="n">product</span><span class="p">(</span><span class="nb">range</span><span class="p">(</span><span class="n">nocc</span><span class="p">),</span> <span class="nb">range</span><span class="p">(</span><span class="n">nocc</span><span class="p">,</span> <span class="n">norb</span><span class="p">)))</span>
+        <span class="n">index</span> <span class="o">=</span> <span class="mi">0</span>
+        <span class="c1"># t1</span>
+        <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">a</span> <span class="ow">in</span> <span class="n">occ_vrt_pairs</span><span class="p">:</span>
+            <span class="n">params</span><span class="p">[</span><span class="n">index</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">t1</span><span class="p">[</span><span class="n">i</span><span class="p">,</span> <span class="n">a</span> <span class="o">-</span> <span class="n">nocc</span><span class="p">]</span>
+            <span class="n">index</span> <span class="o">+=</span> <span class="mi">1</span>
+        <span class="c1"># t2</span>
+        <span class="k">for</span> <span class="p">(</span><span class="n">i</span><span class="p">,</span> <span class="n">a</span><span class="p">),</span> <span class="p">(</span><span class="n">j</span><span class="p">,</span> <span class="n">b</span><span class="p">)</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">combinations_with_replacement</span><span class="p">(</span><span class="n">occ_vrt_pairs</span><span class="p">,</span> <span class="mi">2</span><span class="p">):</span>
+            <span class="n">params</span><span class="p">[</span><span class="n">index</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">t2</span><span class="p">[</span><span class="n">i</span><span class="p">,</span> <span class="n">j</span><span class="p">,</span> <span class="n">a</span> <span class="o">-</span> <span class="n">nocc</span><span class="p">,</span> <span class="n">b</span> <span class="o">-</span> <span class="n">nocc</span><span class="p">]</span>
+            <span class="n">index</span> <span class="o">+=</span> <span class="mi">1</span>
+        <span class="c1"># Final orbital rotation</span>
+        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+            <span class="n">params</span><span class="p">[</span><span class="n">index</span><span class="p">:]</span> <span class="o">=</span> <span class="n">orbital_rotation_to_parameters</span><span class="p">(</span>
+                <span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span><span class="p">,</span> <span class="n">real</span><span class="o">=</span><span class="kc">True</span>
+            <span class="p">)</span>
+        <span class="k">return</span> <span class="n">params</span></div>
+
+
+    <span class="k">def</span> <span class="nf">_apply_unitary_</span><span class="p">(</span>
+        <span class="bp">self</span><span class="p">,</span> <span class="n">vec</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">nelec</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">],</span> <span class="n">copy</span><span class="p">:</span> <span class="nb">bool</span>
+    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
+        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">nelec</span><span class="p">,</span> <span class="nb">int</span><span class="p">):</span>
+            <span class="k">return</span> <span class="bp">NotImplemented</span>
+        <span class="k">if</span> <span class="n">copy</span><span class="p">:</span>
+            <span class="n">vec</span> <span class="o">=</span> <span class="n">vec</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
+
+        <span class="n">nocc</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">t1</span><span class="o">.</span><span class="n">shape</span>
+        <span class="k">assert</span> <span class="n">nelec</span> <span class="o">==</span> <span class="p">(</span><span class="n">nocc</span><span class="p">,</span> <span class="n">nocc</span><span class="p">)</span>
+
+        <span class="n">one_body_tensor</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">))</span>
+        <span class="n">two_body_tensor</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">))</span>
+        <span class="n">one_body_tensor</span><span class="p">[:</span><span class="n">nocc</span><span class="p">,</span> <span class="n">nocc</span><span class="p">:]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">t1</span>
+        <span class="n">one_body_tensor</span><span class="p">[</span><span class="n">nocc</span><span class="p">:,</span> <span class="p">:</span><span class="n">nocc</span><span class="p">]</span> <span class="o">=</span> <span class="o">-</span><span class="bp">self</span><span class="o">.</span><span class="n">t1</span><span class="o">.</span><span class="n">T</span>
+        <span class="n">two_body_tensor</span><span class="p">[</span><span class="n">nocc</span><span class="p">:,</span> <span class="p">:</span><span class="n">nocc</span><span class="p">,</span> <span class="n">nocc</span><span class="p">:,</span> <span class="p">:</span><span class="n">nocc</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">t2</span><span class="o">.</span><span class="n">transpose</span><span class="p">(</span><span class="mi">2</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">3</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span>
+        <span class="n">two_body_tensor</span><span class="p">[:</span><span class="n">nocc</span><span class="p">,</span> <span class="n">nocc</span><span class="p">:,</span> <span class="p">:</span><span class="n">nocc</span><span class="p">,</span> <span class="n">nocc</span><span class="p">:]</span> <span class="o">=</span> <span class="o">-</span><span class="bp">self</span><span class="o">.</span><span class="n">t2</span><span class="o">.</span><span class="n">transpose</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">3</span><span class="p">)</span>
+
+        <span class="n">linop</span> <span class="o">=</span> <span class="n">protocols</span><span class="o">.</span><span class="n">linear_operator</span><span class="p">(</span>
+            <span class="n">hamiltonians</span><span class="o">.</span><span class="n">MolecularHamiltonian</span><span class="p">(</span>
+                <span class="n">one_body_tensor</span><span class="o">=</span><span class="n">one_body_tensor</span><span class="p">,</span> <span class="n">two_body_tensor</span><span class="o">=</span><span class="n">two_body_tensor</span>
+            <span class="p">),</span>
+            <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span>
+            <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">,</span>
+        <span class="p">)</span>
+        <span class="n">vec</span> <span class="o">=</span> <span class="n">scipy</span><span class="o">.</span><span class="n">sparse</span><span class="o">.</span><span class="n">linalg</span><span class="o">.</span><span class="n">expm_multiply</span><span class="p">(</span><span class="n">linop</span><span class="p">,</span> <span class="n">vec</span><span class="p">,</span> <span class="n">traceA</span><span class="o">=</span><span class="mf">0.0</span><span class="p">)</span>
+
+        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+            <span class="n">vec</span> <span class="o">=</span> <span class="n">gates</span><span class="o">.</span><span class="n">apply_orbital_rotation</span><span class="p">(</span>
+                <span class="n">vec</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span><span class="p">,</span> <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span> <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">,</span> <span class="n">copy</span><span class="o">=</span><span class="kc">False</span>
+            <span class="p">)</span>
+
+        <span class="k">return</span> <span class="n">vec</span>
+
+    <span class="k">def</span> <span class="nf">_approx_eq_</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">other</span><span class="p">,</span> <span class="n">rtol</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">atol</span><span class="p">:</span> <span class="nb">float</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
+        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">other</span><span class="p">,</span> <span class="n">UCCSDOpRestrictedReal</span><span class="p">):</span>
+            <span class="k">if</span> <span class="ow">not</span> <span class="n">np</span><span class="o">.</span><span class="n">allclose</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">t1</span><span class="p">,</span> <span class="n">other</span><span class="o">.</span><span class="n">t1</span><span class="p">,</span> <span class="n">rtol</span><span class="o">=</span><span class="n">rtol</span><span class="p">,</span> <span class="n">atol</span><span class="o">=</span><span class="n">atol</span><span class="p">):</span>
+                <span class="k">return</span> <span class="kc">False</span>
+            <span class="k">if</span> <span class="ow">not</span> <span class="n">np</span><span class="o">.</span><span class="n">allclose</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">t2</span><span class="p">,</span> <span class="n">other</span><span class="o">.</span><span class="n">t2</span><span class="p">,</span> <span class="n">rtol</span><span class="o">=</span><span class="n">rtol</span><span class="p">,</span> <span class="n">atol</span><span class="o">=</span><span class="n">atol</span><span class="p">):</span>
+                <span class="k">return</span> <span class="kc">False</span>
+            <span class="k">if</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">)</span> <span class="o">!=</span> <span class="p">(</span>
+                <span class="n">other</span><span class="o">.</span><span class="n">final_orbital_rotation</span> <span class="ow">is</span> <span class="kc">None</span>
+            <span class="p">):</span>
+                <span class="k">return</span> <span class="kc">False</span>
+            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+                <span class="k">return</span> <span class="n">np</span><span class="o">.</span><span class="n">allclose</span><span class="p">(</span>
+                    <span class="n">cast</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span><span class="p">),</span>
+                    <span class="n">cast</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">other</span><span class="o">.</span><span class="n">final_orbital_rotation</span><span class="p">),</span>
+                    <span class="n">rtol</span><span class="o">=</span><span class="n">rtol</span><span class="p">,</span>
+                    <span class="n">atol</span><span class="o">=</span><span class="n">atol</span><span class="p">,</span>
+                <span class="p">)</span>
+            <span class="k">return</span> <span class="kc">True</span>
+        <span class="k">return</span> <span class="bp">NotImplemented</span></div>
+
+</pre></div>
+        </article>
+      </div>
+      <footer>
+        
+        <div class="related-pages">
+          
+          
+        </div>
+        <div class="bottom-of-page">
+          <div class="left-details">
+            <div class="copyright">
+                Copyright &#169; 2023, IBM
+            </div>
+            Made with <a href="https://www.sphinx-doc.org/">Sphinx</a> and <a class="muted-link" href="https://pradyunsg.me">@pradyunsg</a>'s
+            
+            <a href="https://github.com/pradyunsg/furo">Furo</a>
+            
+          </div>
+          <div class="right-details">
+            
+          </div>
+        </div>
+        
+      </footer>
+    </div>
+    <aside class="toc-drawer no-toc">
+      
+      
+      
+    </aside>
+  </div>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
+    <script src="../../../_static/doctools.js?v=9bcbadda"></script>
+    <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
+    <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
+    <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+    </body>
+</html>
\ No newline at end of file
diff --git a/_modules/ffsim/variational/ucj.html b/_modules/ffsim/variational/ucj.html
deleted file mode 100644
index 00a43e774..000000000
--- a/_modules/ffsim/variational/ucj.html
+++ /dev/null
@@ -1,1064 +0,0 @@
-<!doctype html>
-<html class="no-js" lang="en">
-  <head><meta charset="utf-8"/>
-    <meta name="viewport" content="width=device-width,initial-scale=1"/>
-    <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
-
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.variational.ucj - ffsim 0.0.47</title>
-      <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
-    <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
-    <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
-    <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo-extensions.css?v=302659d7" />
-    
-    
-
-
-<style>
-  body {
-    --color-code-background: #f8f8f8;
-  --color-code-foreground: black;
-  
-  }
-  @media not print {
-    body[data-theme="dark"] {
-      --color-code-background: #202020;
-  --color-code-foreground: #d0d0d0;
-  
-    }
-    @media (prefers-color-scheme: dark) {
-      body:not([data-theme="light"]) {
-        --color-code-background: #202020;
-  --color-code-foreground: #d0d0d0;
-  
-      }
-    }
-  }
-</style><link rel="preconnect" href="https://fonts.googleapis.com">
-<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin><link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;600&family=IBM+Plex+Sans:ital,wght@0,400;0,600;1,400;1,600&display=swap" rel="stylesheet"></head>
-  <body>
-    
-    <script>
-      document.body.dataset.theme = localStorage.getItem("theme") || "auto";
-    </script>
-    
-<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
-  <symbol id="svg-toc" viewBox="0 0 24 24">
-    <title>Contents</title>
-    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
-      <path d="M14 2H2C1.73478 2 1.48043 2.10536 1.29289 2.29289C1.10536 2.48043 1 2.73478 1 3V13C1 13.2652 1.10536 13.5196 1.29289 13.7071C1.48043 13.8946 1.73478 14 2 14H14C14.2652 14 14.5196 13.8946 14.7071 13.7071C14.8946 13.5196 15 13.2652 15 13V3C15 2.73478 14.8946 2.48043 14.7071 2.29289C14.5196 2.10536 14.2652 2 14 2V2ZM2 3H10V13H2V3ZM14 13H11V3H14V13Z" fill="currentColor"/>
-    </svg>
-  </symbol>
-  <symbol id="svg-menu" viewBox="0 0 24 24">
-    <title>Menu</title>
-    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
-      <path d="M14 3H2V4H14V3Z" fill="currentColor"/>
-      <path d="M14 12H2V13H14V12Z" fill="currentColor"/>
-      <path d="M14 6H2V7H14V6Z" fill="currentColor"/>
-      <path d="M14 9H2V10H14V9Z" fill="currentColor"/>
-    </svg>
-  </symbol>
-  <symbol id="svg-arrow-right" viewBox="0 0 24 24">
-    <title>Expand</title>
-    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
-      <path d="M11 8L6.00005 13L5.30005 12.3L9.60005 8L5.30005 3.7L6.00005 3L11 8Z" fill="currentColor"/>
-    </svg>
-  </symbol>
-  <symbol id="svg-sun" viewBox="0 0 24 24">
-    <title>Light mode</title>
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
-      stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" class="feather-sun">
-      <circle cx="12" cy="12" r="5"></circle>
-      <line x1="12" y1="1" x2="12" y2="3"></line>
-      <line x1="12" y1="21" x2="12" y2="23"></line>
-      <line x1="4.22" y1="4.22" x2="5.64" y2="5.64"></line>
-      <line x1="18.36" y1="18.36" x2="19.78" y2="19.78"></line>
-      <line x1="1" y1="12" x2="3" y2="12"></line>
-      <line x1="21" y1="12" x2="23" y2="12"></line>
-      <line x1="4.22" y1="19.78" x2="5.64" y2="18.36"></line>
-      <line x1="18.36" y1="5.64" x2="19.78" y2="4.22"></line>
-    </svg>
-  </symbol>
-  <symbol id="svg-moon" viewBox="0 0 24 24">
-    <title>Dark mode</title>
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
-      stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-moon">
-      <path stroke="none" d="M0 0h24v24H0z" fill="none" />
-      <path d="M12 3c.132 0 .263 0 .393 0a7.5 7.5 0 0 0 7.92 12.446a9 9 0 1 1 -8.313 -12.454z" />
-    </svg>
-  </symbol>
-  <symbol id="svg-sun-with-moon" viewBox="0 0 24 24">
-    <title>Auto light/dark, in light mode</title>
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
-      stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"
-      class="icon-custom-derived-from-feather-sun-and-tabler-moon">
-      <path style="opacity: 50%" d="M 5.411 14.504 C 5.471 14.504 5.532 14.504 5.591 14.504 C 3.639 16.319 4.383 19.569 6.931 20.352 C 7.693 20.586 8.512 20.551 9.25 20.252 C 8.023 23.207 4.056 23.725 2.11 21.184 C 0.166 18.642 1.702 14.949 4.874 14.536 C 5.051 14.512 5.231 14.5 5.411 14.5 L 5.411 14.504 Z"/>
-      <line x1="14.5" y1="3.25" x2="14.5" y2="1.25"/>
-      <line x1="14.5" y1="15.85" x2="14.5" y2="17.85"/>
-      <line x1="10.044" y1="5.094" x2="8.63" y2="3.68"/>
-      <line x1="19" y1="14.05" x2="20.414" y2="15.464"/>
-      <line x1="8.2" y1="9.55" x2="6.2" y2="9.55"/>
-      <line x1="20.8" y1="9.55" x2="22.8" y2="9.55"/>
-      <line x1="10.044" y1="14.006" x2="8.63" y2="15.42"/>
-      <line x1="19" y1="5.05" x2="20.414" y2="3.636"/>
-      <circle cx="14.5" cy="9.55" r="3.6"/>
-    </svg>
-  </symbol>
-  <symbol id="svg-moon-with-sun" viewBox="0 0 24 24">
-    <title>Auto light/dark, in dark mode</title>
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
-      stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"
-      class="icon-custom-derived-from-feather-sun-and-tabler-moon">
-      <path d="M 8.282 7.007 C 8.385 7.007 8.494 7.007 8.595 7.007 C 5.18 10.184 6.481 15.869 10.942 17.24 C 12.275 17.648 13.706 17.589 15 17.066 C 12.851 22.236 5.91 23.143 2.505 18.696 C -0.897 14.249 1.791 7.786 7.342 7.063 C 7.652 7.021 7.965 7 8.282 7 L 8.282 7.007 Z"/>
-      <line style="opacity: 50%" x1="18" y1="3.705" x2="18" y2="2.5"/>
-      <line style="opacity: 50%" x1="18" y1="11.295" x2="18" y2="12.5"/>
-      <line style="opacity: 50%" x1="15.316" y1="4.816" x2="14.464" y2="3.964"/>
-      <line style="opacity: 50%" x1="20.711" y1="10.212" x2="21.563" y2="11.063"/>
-      <line style="opacity: 50%" x1="14.205" y1="7.5" x2="13.001" y2="7.5"/>
-      <line style="opacity: 50%" x1="21.795" y1="7.5" x2="23" y2="7.5"/>
-      <line style="opacity: 50%" x1="15.316" y1="10.184" x2="14.464" y2="11.036"/>
-      <line style="opacity: 50%" x1="20.711" y1="4.789" x2="21.563" y2="3.937"/>
-      <circle style="opacity: 50%" cx="18" cy="7.5" r="2.169"/>
-    </svg>
-  </symbol>
-  <symbol id="svg-pencil" viewBox="0 0 24 24">
-    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
-      <path d="M15 13H1V14H15V13Z" fill="currentColor"/>
-      <path d="M12.7 4.5C13.1 4.1 13.1 3.5 12.7 3.1L10.9 1.3C10.5 0.9 9.9 0.9 9.5 1.3L2 8.8V12H5.2L12.7 4.5ZM10.2 2L12 3.8L10.5 5.3L8.7 3.5L10.2 2ZM3 11V9.2L8 4.2L9.8 6L4.8 11H3Z" fill="currentColor"/>
-    </svg>
-  </symbol>
-  <symbol id="svg-eye" viewBox="0 0 24 24">
-    <svg viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
-      <path d="M11 13.0002C11.5523 13.0002 12 12.5525 12 12.0002C12 11.4479 11.5523 11.0002 11 11.0002C10.4477 11.0002 10 11.4479 10 12.0002C10 12.5525 10.4477 13.0002 11 13.0002Z" fill="currentColor"/>
-      <path d="M14.8884 11.7394C14.5795 10.9524 14.0464 10.2734 13.3552 9.78646C12.664 9.29954 11.8451 9.02615 11 9.00017C10.1549 9.02615 9.33604 9.29954 8.64484 9.78646C7.95365 10.2734 7.42052 10.9524 7.11155 11.7394L7 12.0002L7.11155 12.2609C7.42052 13.0479 7.95365 13.727 8.64484 14.2139C9.33604 14.7008 10.1549 14.9742 11 15.0002C11.8451 14.9742 12.664 14.7008 13.3552 14.2139C14.0464 13.727 14.5795 13.0479 14.8884 12.2609L15 12.0002L14.8884 11.7394ZM11 14.0002C10.6044 14.0002 10.2178 13.8829 9.88886 13.6631C9.55996 13.4433 9.30362 13.131 9.15224 12.7655C9.00087 12.4001 8.96126 11.998 9.03843 11.61C9.1156 11.222 9.30608 10.8657 9.58579 10.586C9.86549 10.3063 10.2219 10.1158 10.6098 10.0386C10.9978 9.96143 11.3999 10.001 11.7654 10.1524C12.1308 10.3038 12.4432 10.5601 12.6629 10.889C12.8827 11.2179 13 11.6046 13 12.0002C12.9994 12.5304 12.7885 13.0388 12.4136 13.4137C12.0386 13.7887 11.5303 13.9996 11 14.0002Z" fill="currentColor"/>
-      <path d="M6 14.0002H4V2.00017H8V5.00017C8.00077 5.26515 8.10637 5.51906 8.29374 5.70643C8.48111 5.8938 8.73502 5.99941 9 6.00017H12V8.00017H13V5.00017C13.0018 4.93446 12.9893 4.86913 12.9634 4.80871C12.9375 4.74828 12.8988 4.6942 12.85 4.65017L9.35 1.15017C9.30599 1.10134 9.2519 1.06263 9.19147 1.03674C9.13104 1.01084 9.06572 0.998364 9 1.00017H4C3.73502 1.00094 3.48111 1.10654 3.29374 1.29391C3.10637 1.48128 3.00077 1.73519 3 2.00017V14.0002C3.00077 14.2652 3.10637 14.5191 3.29374 14.7064C3.48111 14.8938 3.73502 14.9994 4 15.0002H6V14.0002ZM9 2.20017L11.8 5.00017H9V2.20017Z" fill="currentColor"/>
-    </svg>
-  </symbol>
-</svg>
-
-<input type="checkbox" class="sidebar-toggle" name="__navigation" id="__navigation">
-<input type="checkbox" class="sidebar-toggle" name="__toc" id="__toc">
-<label class="overlay sidebar-overlay" for="__navigation">
-  <div class="visually-hidden">Hide navigation sidebar</div>
-</label>
-<label class="overlay toc-overlay" for="__toc">
-  <div class="visually-hidden">Hide table of contents sidebar</div>
-</label>
-
-<a class="skip-to-content muted-link" href="#furo-main-content">Skip to content</a>
-
-
-
-<div class="page">
-  <header class="mobile-header">
-    <div class="header-left">
-      <label class="nav-overlay-icon" for="__navigation">
-        <div class="visually-hidden">Toggle site navigation sidebar</div>
-        <i class="icon"><svg><use href="#svg-menu"></use></svg></i>
-      </label>
-    </div>
-    <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
-    </div>
-    <div class="header-right">
-      <div class="theme-toggle-container theme-toggle-header">
-        <button class="theme-toggle">
-          <div class="visually-hidden">Toggle Light / Dark / Auto color theme</div>
-          <svg class="theme-icon-when-auto-light"><use href="#svg-sun-with-moon"></use></svg>
-          <svg class="theme-icon-when-auto-dark"><use href="#svg-moon-with-sun"></use></svg>
-          <svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
-          <svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
-        </button>
-      </div>
-      <label class="toc-overlay-icon toc-header-icon no-toc" for="__toc">
-        <div class="visually-hidden">Toggle table of contents sidebar</div>
-        <i class="icon"><svg><use href="#svg-toc"></use></svg></i>
-      </label>
-    </div>
-  </header>
-  <aside class="sidebar-drawer">
-    <div class="sidebar-container">
-      
-      <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
-  
-  
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
-  
-</a>
-
-<p class="sidebar-ecosystem-link">
-  This project is part of the <a class="reference external" href="https://www.ibm.com/quantum/ecosystem">Qiskit ecosystem</a>
-</p><form class="sidebar-search-container" method="get" action="../../../search.html" role="search">
-  <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
-  <input type="hidden" name="check_keywords" value="yes">
-  <input type="hidden" name="area" value="default">
-</form>
-<div id="searchbox"></div><div class="sidebar-scroll"><div class="sidebar-tree">
-  <ul>
-<li class="toctree-l1"><a class="reference internal" href="../../../install.html">Installation</a></li>
-<li class="toctree-l1 has-children"><a class="reference internal" href="../../../tutorials/index.html">Tutorials</a><input class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" role="switch" type="checkbox"/><label for="toctree-checkbox-1"><div class="visually-hidden">Toggle navigation of Tutorials</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
-<li class="toctree-l2"><a class="reference internal" href="../../../tutorials/double-factorized-trotter.html">Implementing Trotter simulation of the double-factorized Hamiltonian</a></li>
-</ul>
-</li>
-<li class="toctree-l1 has-children"><a class="reference internal" href="../../../explanations/index.html">Explanations</a><input class="toctree-checkbox" id="toctree-checkbox-2" name="toctree-checkbox-2" role="switch" type="checkbox"/><label for="toctree-checkbox-2"><div class="visually-hidden">Toggle navigation of Explanations</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
-<li class="toctree-l2"><a class="reference internal" href="../../../explanations/state-vectors-and-gates.html">State vectors and gates</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../explanations/hamiltonians.html">Hamiltonians</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../explanations/orbital-rotation.html">Orbital rotations and quadratic Hamiltonians</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../explanations/double-factorized.html">Double-factorized representation of the molecular Hamiltonian</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../explanations/lucj.html">The local unitary cluster Jastrow (LUCJ) ansatz</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../explanations/qiskit-gate-decompositions.html">Qubit gate decompositions of fermionic gates</a></li>
-</ul>
-</li>
-<li class="toctree-l1 has-children"><a class="reference internal" href="../../../how-to-guides/index.html">How-to guides</a><input class="toctree-checkbox" id="toctree-checkbox-3" name="toctree-checkbox-3" role="switch" type="checkbox"/><label for="toctree-checkbox-3"><div class="visually-hidden">Toggle navigation of How-to guides</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
-<li class="toctree-l2"><a class="reference internal" href="../../../how-to-guides/lucj.html">How to simulate the local unitary cluster Jastrow (LUCJ) ansatz</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../how-to-guides/entanglement-forging.html">How to simulate entanglement forging</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../how-to-guides/fermion-operator.html">How to use the FermionOperator class</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../how-to-guides/qiskit-circuits.html">How to build and transpile Qiskit quantum circuits</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../how-to-guides/qiskit-sampler.html">How to use ffsim’s Qiskit Sampler primitive</a></li>
-</ul>
-</li>
-<li class="toctree-l1 has-children"><a class="reference internal" href="../../../api/index.html">API reference</a><input class="toctree-checkbox" id="toctree-checkbox-4" name="toctree-checkbox-4" role="switch" type="checkbox"/><label for="toctree-checkbox-4"><div class="visually-hidden">Toggle navigation of API reference</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
-<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.html">ffsim</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.contract.html">ffsim.contract</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.linalg.html">ffsim.linalg</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.optimize.html">ffsim.optimize</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.qiskit.html">ffsim.qiskit</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.random.html">ffsim.random</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../../../api/ffsim.testing.html">ffsim.testing</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference external" href="https://github.com/qiskit-community/ffsim">GitHub</a></li>
-<li class="toctree-l1"><a class="reference external" href="https://github.com/qiskit-community/ffsim/blob/main/CONTRIBUTING.md">Developer guide</a></li>
-<li class="toctree-l1"><a class="reference external" href="https://github.com/qiskit-community/ffsim/releases">Release notes</a></li>
-<li class="toctree-l1"><a class="reference external" href="https://qiskit-community.github.io/ffsim/dev/">Development branch docs</a></li>
-</ul>
-
-</div></div>
-      </div>
-      
-    </div>
-  </aside>
-  <div class="main">
-    <div class="content">
-      <div class="article-container">
-        <a href="#" class="back-to-top muted-link">
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
-            <path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12z"></path>
-          </svg>
-          <span>Back to top</span>
-        </a>
-        <div class="content-icon-container">
-          <div class="theme-toggle-container theme-toggle-content">
-            <button class="theme-toggle">
-              <div class="visually-hidden">Toggle Light / Dark / Auto color theme</div>
-              <svg class="theme-icon-when-auto-light"><use href="#svg-sun-with-moon"></use></svg>
-              <svg class="theme-icon-when-auto-dark"><use href="#svg-moon-with-sun"></use></svg>
-              <svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
-              <svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
-            </button>
-          </div>
-          <label class="toc-overlay-icon toc-content-icon no-toc" for="__toc">
-            <div class="visually-hidden">Toggle table of contents sidebar</div>
-            <i class="icon"><svg><use href="#svg-toc"></use></svg></i>
-          </label>
-        </div>
-        <article role="main" id="furo-main-content">
-          <h1>Source code for ffsim.variational.ucj</h1><div class="highlight"><pre>
-<span></span><span class="c1"># (C) Copyright IBM 2023.</span>
-<span class="c1">#</span>
-<span class="c1"># This code is licensed under the Apache License, Version 2.0. You may</span>
-<span class="c1"># obtain a copy of this license in the LICENSE.txt file in the root directory</span>
-<span class="c1"># of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.</span>
-<span class="c1">#</span>
-<span class="c1"># Any modifications or derivative works of this code must retain this</span>
-<span class="c1"># copyright notice, and modified files need to carry a notice indicating</span>
-<span class="c1"># that they have been altered from the originals.</span>
-
-<span class="sd">&quot;&quot;&quot;(Local) unitary cluster Jastrow ansatz.&quot;&quot;&quot;</span>
-
-<span class="kn">from</span> <span class="nn">__future__</span> <span class="kn">import</span> <span class="n">annotations</span>
-
-<span class="kn">import</span> <span class="nn">itertools</span>
-<span class="kn">from</span> <span class="nn">dataclasses</span> <span class="kn">import</span> <span class="n">dataclass</span>
-<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">cast</span>
-
-<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
-<span class="kn">import</span> <span class="nn">scipy.linalg</span>
-<span class="kn">from</span> <span class="nn">opt_einsum</span> <span class="kn">import</span> <span class="n">contract</span>
-<span class="kn">from</span> <span class="nn">typing_extensions</span> <span class="kn">import</span> <span class="n">deprecated</span>
-
-<span class="kn">from</span> <span class="nn">ffsim.gates</span> <span class="kn">import</span> <span class="n">apply_diag_coulomb_evolution</span><span class="p">,</span> <span class="n">apply_orbital_rotation</span>
-<span class="kn">from</span> <span class="nn">ffsim.linalg</span> <span class="kn">import</span> <span class="n">double_factorized_t2</span>
-<span class="kn">from</span> <span class="nn">ffsim.variational.util</span> <span class="kn">import</span> <span class="p">(</span>
-    <span class="n">orbital_rotation_from_parameters</span><span class="p">,</span>
-    <span class="n">orbital_rotation_to_parameters</span><span class="p">,</span>
-<span class="p">)</span>
-
-
-<span class="k">def</span> <span class="nf">_validate_diag_coulomb_indices</span><span class="p">(</span><span class="n">indices</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span><span class="p">):</span>
-    <span class="k">if</span> <span class="n">indices</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">j</span> <span class="ow">in</span> <span class="n">indices</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">i</span> <span class="o">&gt;</span> <span class="n">j</span><span class="p">:</span>
-                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-                    <span class="s2">&quot;When specifying diagonal Coulomb indices, you must give only &quot;</span>
-                    <span class="s2">&quot;upper trianglular indices. &quot;</span>
-                    <span class="sa">f</span><span class="s2">&quot;Got </span><span class="si">{</span><span class="p">(</span><span class="n">i</span><span class="p">,</span><span class="w"> </span><span class="n">j</span><span class="p">)</span><span class="si">}</span><span class="s2">, which is a lower triangular index.&quot;</span>
-                <span class="p">)</span>
-
-
-<div class="viewcode-block" id="UCJOperator">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.UCJOperator">[docs]</a>
-<span class="nd">@dataclass</span><span class="p">(</span><span class="n">frozen</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-<span class="nd">@deprecated</span><span class="p">(</span><span class="s2">&quot;The UCJOperator class is deprecated. Use UCJOpSpinBalanced instead.&quot;</span><span class="p">)</span>
-<span class="k">class</span> <span class="nc">UCJOperator</span><span class="p">:</span>
-<span class="w">    </span><span class="sa">r</span><span class="sd">&quot;&quot;&quot;A unitary cluster Jastrow operator.</span>
-
-<span class="sd">    .. warning::</span>
-<span class="sd">        The UCJOperator class is deprecated. Use :class:`ffsim.UCJOpSpinBalanced`</span>
-<span class="sd">        instead.</span>
-
-<span class="sd">    A unitary cluster Jastrow (UCJ) operator has the form</span>
-
-<span class="sd">    .. math::</span>
-
-<span class="sd">        \prod_{k = 1}^L \mathcal{W}_k e^{i \mathcal{J}_k} \mathcal{W}_k^\dagger</span>
-
-<span class="sd">    where each :math:`\mathcal{W_k}` is an orbital rotation and each :math:`\mathcal{J}`</span>
-<span class="sd">    is a diagonal Coulomb operator of the form</span>
-
-<span class="sd">    .. math::</span>
-
-<span class="sd">        \mathcal{J} = \frac12\sum_{\sigma \tau, ij}</span>
-<span class="sd">        \mathbf{J}^{\sigma \tau}_{ij} n_{\sigma, i} n_{\tau, j}.</span>
-
-<span class="sd">    In order that the operator commutes with the total spin Z operator, we enforce that</span>
-<span class="sd">    :math:`\mathbf{J}^{\alpha\alpha} = \mathbf{J}^{\beta\beta}` and</span>
-<span class="sd">    :math:`\mathbf{J}^{\alpha\beta} = \mathbf{J}^{\beta\alpha}`. As a result, we have</span>
-<span class="sd">    two sets of matrices for describing the diagonal Coulomb operators:</span>
-<span class="sd">    &quot;alpha-alpha&quot; matrices containing coefficients for terms involving the same spin,</span>
-<span class="sd">    and &quot;alpha-beta&quot; matrices containing coefficients for terms involving different</span>
-<span class="sd">    spins.</span>
-
-<span class="sd">    To support variational optimization of the orbital basis, an optional final</span>
-<span class="sd">    orbital rotation can be included in the operator, to be performed at the end.</span>
-
-<span class="sd">    Attributes:</span>
-<span class="sd">        diag_coulomb_mats_alpha_alpha (np.ndarray): The &quot;alpha-alpha&quot; diagonal Coulomb</span>
-<span class="sd">            matrices.</span>
-<span class="sd">        diag_coulomb_mats_alpha_beta (np.ndarray): The &quot;alpha-beta&quot; diagonal Coulomb</span>
-<span class="sd">            matrices.</span>
-<span class="sd">        orbital_rotations (np.ndarray): The orbital rotations.</span>
-<span class="sd">        final_orbital_rotation (np.ndarray): The optional final orbital rotation.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="n">diag_coulomb_mats_alpha_alpha</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span>
-    <span class="n">diag_coulomb_mats_alpha_beta</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span>
-    <span class="n">orbital_rotations</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span>
-    <span class="n">final_orbital_rotation</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">norb</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;The number of spatial orbitals.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">diag_coulomb_mats_alpha_alpha</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">n_reps</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;The number of ansatz repetitions.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">diag_coulomb_mats_alpha_alpha</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
-
-<div class="viewcode-block" id="UCJOperator.n_params">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.UCJOperator.n_params">[docs]</a>
-    <span class="nd">@staticmethod</span>
-    <span class="k">def</span> <span class="nf">n_params</span><span class="p">(</span>
-        <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-        <span class="n">n_reps</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-        <span class="o">*</span><span class="p">,</span>
-        <span class="n">alpha_alpha_indices</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-        <span class="n">alpha_beta_indices</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-        <span class="n">with_final_orbital_rotation</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">int</span><span class="p">:</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Return the number of parameters of an ansatz with given settings.&quot;&quot;&quot;</span>
-        <span class="n">_validate_diag_coulomb_indices</span><span class="p">(</span><span class="n">alpha_alpha_indices</span><span class="p">)</span>
-        <span class="n">_validate_diag_coulomb_indices</span><span class="p">(</span><span class="n">alpha_beta_indices</span><span class="p">)</span>
-        <span class="n">n_params_aa</span> <span class="o">=</span> <span class="p">(</span>
-            <span class="n">norb</span> <span class="o">*</span> <span class="p">(</span><span class="n">norb</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">//</span> <span class="mi">2</span>
-            <span class="k">if</span> <span class="n">alpha_alpha_indices</span> <span class="ow">is</span> <span class="kc">None</span>
-            <span class="k">else</span> <span class="nb">len</span><span class="p">(</span><span class="n">alpha_alpha_indices</span><span class="p">)</span>
-        <span class="p">)</span>
-        <span class="n">n_params_ab</span> <span class="o">=</span> <span class="p">(</span>
-            <span class="n">norb</span> <span class="o">*</span> <span class="p">(</span><span class="n">norb</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">//</span> <span class="mi">2</span>
-            <span class="k">if</span> <span class="n">alpha_beta_indices</span> <span class="ow">is</span> <span class="kc">None</span>
-            <span class="k">else</span> <span class="nb">len</span><span class="p">(</span><span class="n">alpha_beta_indices</span><span class="p">)</span>
-        <span class="p">)</span>
-        <span class="k">return</span> <span class="p">(</span>
-            <span class="n">n_reps</span> <span class="o">*</span> <span class="p">(</span><span class="n">norb</span><span class="o">**</span><span class="mi">2</span> <span class="o">+</span> <span class="n">n_params_aa</span> <span class="o">+</span> <span class="n">n_params_ab</span><span class="p">)</span>
-            <span class="o">+</span> <span class="n">with_final_orbital_rotation</span> <span class="o">*</span> <span class="n">norb</span><span class="o">**</span><span class="mi">2</span>
-        <span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="UCJOperator.from_parameters">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.UCJOperator.from_parameters">[docs]</a>
-    <span class="nd">@staticmethod</span>
-    <span class="nd">@deprecated</span><span class="p">(</span><span class="s2">&quot;The UCJOperator class is deprecated. Use UCJOpSpinBalanced instead.&quot;</span><span class="p">)</span>
-    <span class="k">def</span> <span class="nf">from_parameters</span><span class="p">(</span>
-        <span class="n">params</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span>
-        <span class="o">*</span><span class="p">,</span>
-        <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-        <span class="n">n_reps</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-        <span class="n">alpha_alpha_indices</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-        <span class="n">alpha_beta_indices</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-        <span class="n">with_final_orbital_rotation</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">UCJOperator</span><span class="p">:</span>
-<span class="w">        </span><span class="sa">r</span><span class="sd">&quot;&quot;&quot;Initialize the UCJ operator from a real-valued parameter vector.</span>
-
-<span class="sd">        Args:</span>
-<span class="sd">            params: The real-valued parameter vector.</span>
-<span class="sd">            norb: The number of spatial orbitals.</span>
-<span class="sd">            n_reps: The number of ansatz repetitions (:math:`L` from the docstring of</span>
-<span class="sd">                this class).</span>
-<span class="sd">            alpha_alpha_indices: Allowed indices for nonzero values of the &quot;alpha-alpha&quot;</span>
-<span class="sd">                diagonal Coulomb matrices (see the docstring of this class).</span>
-<span class="sd">                If not specified, all matrix entries are allowed to be nonzero.</span>
-<span class="sd">                This list should contain only upper trianglular indices, i.e.,</span>
-<span class="sd">                pairs :math:`(i, j)` where :math:`i \leq j`. Passing a list with</span>
-<span class="sd">                lower triangular indices will raise an error.</span>
-<span class="sd">            alpha_beta_indices: Allowed indices for nonzero values of the &quot;alpha-beta&quot;</span>
-<span class="sd">                diagonal Coulomb matrices (see the docstring of this class).</span>
-<span class="sd">                If not specified, all matrix entries are allowed to be nonzero.</span>
-<span class="sd">                This list should contain only upper trianglular indices, i.e.,</span>
-<span class="sd">                pairs :math:`(i, j)` where :math:`i \leq j`. Passing a list with</span>
-<span class="sd">                lower triangular indices will raise an error.</span>
-<span class="sd">            with_final_orbital_rotation: Whether to include a final orbital rotation</span>
-<span class="sd">                in the operator.</span>
-
-<span class="sd">        Returns:</span>
-<span class="sd">            The UCJ operator constructed from the given parameters.</span>
-
-<span class="sd">        Raises:</span>
-<span class="sd">            ValueError: alpha_alpha_indices contains lower triangular indices.</span>
-<span class="sd">            ValueError: alpha_beta_indices contains lower triangular indices.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">_validate_diag_coulomb_indices</span><span class="p">(</span><span class="n">alpha_alpha_indices</span><span class="p">)</span>
-        <span class="n">_validate_diag_coulomb_indices</span><span class="p">(</span><span class="n">alpha_beta_indices</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">UCJOperator</span><span class="p">(</span>
-            <span class="o">*</span><span class="n">_ucj_from_parameters</span><span class="p">(</span>
-                <span class="n">params</span><span class="p">,</span>
-                <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span>
-                <span class="n">n_reps</span><span class="o">=</span><span class="n">n_reps</span><span class="p">,</span>
-                <span class="n">alpha_alpha_indices</span><span class="o">=</span><span class="n">alpha_alpha_indices</span><span class="p">,</span>
-                <span class="n">alpha_beta_indices</span><span class="o">=</span><span class="n">alpha_beta_indices</span><span class="p">,</span>
-                <span class="n">with_final_orbital_rotation</span><span class="o">=</span><span class="n">with_final_orbital_rotation</span><span class="p">,</span>
-            <span class="p">)</span>
-        <span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="UCJOperator.to_parameters">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.UCJOperator.to_parameters">[docs]</a>
-    <span class="k">def</span> <span class="nf">to_parameters</span><span class="p">(</span>
-        <span class="bp">self</span><span class="p">,</span>
-        <span class="o">*</span><span class="p">,</span>
-        <span class="n">alpha_alpha_indices</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-        <span class="n">alpha_beta_indices</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
-<span class="w">        </span><span class="sa">r</span><span class="sd">&quot;&quot;&quot;Convert the UCJ operator to a real-valued parameter vector.</span>
-
-<span class="sd">        If `alpha_alpha_indices` or `alpha_beta_indices` is specified, the returned</span>
-<span class="sd">        parameter vector will incorporate only the diagonal Coulomb matrix entries</span>
-<span class="sd">        corresponding to the given indices, so the original operator will not be</span>
-<span class="sd">        recoverable from the parameter vector.</span>
-
-<span class="sd">        Args:</span>
-<span class="sd">            alpha_alpha_indices: Allowed indices for nonzero values of the &quot;alpha-alpha&quot;</span>
-<span class="sd">                diagonal Coulomb matrices (see the docstring of this class).</span>
-<span class="sd">                If not specified, all matrix entries are allowed to be nonzero.</span>
-<span class="sd">                This list should contain only upper trianglular indices, i.e.,</span>
-<span class="sd">                pairs :math:`(i, j)` where :math:`i \leq j`. Passing a list with</span>
-<span class="sd">                lower triangular indices will raise an error.</span>
-<span class="sd">            alpha_beta_indices: Allowed indices for nonzero values of the &quot;alpha-beta&quot;</span>
-<span class="sd">                diagonal Coulomb matrices (see the docstring of this class).</span>
-<span class="sd">                If not specified, all matrix entries are allowed to be nonzero.</span>
-<span class="sd">                This list should contain only upper trianglular indices, i.e.,</span>
-<span class="sd">                pairs :math:`(i, j)` where :math:`i \leq j`. Passing a list with</span>
-<span class="sd">                lower triangular indices will raise an error.</span>
-
-<span class="sd">        Returns:</span>
-<span class="sd">            The real-valued parameter vector.</span>
-
-<span class="sd">        Raises:</span>
-<span class="sd">            ValueError: alpha_alpha_indices contains lower triangular indices.</span>
-<span class="sd">            ValueError: alpha_beta_indices contains lower triangular indices.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">_validate_diag_coulomb_indices</span><span class="p">(</span><span class="n">alpha_alpha_indices</span><span class="p">)</span>
-        <span class="n">_validate_diag_coulomb_indices</span><span class="p">(</span><span class="n">alpha_beta_indices</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">_ucj_to_parameters</span><span class="p">(</span>
-            <span class="n">diag_coulomb_mats_alpha_alpha</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">diag_coulomb_mats_alpha_alpha</span><span class="p">,</span>
-            <span class="n">diag_coulomb_mats_alpha_beta</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">diag_coulomb_mats_alpha_beta</span><span class="p">,</span>
-            <span class="n">orbital_rotations</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">orbital_rotations</span><span class="p">,</span>
-            <span class="n">final_orbital_rotation</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span><span class="p">,</span>
-            <span class="n">alpha_alpha_indices</span><span class="o">=</span><span class="n">alpha_alpha_indices</span><span class="p">,</span>
-            <span class="n">alpha_beta_indices</span><span class="o">=</span><span class="n">alpha_beta_indices</span><span class="p">,</span>
-        <span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="UCJOperator.from_t_amplitudes">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.UCJOperator.from_t_amplitudes">[docs]</a>
-    <span class="nd">@staticmethod</span>
-    <span class="nd">@deprecated</span><span class="p">(</span><span class="s2">&quot;The UCJOperator class is deprecated. Use UCJOpSpinBalanced instead.&quot;</span><span class="p">)</span>
-    <span class="k">def</span> <span class="nf">from_t_amplitudes</span><span class="p">(</span>
-        <span class="n">t2</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span>
-        <span class="o">*</span><span class="p">,</span>
-        <span class="n">t1</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-        <span class="n">n_reps</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-        <span class="n">tol</span><span class="p">:</span> <span class="nb">float</span> <span class="o">=</span> <span class="mf">1e-8</span><span class="p">,</span>
-    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">UCJOperator</span><span class="p">:</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Initialize the UCJ operator from t2 (and optionally t1) amplitudes.&quot;&quot;&quot;</span>
-        <span class="n">nocc</span><span class="p">,</span> <span class="n">_</span><span class="p">,</span> <span class="n">nvrt</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">t2</span><span class="o">.</span><span class="n">shape</span>
-        <span class="n">norb</span> <span class="o">=</span> <span class="n">nocc</span> <span class="o">+</span> <span class="n">nvrt</span>
-
-        <span class="n">diag_coulomb_mats</span><span class="p">,</span> <span class="n">orbital_rotations</span> <span class="o">=</span> <span class="n">double_factorized_t2</span><span class="p">(</span><span class="n">t2</span><span class="p">,</span> <span class="n">tol</span><span class="o">=</span><span class="n">tol</span><span class="p">)</span>
-        <span class="n">diag_coulomb_mats</span> <span class="o">=</span> <span class="n">diag_coulomb_mats</span><span class="o">.</span><span class="n">reshape</span><span class="p">(</span><span class="o">-</span><span class="mi">1</span><span class="p">,</span> <span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">)[:</span><span class="n">n_reps</span><span class="p">]</span>
-        <span class="n">orbital_rotations</span> <span class="o">=</span> <span class="n">orbital_rotations</span><span class="o">.</span><span class="n">reshape</span><span class="p">(</span><span class="o">-</span><span class="mi">1</span><span class="p">,</span> <span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">)[:</span><span class="n">n_reps</span><span class="p">]</span>
-
-        <span class="n">final_orbital_rotation</span> <span class="o">=</span> <span class="kc">None</span>
-        <span class="k">if</span> <span class="n">t1</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">final_orbital_rotation_generator</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">complex</span><span class="p">)</span>
-            <span class="n">final_orbital_rotation_generator</span><span class="p">[:</span><span class="n">nocc</span><span class="p">,</span> <span class="n">nocc</span><span class="p">:]</span> <span class="o">=</span> <span class="n">t1</span>
-            <span class="n">final_orbital_rotation_generator</span><span class="p">[</span><span class="n">nocc</span><span class="p">:,</span> <span class="p">:</span><span class="n">nocc</span><span class="p">]</span> <span class="o">=</span> <span class="o">-</span><span class="n">t1</span><span class="o">.</span><span class="n">T</span>
-            <span class="n">final_orbital_rotation</span> <span class="o">=</span> <span class="n">scipy</span><span class="o">.</span><span class="n">linalg</span><span class="o">.</span><span class="n">expm</span><span class="p">(</span><span class="n">final_orbital_rotation_generator</span><span class="p">)</span>
-
-        <span class="k">return</span> <span class="n">UCJOperator</span><span class="p">(</span>
-            <span class="n">diag_coulomb_mats_alpha_alpha</span><span class="o">=</span><span class="n">diag_coulomb_mats</span><span class="p">,</span>
-            <span class="n">diag_coulomb_mats_alpha_beta</span><span class="o">=</span><span class="n">diag_coulomb_mats</span><span class="p">,</span>
-            <span class="n">orbital_rotations</span><span class="o">=</span><span class="n">orbital_rotations</span><span class="p">,</span>
-            <span class="n">final_orbital_rotation</span><span class="o">=</span><span class="n">final_orbital_rotation</span><span class="p">,</span>
-        <span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="UCJOperator.to_t_amplitudes">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.UCJOperator.to_t_amplitudes">[docs]</a>
-    <span class="k">def</span> <span class="nf">to_t_amplitudes</span><span class="p">(</span>
-        <span class="bp">self</span><span class="p">,</span> <span class="n">nocc</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">]:</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Convert the UCJ operator to t2 (and possibly t1) amplitudes.&quot;&quot;&quot;</span>
-        <span class="n">t2</span> <span class="o">=</span> <span class="p">(</span>
-            <span class="mi">1</span><span class="n">j</span>
-            <span class="o">*</span> <span class="n">contract</span><span class="p">(</span>
-                <span class="s2">&quot;kpq,kap,kip,kbq,kjq-&gt;ijab&quot;</span><span class="p">,</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">diag_coulomb_mats_alpha_alpha</span><span class="p">,</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">orbital_rotations</span><span class="p">,</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">orbital_rotations</span><span class="o">.</span><span class="n">conj</span><span class="p">(),</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">orbital_rotations</span><span class="p">,</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">orbital_rotations</span><span class="o">.</span><span class="n">conj</span><span class="p">(),</span>
-                <span class="n">optimize</span><span class="o">=</span><span class="s2">&quot;greedy&quot;</span><span class="p">,</span>
-            <span class="p">)[:</span><span class="n">nocc</span><span class="p">,</span> <span class="p">:</span><span class="n">nocc</span><span class="p">,</span> <span class="n">nocc</span><span class="p">:,</span> <span class="n">nocc</span><span class="p">:]</span>
-        <span class="p">)</span>
-
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">t2</span>
-
-        <span class="n">t1</span> <span class="o">=</span> <span class="n">scipy</span><span class="o">.</span><span class="n">linalg</span><span class="o">.</span><span class="n">logm</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span><span class="p">)[:</span><span class="n">nocc</span><span class="p">,</span> <span class="n">nocc</span><span class="p">:]</span>
-        <span class="k">return</span> <span class="n">t2</span><span class="p">,</span> <span class="n">t1</span></div>
-
-
-    <span class="k">def</span> <span class="nf">_apply_unitary_</span><span class="p">(</span>
-        <span class="bp">self</span><span class="p">,</span> <span class="n">vec</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">nelec</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">],</span> <span class="n">copy</span><span class="p">:</span> <span class="nb">bool</span>
-    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Apply the operator to a vector.&quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">nelec</span><span class="p">,</span> <span class="nb">int</span><span class="p">):</span>
-            <span class="k">return</span> <span class="bp">NotImplemented</span>
-        <span class="k">if</span> <span class="n">copy</span><span class="p">:</span>
-            <span class="n">vec</span> <span class="o">=</span> <span class="n">vec</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
-        <span class="k">for</span> <span class="n">mat</span><span class="p">,</span> <span class="n">mat_alpha_beta</span><span class="p">,</span> <span class="n">orbital_rotation</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">diag_coulomb_mats_alpha_alpha</span><span class="p">,</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">diag_coulomb_mats_alpha_beta</span><span class="p">,</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">orbital_rotations</span><span class="p">,</span>
-        <span class="p">):</span>
-            <span class="n">vec</span> <span class="o">=</span> <span class="n">apply_diag_coulomb_evolution</span><span class="p">(</span>
-                <span class="n">vec</span><span class="p">,</span>
-                <span class="n">mat</span><span class="o">=</span><span class="p">(</span><span class="n">mat</span><span class="p">,</span> <span class="n">mat_alpha_beta</span><span class="p">,</span> <span class="n">mat</span><span class="p">),</span>
-                <span class="n">time</span><span class="o">=-</span><span class="mf">1.0</span><span class="p">,</span>
-                <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span>
-                <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">,</span>
-                <span class="n">orbital_rotation</span><span class="o">=</span><span class="n">orbital_rotation</span><span class="p">,</span>
-                <span class="n">copy</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
-            <span class="p">)</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">vec</span> <span class="o">=</span> <span class="n">apply_orbital_rotation</span><span class="p">(</span>
-                <span class="n">vec</span><span class="p">,</span>
-                <span class="n">mat</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span><span class="p">,</span>
-                <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span>
-                <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">,</span>
-                <span class="n">copy</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
-            <span class="p">)</span>
-        <span class="k">return</span> <span class="n">vec</span></div>
-
-
-
-<div class="viewcode-block" id="RealUCJOperator">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.RealUCJOperator">[docs]</a>
-<span class="nd">@dataclass</span>
-<span class="nd">@deprecated</span><span class="p">(</span><span class="s2">&quot;The RealUCJOperator class is deprecated. Use UCJOpSpinBalanced instead.&quot;</span><span class="p">)</span>
-<span class="k">class</span> <span class="nc">RealUCJOperator</span><span class="p">:</span>
-<span class="w">    </span><span class="sa">r</span><span class="sd">&quot;&quot;&quot;Real-valued unitary cluster Jastrow operator.</span>
-
-<span class="sd">    .. warning::</span>
-<span class="sd">        The RealUCJOperator class is deprecated. Use :class:`ffsim.UCJOpSpinBalanced`</span>
-<span class="sd">        instead.</span>
-
-<span class="sd">    A real-valued unitary cluster Jastrow (UCJ) operator has the form</span>
-
-<span class="sd">    .. math::</span>
-
-<span class="sd">        \prod_{k = 1}^L</span>
-<span class="sd">        \mathcal{W_k^*} e^{i \mathcal{-J}_k} \mathcal{W_k}^T</span>
-<span class="sd">        \mathcal{W_k} e^{i \mathcal{J}_k} \mathcal{W_k^\dagger}</span>
-
-<span class="sd">    where each :math:`\mathcal{W_k}` is an orbital rotation and each :math:`\mathcal{J}`</span>
-<span class="sd">    is a diagonal Coulomb operator of the form</span>
-
-<span class="sd">    .. math::</span>
-
-<span class="sd">        \mathcal{J} = \frac12\sum_{ij,\sigma \tau}</span>
-<span class="sd">        \mathbf{J}^{\sigma \tau}_{ij} n_{i,\sigma} n_{j,\tau}.</span>
-
-<span class="sd">    In order that the operator commutes with the total spin Z operator, we enforce that</span>
-<span class="sd">    :math:`\mathbf{J}^{\alpha\alpha} = \mathbf{J}^{\beta\beta}` and</span>
-<span class="sd">    :math:`\mathbf{J}^{\alpha\beta} = \mathbf{J}^{\beta\alpha}`. As a result, we have</span>
-<span class="sd">    two sets of matrices for describing the diagonal Coulomb operators:</span>
-<span class="sd">    &quot;alpha-alpha&quot; matrices containing coefficients for terms involving the same spin,</span>
-<span class="sd">    and &quot;alpha-beta&quot; matrices containing coefficients for terms involving different</span>
-<span class="sd">    spins.</span>
-
-<span class="sd">    To support variational optimization of the orbital basis, an optional final</span>
-<span class="sd">    orbital rotation can be included in the operator, to be performed at the end.</span>
-
-<span class="sd">    Attributes:</span>
-<span class="sd">        diag_coulomb_mats_alpha_alpha: The &quot;alpha-alpha&quot; diagonal Coulomb matrices.</span>
-<span class="sd">        diag_coulomb_mats_alpha_beta: The &quot;alpha-beta&quot; diagonal Coulomb matrices.</span>
-<span class="sd">        orbital_rotations: The orbital rotations.</span>
-<span class="sd">        final_orbital_rotation: The optional final orbital rotation.</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-
-    <span class="n">diag_coulomb_mats_alpha_alpha</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span>
-    <span class="n">diag_coulomb_mats_alpha_beta</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span>
-    <span class="n">orbital_rotations</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span>
-    <span class="n">final_orbital_rotation</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">norb</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;The number of spatial orbitals.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">diag_coulomb_mats_alpha_alpha</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span>
-
-    <span class="nd">@property</span>
-    <span class="k">def</span> <span class="nf">n_reps</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;The number of ansatz repetitions.&quot;&quot;&quot;</span>
-        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">diag_coulomb_mats_alpha_alpha</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
-
-<div class="viewcode-block" id="RealUCJOperator.n_params">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.RealUCJOperator.n_params">[docs]</a>
-    <span class="nd">@staticmethod</span>
-    <span class="k">def</span> <span class="nf">n_params</span><span class="p">(</span>
-        <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-        <span class="n">n_reps</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-        <span class="o">*</span><span class="p">,</span>
-        <span class="n">alpha_alpha_indices</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-        <span class="n">alpha_beta_indices</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-        <span class="n">with_final_orbital_rotation</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">int</span><span class="p">:</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Return the number of parameters of an ansatz with given settings.&quot;&quot;&quot;</span>
-        <span class="n">n_params_aa</span> <span class="o">=</span> <span class="p">(</span>
-            <span class="n">norb</span> <span class="o">*</span> <span class="p">(</span><span class="n">norb</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">//</span> <span class="mi">2</span>
-            <span class="k">if</span> <span class="n">alpha_alpha_indices</span> <span class="ow">is</span> <span class="kc">None</span>
-            <span class="k">else</span> <span class="nb">len</span><span class="p">(</span><span class="n">alpha_alpha_indices</span><span class="p">)</span>
-        <span class="p">)</span>
-        <span class="n">n_params_ab</span> <span class="o">=</span> <span class="p">(</span>
-            <span class="n">norb</span> <span class="o">*</span> <span class="p">(</span><span class="n">norb</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">//</span> <span class="mi">2</span>
-            <span class="k">if</span> <span class="n">alpha_beta_indices</span> <span class="ow">is</span> <span class="kc">None</span>
-            <span class="k">else</span> <span class="nb">len</span><span class="p">(</span><span class="n">alpha_beta_indices</span><span class="p">)</span>
-        <span class="p">)</span>
-        <span class="k">return</span> <span class="p">(</span>
-            <span class="n">n_reps</span> <span class="o">*</span> <span class="p">(</span><span class="n">norb</span><span class="o">**</span><span class="mi">2</span> <span class="o">+</span> <span class="n">n_params_aa</span> <span class="o">+</span> <span class="n">n_params_ab</span><span class="p">)</span>
-            <span class="o">+</span> <span class="n">with_final_orbital_rotation</span> <span class="o">*</span> <span class="n">norb</span><span class="o">**</span><span class="mi">2</span>
-        <span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="RealUCJOperator.from_parameters">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.RealUCJOperator.from_parameters">[docs]</a>
-    <span class="nd">@staticmethod</span>
-    <span class="nd">@deprecated</span><span class="p">(</span>
-        <span class="s2">&quot;The RealUCJOperator class is deprecated. Use UCJOpSpinBalanced instead.&quot;</span>
-    <span class="p">)</span>
-    <span class="k">def</span> <span class="nf">from_parameters</span><span class="p">(</span>
-        <span class="n">params</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span>
-        <span class="o">*</span><span class="p">,</span>
-        <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-        <span class="n">n_reps</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-        <span class="n">alpha_alpha_indices</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-        <span class="n">alpha_beta_indices</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-        <span class="n">with_final_orbital_rotation</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-    <span class="p">)</span> <span class="o">-&gt;</span> <span class="s2">&quot;RealUCJOperator&quot;</span><span class="p">:</span>
-<span class="w">        </span><span class="sa">r</span><span class="sd">&quot;&quot;&quot;Initialize the real UCJ operator from a real-valued parameter vector.</span>
-
-<span class="sd">        Args:</span>
-<span class="sd">            params: The real-valued parameter vector.</span>
-<span class="sd">            norb: The number of spatial orbitals.</span>
-<span class="sd">            n_reps: The number of ansatz repetitions (:math:`L` from the docstring of</span>
-<span class="sd">                this class).</span>
-<span class="sd">            alpha_alpha_indices: Allowed indices for nonzero values of the &quot;alpha-alpha&quot;</span>
-<span class="sd">                diagonal Coulomb matrices (see the docstring of this class).</span>
-<span class="sd">                If not specified, all matrix entries are allowed to be nonzero.</span>
-<span class="sd">                This list should contain only upper trianglular indices, i.e.,</span>
-<span class="sd">                pairs :math:`(i, j)` where :math:`i \leq j`. Passing a list with</span>
-<span class="sd">                lower triangular indices will raise an error.</span>
-<span class="sd">            alpha_beta_indices: Allowed indices for nonzero values of the &quot;alpha-beta&quot;</span>
-<span class="sd">                diagonal Coulomb matrices (see the docstring of this class).</span>
-<span class="sd">                If not specified, all matrix entries are allowed to be nonzero.</span>
-<span class="sd">                This list should contain only upper trianglular indices, i.e.,</span>
-<span class="sd">                pairs :math:`(i, j)` where :math:`i \leq j`. Passing a list with</span>
-<span class="sd">                lower triangular indices will raise an error.</span>
-<span class="sd">            with_final_orbital_rotation: Whether to include a final orbital rotation</span>
-<span class="sd">                in the operator.</span>
-
-<span class="sd">        Returns:</span>
-<span class="sd">            The real UCJ operator constructed from the given parameters.</span>
-
-<span class="sd">        Raises:</span>
-<span class="sd">            ValueError: alpha_alpha_indices contains lower triangular indices.</span>
-<span class="sd">            ValueError: alpha_beta_indices contains lower triangular indices.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">_validate_diag_coulomb_indices</span><span class="p">(</span><span class="n">alpha_alpha_indices</span><span class="p">)</span>
-        <span class="n">_validate_diag_coulomb_indices</span><span class="p">(</span><span class="n">alpha_beta_indices</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">RealUCJOperator</span><span class="p">(</span>
-            <span class="o">*</span><span class="n">_ucj_from_parameters</span><span class="p">(</span>
-                <span class="n">params</span><span class="p">,</span>
-                <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span>
-                <span class="n">n_reps</span><span class="o">=</span><span class="n">n_reps</span><span class="p">,</span>
-                <span class="n">alpha_alpha_indices</span><span class="o">=</span><span class="n">alpha_alpha_indices</span><span class="p">,</span>
-                <span class="n">alpha_beta_indices</span><span class="o">=</span><span class="n">alpha_beta_indices</span><span class="p">,</span>
-                <span class="n">with_final_orbital_rotation</span><span class="o">=</span><span class="n">with_final_orbital_rotation</span><span class="p">,</span>
-            <span class="p">)</span>
-        <span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="RealUCJOperator.to_parameters">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.RealUCJOperator.to_parameters">[docs]</a>
-    <span class="k">def</span> <span class="nf">to_parameters</span><span class="p">(</span>
-        <span class="bp">self</span><span class="p">,</span>
-        <span class="o">*</span><span class="p">,</span>
-        <span class="n">alpha_alpha_indices</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-        <span class="n">alpha_beta_indices</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
-<span class="w">        </span><span class="sa">r</span><span class="sd">&quot;&quot;&quot;Convert the real UCJ operator to a real-valued parameter vector.</span>
-
-<span class="sd">        If `alpha_alpha_indices` or `alpha_beta_indices` is specified, the returned</span>
-<span class="sd">        parameter vector will incorporate only the diagonal Coulomb matrix entries</span>
-<span class="sd">        corresponding to the given indices, so the original operator will not be</span>
-<span class="sd">        recoverable from the parameter vector.</span>
-
-<span class="sd">        Args:</span>
-<span class="sd">            alpha_alpha_indices: Allowed indices for nonzero values of the &quot;alpha-alpha&quot;</span>
-<span class="sd">                diagonal Coulomb matrices (see the docstring of this class).</span>
-<span class="sd">                If not specified, all matrix entries are allowed to be nonzero.</span>
-<span class="sd">                This list should contain only upper trianglular indices, i.e.,</span>
-<span class="sd">                pairs :math:`(i, j)` where :math:`i \leq j`. Passing a list with</span>
-<span class="sd">                lower triangular indices will raise an error.</span>
-<span class="sd">            alpha_beta_indices: Allowed indices for nonzero values of the &quot;alpha-beta&quot;</span>
-<span class="sd">                diagonal Coulomb matrices (see the docstring of this class).</span>
-<span class="sd">                If not specified, all matrix entries are allowed to be nonzero.</span>
-<span class="sd">                This list should contain only upper trianglular indices, i.e.,</span>
-<span class="sd">                pairs :math:`(i, j)` where :math:`i \leq j`. Passing a list with</span>
-<span class="sd">                lower triangular indices will raise an error.</span>
-
-<span class="sd">        Returns:</span>
-<span class="sd">            The real-valued parameter vector.</span>
-
-<span class="sd">        Raises:</span>
-<span class="sd">            ValueError: alpha_alpha_indices contains lower triangular indices.</span>
-<span class="sd">            ValueError: alpha_beta_indices contains lower triangular indices.</span>
-<span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">_validate_diag_coulomb_indices</span><span class="p">(</span><span class="n">alpha_alpha_indices</span><span class="p">)</span>
-        <span class="n">_validate_diag_coulomb_indices</span><span class="p">(</span><span class="n">alpha_beta_indices</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">_ucj_to_parameters</span><span class="p">(</span>
-            <span class="n">diag_coulomb_mats_alpha_alpha</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">diag_coulomb_mats_alpha_alpha</span><span class="p">,</span>
-            <span class="n">diag_coulomb_mats_alpha_beta</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">diag_coulomb_mats_alpha_beta</span><span class="p">,</span>
-            <span class="n">orbital_rotations</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">orbital_rotations</span><span class="p">,</span>
-            <span class="n">final_orbital_rotation</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span><span class="p">,</span>
-            <span class="n">alpha_alpha_indices</span><span class="o">=</span><span class="n">alpha_alpha_indices</span><span class="p">,</span>
-            <span class="n">alpha_beta_indices</span><span class="o">=</span><span class="n">alpha_beta_indices</span><span class="p">,</span>
-        <span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="RealUCJOperator.from_t_amplitudes">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.RealUCJOperator.from_t_amplitudes">[docs]</a>
-    <span class="nd">@staticmethod</span>
-    <span class="nd">@deprecated</span><span class="p">(</span>
-        <span class="s2">&quot;The RealUCJOperator class is deprecated. Use UCJOpSpinBalanced instead.&quot;</span>
-    <span class="p">)</span>
-    <span class="k">def</span> <span class="nf">from_t_amplitudes</span><span class="p">(</span>
-        <span class="n">t2</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span>
-        <span class="o">*</span><span class="p">,</span>
-        <span class="n">t1</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-        <span class="n">n_reps</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-        <span class="n">tol</span><span class="p">:</span> <span class="nb">float</span> <span class="o">=</span> <span class="mf">1e-8</span><span class="p">,</span>
-    <span class="p">)</span> <span class="o">-&gt;</span> <span class="s2">&quot;RealUCJOperator&quot;</span><span class="p">:</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Initialize the real UCJ operator from t2 (and optionally t1) amplitudes.&quot;&quot;&quot;</span>
-        <span class="n">nocc</span><span class="p">,</span> <span class="n">_</span><span class="p">,</span> <span class="n">nvrt</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">t2</span><span class="o">.</span><span class="n">shape</span>
-        <span class="n">norb</span> <span class="o">=</span> <span class="n">nocc</span> <span class="o">+</span> <span class="n">nvrt</span>
-
-        <span class="n">diag_coulomb_mats</span><span class="p">,</span> <span class="n">orbital_rotations</span> <span class="o">=</span> <span class="n">double_factorized_t2</span><span class="p">(</span><span class="n">t2</span><span class="p">,</span> <span class="n">tol</span><span class="o">=</span><span class="n">tol</span><span class="p">)</span>
-        <span class="n">diag_coulomb_mats</span> <span class="o">=</span> <span class="n">diag_coulomb_mats</span><span class="p">[:</span><span class="n">n_reps</span><span class="p">,</span> <span class="mi">0</span><span class="p">]</span>
-        <span class="n">orbital_rotations</span> <span class="o">=</span> <span class="n">orbital_rotations</span><span class="p">[:</span><span class="n">n_reps</span><span class="p">,</span> <span class="mi">0</span><span class="p">]</span>
-
-        <span class="n">final_orbital_rotation</span> <span class="o">=</span> <span class="kc">None</span>
-        <span class="k">if</span> <span class="n">t1</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">final_orbital_rotation_generator</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">complex</span><span class="p">)</span>
-            <span class="n">final_orbital_rotation_generator</span><span class="p">[:</span><span class="n">nocc</span><span class="p">,</span> <span class="n">nocc</span><span class="p">:]</span> <span class="o">=</span> <span class="n">t1</span>
-            <span class="n">final_orbital_rotation_generator</span><span class="p">[</span><span class="n">nocc</span><span class="p">:,</span> <span class="p">:</span><span class="n">nocc</span><span class="p">]</span> <span class="o">=</span> <span class="o">-</span><span class="n">t1</span><span class="o">.</span><span class="n">T</span>
-            <span class="n">final_orbital_rotation</span> <span class="o">=</span> <span class="n">scipy</span><span class="o">.</span><span class="n">linalg</span><span class="o">.</span><span class="n">expm</span><span class="p">(</span><span class="n">final_orbital_rotation_generator</span><span class="p">)</span>
-
-        <span class="k">return</span> <span class="n">RealUCJOperator</span><span class="p">(</span>
-            <span class="n">diag_coulomb_mats_alpha_alpha</span><span class="o">=</span><span class="n">diag_coulomb_mats</span><span class="p">,</span>
-            <span class="n">diag_coulomb_mats_alpha_beta</span><span class="o">=</span><span class="n">diag_coulomb_mats</span><span class="p">,</span>
-            <span class="n">orbital_rotations</span><span class="o">=</span><span class="n">orbital_rotations</span><span class="p">,</span>
-            <span class="n">final_orbital_rotation</span><span class="o">=</span><span class="n">final_orbital_rotation</span><span class="p">,</span>
-        <span class="p">)</span></div>
-
-
-<div class="viewcode-block" id="RealUCJOperator.to_t_amplitudes">
-<a class="viewcode-back" href="../../../api/ffsim.html#ffsim.RealUCJOperator.to_t_amplitudes">[docs]</a>
-    <span class="k">def</span> <span class="nf">to_t_amplitudes</span><span class="p">(</span>
-        <span class="bp">self</span><span class="p">,</span> <span class="n">nocc</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">]:</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Convert the UCJ operator to t2 (and possibly t1) amplitudes.&quot;&quot;&quot;</span>
-        <span class="n">t2</span> <span class="o">=</span> <span class="mi">1</span><span class="n">j</span> <span class="o">*</span> <span class="p">(</span>
-            <span class="n">contract</span><span class="p">(</span>
-                <span class="s2">&quot;kpq,kap,kip,kbq,kjq-&gt;ijab&quot;</span><span class="p">,</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">diag_coulomb_mats_alpha_alpha</span><span class="p">,</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">orbital_rotations</span><span class="p">,</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">orbital_rotations</span><span class="o">.</span><span class="n">conj</span><span class="p">(),</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">orbital_rotations</span><span class="p">,</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">orbital_rotations</span><span class="o">.</span><span class="n">conj</span><span class="p">(),</span>
-                <span class="n">optimize</span><span class="o">=</span><span class="s2">&quot;greedy&quot;</span><span class="p">,</span>
-            <span class="p">)[:</span><span class="n">nocc</span><span class="p">,</span> <span class="p">:</span><span class="n">nocc</span><span class="p">,</span> <span class="n">nocc</span><span class="p">:,</span> <span class="n">nocc</span><span class="p">:]</span>
-            <span class="o">+</span> <span class="n">contract</span><span class="p">(</span>
-                <span class="s2">&quot;kpq,kap,kip,kbq,kjq-&gt;ijab&quot;</span><span class="p">,</span>
-                <span class="o">-</span><span class="bp">self</span><span class="o">.</span><span class="n">diag_coulomb_mats_alpha_alpha</span><span class="p">,</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">orbital_rotations</span><span class="o">.</span><span class="n">conj</span><span class="p">(),</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">orbital_rotations</span><span class="p">,</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">orbital_rotations</span><span class="o">.</span><span class="n">conj</span><span class="p">(),</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">orbital_rotations</span><span class="p">,</span>
-                <span class="n">optimize</span><span class="o">=</span><span class="s2">&quot;greedy&quot;</span><span class="p">,</span>
-            <span class="p">)[:</span><span class="n">nocc</span><span class="p">,</span> <span class="p">:</span><span class="n">nocc</span><span class="p">,</span> <span class="n">nocc</span><span class="p">:,</span> <span class="n">nocc</span><span class="p">:]</span>
-        <span class="p">)</span>
-
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="k">return</span> <span class="n">t2</span>
-
-        <span class="n">t1</span> <span class="o">=</span> <span class="n">scipy</span><span class="o">.</span><span class="n">linalg</span><span class="o">.</span><span class="n">logm</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span><span class="p">)[:</span><span class="n">nocc</span><span class="p">,</span> <span class="n">nocc</span><span class="p">:]</span>
-        <span class="k">return</span> <span class="n">t2</span><span class="p">,</span> <span class="n">t1</span></div>
-
-
-    <span class="k">def</span> <span class="nf">_apply_unitary_</span><span class="p">(</span>
-        <span class="bp">self</span><span class="p">,</span> <span class="n">vec</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">nelec</span><span class="p">:</span> <span class="nb">int</span> <span class="o">|</span> <span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">],</span> <span class="n">copy</span><span class="p">:</span> <span class="nb">bool</span>
-    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Apply the operator to a vector.&quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">nelec</span><span class="p">,</span> <span class="nb">int</span><span class="p">):</span>
-            <span class="k">return</span> <span class="bp">NotImplemented</span>
-        <span class="k">if</span> <span class="n">copy</span><span class="p">:</span>
-            <span class="n">vec</span> <span class="o">=</span> <span class="n">vec</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
-        <span class="k">for</span> <span class="n">mat</span><span class="p">,</span> <span class="n">mat_alpha_beta</span><span class="p">,</span> <span class="n">orbital_rotation</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">diag_coulomb_mats_alpha_alpha</span><span class="p">,</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">diag_coulomb_mats_alpha_beta</span><span class="p">,</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">orbital_rotations</span><span class="p">,</span>
-        <span class="p">):</span>
-            <span class="n">vec</span> <span class="o">=</span> <span class="n">apply_diag_coulomb_evolution</span><span class="p">(</span>
-                <span class="n">vec</span><span class="p">,</span>
-                <span class="n">mat</span><span class="o">=</span><span class="p">(</span><span class="n">mat</span><span class="p">,</span> <span class="n">mat_alpha_beta</span><span class="p">,</span> <span class="n">mat</span><span class="p">),</span>
-                <span class="n">time</span><span class="o">=-</span><span class="mf">1.0</span><span class="p">,</span>
-                <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span>
-                <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">,</span>
-                <span class="n">orbital_rotation</span><span class="o">=</span><span class="n">orbital_rotation</span><span class="p">,</span>
-                <span class="n">copy</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
-            <span class="p">)</span>
-            <span class="n">vec</span> <span class="o">=</span> <span class="n">apply_diag_coulomb_evolution</span><span class="p">(</span>
-                <span class="n">vec</span><span class="p">,</span>
-                <span class="n">mat</span><span class="o">=</span><span class="p">(</span><span class="o">-</span><span class="n">mat</span><span class="p">,</span> <span class="o">-</span><span class="n">mat_alpha_beta</span><span class="p">,</span> <span class="o">-</span><span class="n">mat</span><span class="p">),</span>
-                <span class="n">time</span><span class="o">=-</span><span class="mf">1.0</span><span class="p">,</span>
-                <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span>
-                <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">,</span>
-                <span class="n">orbital_rotation</span><span class="o">=</span><span class="n">orbital_rotation</span><span class="o">.</span><span class="n">conj</span><span class="p">(),</span>
-                <span class="n">copy</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
-            <span class="p">)</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-            <span class="n">vec</span> <span class="o">=</span> <span class="n">apply_orbital_rotation</span><span class="p">(</span>
-                <span class="n">vec</span><span class="p">,</span>
-                <span class="n">mat</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">final_orbital_rotation</span><span class="p">,</span>
-                <span class="n">norb</span><span class="o">=</span><span class="n">norb</span><span class="p">,</span>
-                <span class="n">nelec</span><span class="o">=</span><span class="n">nelec</span><span class="p">,</span>
-                <span class="n">copy</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
-            <span class="p">)</span>
-        <span class="k">return</span> <span class="n">vec</span></div>
-
-
-
-<span class="k">def</span> <span class="nf">_ucj_from_parameters</span><span class="p">(</span>
-    <span class="n">params</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span>
-    <span class="o">*</span><span class="p">,</span>
-    <span class="n">norb</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-    <span class="n">n_reps</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-    <span class="n">alpha_alpha_indices</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-    <span class="n">alpha_beta_indices</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-    <span class="n">with_final_orbital_rotation</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-<span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span><span class="p">]:</span>
-    <span class="n">triu_indices</span> <span class="o">=</span> <span class="n">cast</span><span class="p">(</span>
-        <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]],</span>
-        <span class="nb">list</span><span class="p">(</span><span class="n">itertools</span><span class="o">.</span><span class="n">combinations_with_replacement</span><span class="p">(</span><span class="nb">range</span><span class="p">(</span><span class="n">norb</span><span class="p">),</span> <span class="mi">2</span><span class="p">)),</span>
-    <span class="p">)</span>
-    <span class="k">if</span> <span class="n">alpha_alpha_indices</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">alpha_alpha_indices</span> <span class="o">=</span> <span class="n">triu_indices</span>
-    <span class="k">if</span> <span class="n">alpha_beta_indices</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">alpha_beta_indices</span> <span class="o">=</span> <span class="n">triu_indices</span>
-    <span class="n">diag_coulomb_mats_alpha_alpha</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">n_reps</span><span class="p">,</span> <span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">))</span>
-    <span class="n">diag_coulomb_mats_alpha_beta</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">n_reps</span><span class="p">,</span> <span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">))</span>
-    <span class="n">orbital_rotations</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">n_reps</span><span class="p">,</span> <span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">complex</span><span class="p">)</span>
-    <span class="n">index</span> <span class="o">=</span> <span class="mi">0</span>
-    <span class="k">for</span> <span class="p">(</span>
-        <span class="n">orbital_rotation</span><span class="p">,</span>
-        <span class="n">diag_coulomb_mat_alpha_alpha</span><span class="p">,</span>
-        <span class="n">diag_coulomb_mat_alpha_beta</span><span class="p">,</span>
-    <span class="p">)</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span>
-        <span class="n">orbital_rotations</span><span class="p">,</span>
-        <span class="n">diag_coulomb_mats_alpha_alpha</span><span class="p">,</span>
-        <span class="n">diag_coulomb_mats_alpha_beta</span><span class="p">,</span>
-    <span class="p">):</span>
-        <span class="c1"># orbital rotation</span>
-        <span class="n">n_params</span> <span class="o">=</span> <span class="n">norb</span><span class="o">**</span><span class="mi">2</span>
-        <span class="n">orbital_rotation</span><span class="p">[:]</span> <span class="o">=</span> <span class="n">orbital_rotation_from_parameters</span><span class="p">(</span>
-            <span class="n">params</span><span class="p">[</span><span class="n">index</span> <span class="p">:</span> <span class="n">index</span> <span class="o">+</span> <span class="n">n_params</span><span class="p">],</span> <span class="n">norb</span>
-        <span class="p">)</span>
-        <span class="n">index</span> <span class="o">+=</span> <span class="n">n_params</span>
-        <span class="c1"># diag coulomb matrix, alpha-alpha</span>
-        <span class="k">if</span> <span class="n">alpha_alpha_indices</span><span class="p">:</span>
-            <span class="n">n_params</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">alpha_alpha_indices</span><span class="p">)</span>
-            <span class="n">rows</span><span class="p">,</span> <span class="n">cols</span> <span class="o">=</span> <span class="nb">zip</span><span class="p">(</span><span class="o">*</span><span class="n">alpha_alpha_indices</span><span class="p">)</span>
-            <span class="n">vals</span> <span class="o">=</span> <span class="n">params</span><span class="p">[</span><span class="n">index</span> <span class="p">:</span> <span class="n">index</span> <span class="o">+</span> <span class="n">n_params</span><span class="p">]</span>
-            <span class="n">diag_coulomb_mat_alpha_alpha</span><span class="p">[</span><span class="n">rows</span><span class="p">,</span> <span class="n">cols</span><span class="p">]</span> <span class="o">=</span> <span class="n">vals</span>
-            <span class="n">diag_coulomb_mat_alpha_alpha</span><span class="p">[</span><span class="n">cols</span><span class="p">,</span> <span class="n">rows</span><span class="p">]</span> <span class="o">=</span> <span class="n">vals</span>
-            <span class="n">index</span> <span class="o">+=</span> <span class="n">n_params</span>
-        <span class="c1"># diag coulomb matrix, alpha-beta</span>
-        <span class="k">if</span> <span class="n">alpha_beta_indices</span><span class="p">:</span>
-            <span class="n">n_params</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">alpha_beta_indices</span><span class="p">)</span>
-            <span class="n">rows</span><span class="p">,</span> <span class="n">cols</span> <span class="o">=</span> <span class="nb">zip</span><span class="p">(</span><span class="o">*</span><span class="n">alpha_beta_indices</span><span class="p">)</span>
-            <span class="n">vals</span> <span class="o">=</span> <span class="n">params</span><span class="p">[</span><span class="n">index</span> <span class="p">:</span> <span class="n">index</span> <span class="o">+</span> <span class="n">n_params</span><span class="p">]</span>
-            <span class="n">diag_coulomb_mat_alpha_beta</span><span class="p">[</span><span class="n">rows</span><span class="p">,</span> <span class="n">cols</span><span class="p">]</span> <span class="o">=</span> <span class="n">vals</span>
-            <span class="n">diag_coulomb_mat_alpha_beta</span><span class="p">[</span><span class="n">cols</span><span class="p">,</span> <span class="n">rows</span><span class="p">]</span> <span class="o">=</span> <span class="n">vals</span>
-            <span class="n">index</span> <span class="o">+=</span> <span class="n">n_params</span>
-    <span class="c1"># final orbital rotation</span>
-    <span class="n">final_orbital_rotation</span> <span class="o">=</span> <span class="kc">None</span>
-    <span class="k">if</span> <span class="n">with_final_orbital_rotation</span><span class="p">:</span>
-        <span class="n">final_orbital_rotation</span> <span class="o">=</span> <span class="n">orbital_rotation_from_parameters</span><span class="p">(</span><span class="n">params</span><span class="p">[</span><span class="n">index</span><span class="p">:],</span> <span class="n">norb</span><span class="p">)</span>
-    <span class="k">return</span> <span class="p">(</span>
-        <span class="n">diag_coulomb_mats_alpha_alpha</span><span class="p">,</span>
-        <span class="n">diag_coulomb_mats_alpha_beta</span><span class="p">,</span>
-        <span class="n">orbital_rotations</span><span class="p">,</span>
-        <span class="n">final_orbital_rotation</span><span class="p">,</span>
-    <span class="p">)</span>
-
-
-<span class="k">def</span> <span class="nf">_ucj_to_parameters</span><span class="p">(</span>
-    <span class="n">diag_coulomb_mats_alpha_alpha</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span>
-    <span class="n">diag_coulomb_mats_alpha_beta</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span>
-    <span class="n">orbital_rotations</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span>
-    <span class="n">final_orbital_rotation</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-    <span class="o">*</span><span class="p">,</span>
-    <span class="n">alpha_alpha_indices</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-    <span class="n">alpha_beta_indices</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">:</span>
-    <span class="n">n_reps</span><span class="p">,</span> <span class="n">norb</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">diag_coulomb_mats_alpha_alpha</span><span class="o">.</span><span class="n">shape</span>
-    <span class="n">triu_indices</span> <span class="o">=</span> <span class="n">cast</span><span class="p">(</span>
-        <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]],</span>
-        <span class="nb">list</span><span class="p">(</span><span class="n">itertools</span><span class="o">.</span><span class="n">combinations_with_replacement</span><span class="p">(</span><span class="nb">range</span><span class="p">(</span><span class="n">norb</span><span class="p">),</span> <span class="mi">2</span><span class="p">)),</span>
-    <span class="p">)</span>
-    <span class="k">if</span> <span class="n">alpha_alpha_indices</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">alpha_alpha_indices</span> <span class="o">=</span> <span class="n">triu_indices</span>
-    <span class="k">if</span> <span class="n">alpha_beta_indices</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">alpha_beta_indices</span> <span class="o">=</span> <span class="n">triu_indices</span>
-    <span class="n">ntheta</span> <span class="o">=</span> <span class="n">n_reps</span> <span class="o">*</span> <span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">alpha_alpha_indices</span><span class="p">)</span> <span class="o">+</span> <span class="nb">len</span><span class="p">(</span><span class="n">alpha_beta_indices</span><span class="p">)</span> <span class="o">+</span> <span class="n">norb</span><span class="o">**</span><span class="mi">2</span><span class="p">)</span>
-    <span class="k">if</span> <span class="n">final_orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">ntheta</span> <span class="o">+=</span> <span class="n">norb</span><span class="o">**</span><span class="mi">2</span>
-    <span class="n">theta</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">(</span><span class="n">ntheta</span><span class="p">)</span>
-    <span class="n">index</span> <span class="o">=</span> <span class="mi">0</span>
-    <span class="k">for</span> <span class="p">(</span>
-        <span class="n">orbital_rotation</span><span class="p">,</span>
-        <span class="n">diag_coulomb_mat_alpha_alpha</span><span class="p">,</span>
-        <span class="n">diag_coulomb_mat_alpha_beta</span><span class="p">,</span>
-    <span class="p">)</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span>
-        <span class="n">orbital_rotations</span><span class="p">,</span>
-        <span class="n">diag_coulomb_mats_alpha_alpha</span><span class="p">,</span>
-        <span class="n">diag_coulomb_mats_alpha_beta</span><span class="p">,</span>
-    <span class="p">):</span>
-        <span class="c1"># orbital rotation</span>
-        <span class="n">n_params</span> <span class="o">=</span> <span class="n">norb</span><span class="o">**</span><span class="mi">2</span>
-        <span class="n">theta</span><span class="p">[</span><span class="n">index</span> <span class="p">:</span> <span class="n">index</span> <span class="o">+</span> <span class="n">n_params</span><span class="p">]</span> <span class="o">=</span> <span class="n">orbital_rotation_to_parameters</span><span class="p">(</span>
-            <span class="n">orbital_rotation</span>
-        <span class="p">)</span>
-        <span class="n">index</span> <span class="o">+=</span> <span class="n">n_params</span>
-        <span class="c1"># diag coulomb matrix, alpha-alpha</span>
-        <span class="k">if</span> <span class="n">alpha_alpha_indices</span><span class="p">:</span>
-            <span class="n">n_params</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">alpha_alpha_indices</span><span class="p">)</span>
-            <span class="n">theta</span><span class="p">[</span><span class="n">index</span> <span class="p">:</span> <span class="n">index</span> <span class="o">+</span> <span class="n">n_params</span><span class="p">]</span> <span class="o">=</span> <span class="n">diag_coulomb_mat_alpha_alpha</span><span class="p">[</span>
-                <span class="nb">tuple</span><span class="p">(</span><span class="nb">zip</span><span class="p">(</span><span class="o">*</span><span class="n">alpha_alpha_indices</span><span class="p">))</span>
-            <span class="p">]</span>
-            <span class="n">index</span> <span class="o">+=</span> <span class="n">n_params</span>
-        <span class="c1"># diag coulomb matrix, alpha-beta</span>
-        <span class="k">if</span> <span class="n">alpha_beta_indices</span><span class="p">:</span>
-            <span class="n">n_params</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">alpha_beta_indices</span><span class="p">)</span>
-            <span class="n">theta</span><span class="p">[</span><span class="n">index</span> <span class="p">:</span> <span class="n">index</span> <span class="o">+</span> <span class="n">n_params</span><span class="p">]</span> <span class="o">=</span> <span class="n">diag_coulomb_mat_alpha_beta</span><span class="p">[</span>
-                <span class="nb">tuple</span><span class="p">(</span><span class="nb">zip</span><span class="p">(</span><span class="o">*</span><span class="n">alpha_beta_indices</span><span class="p">))</span>
-            <span class="p">]</span>
-            <span class="n">index</span> <span class="o">+=</span> <span class="n">n_params</span>
-    <span class="c1"># final orbital rotation</span>
-    <span class="k">if</span> <span class="n">final_orbital_rotation</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="n">theta</span><span class="p">[</span><span class="n">index</span> <span class="p">:</span> <span class="n">index</span> <span class="o">+</span> <span class="n">norb</span><span class="o">**</span><span class="mi">2</span><span class="p">]</span> <span class="o">=</span> <span class="n">orbital_rotation_to_parameters</span><span class="p">(</span>
-            <span class="n">final_orbital_rotation</span>
-        <span class="p">)</span>
-    <span class="k">return</span> <span class="n">theta</span>
-</pre></div>
-        </article>
-      </div>
-      <footer>
-        
-        <div class="related-pages">
-          
-          
-        </div>
-        <div class="bottom-of-page">
-          <div class="left-details">
-            <div class="copyright">
-                Copyright &#169; 2023, IBM
-            </div>
-            Made with <a href="https://www.sphinx-doc.org/">Sphinx</a> and <a class="muted-link" href="https://pradyunsg.me">@pradyunsg</a>'s
-            
-            <a href="https://github.com/pradyunsg/furo">Furo</a>
-            
-          </div>
-          <div class="right-details">
-            
-          </div>
-        </div>
-        
-      </footer>
-    </div>
-    <aside class="toc-drawer no-toc">
-      
-      
-      
-    </aside>
-  </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
-    <script src="../../../_static/doctools.js?v=9bcbadda"></script>
-    <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
-    <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
-    <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
-    </body>
-</html>
\ No newline at end of file
diff --git a/_modules/ffsim/variational/ucj_spin_balanced.html b/_modules/ffsim/variational/ucj_spin_balanced.html
index 071e02c27..f3fd0178d 100644
--- a/_modules/ffsim/variational/ucj_spin_balanced.html
+++ b/_modules/ffsim/variational/ucj_spin_balanced.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.variational.ucj_spin_balanced - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.variational.ucj_spin_balanced - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -289,28 +289,10 @@ <h1>Source code for ffsim.variational.ucj_spin_balanced</h1><div class="highligh
 <span class="kn">from</span> <span class="nn">ffsim.variational.util</span> <span class="kn">import</span> <span class="p">(</span>
     <span class="n">orbital_rotation_from_parameters</span><span class="p">,</span>
     <span class="n">orbital_rotation_to_parameters</span><span class="p">,</span>
+    <span class="n">validate_interaction_pairs</span><span class="p">,</span>
 <span class="p">)</span>
 
 
-<span class="k">def</span> <span class="nf">_validate_interaction_pairs</span><span class="p">(</span>
-    <span class="n">interaction_pairs</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">ordered</span><span class="p">:</span> <span class="nb">bool</span>
-<span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-    <span class="k">if</span> <span class="n">interaction_pairs</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="k">return</span>
-    <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="nb">set</span><span class="p">(</span><span class="n">interaction_pairs</span><span class="p">))</span> <span class="o">!=</span> <span class="nb">len</span><span class="p">(</span><span class="n">interaction_pairs</span><span class="p">):</span>
-        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-            <span class="sa">f</span><span class="s2">&quot;Duplicate interaction pairs encountered: </span><span class="si">{</span><span class="n">interaction_pairs</span><span class="si">}</span><span class="s2">.&quot;</span>
-        <span class="p">)</span>
-    <span class="k">if</span> <span class="ow">not</span> <span class="n">ordered</span><span class="p">:</span>
-        <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">j</span> <span class="ow">in</span> <span class="n">interaction_pairs</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">i</span> <span class="o">&gt;</span> <span class="n">j</span><span class="p">:</span>
-                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-                    <span class="s2">&quot;When specifying alpha-alpha or beta-beta interaction pairs, &quot;</span>
-                    <span class="s2">&quot;you must provide only upper triangular pairs. &quot;</span>
-                    <span class="sa">f</span><span class="s2">&quot;Got </span><span class="si">{</span><span class="p">(</span><span class="n">i</span><span class="p">,</span><span class="w"> </span><span class="n">j</span><span class="p">)</span><span class="si">}</span><span class="s2">, which is a lower triangular pair.&quot;</span>
-                <span class="p">)</span>
-
-
 <div class="viewcode-block" id="UCJOpSpinBalanced">
 <a class="viewcode-back" href="../../../api/ffsim.html#ffsim.UCJOpSpinBalanced">[docs]</a>
 <span class="nd">@dataclass</span><span class="p">(</span><span class="n">frozen</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
@@ -436,6 +418,7 @@ <h1>Source code for ffsim.variational.ucj_spin_balanced</h1><div class="highligh
 <span class="w">        </span><span class="sa">r</span><span class="sd">&quot;&quot;&quot;Return the number of parameters of an ansatz with given settings.</span>
 
 <span class="sd">        Args:</span>
+<span class="sd">            norb: The number of spatial orbitals.</span>
 <span class="sd">            n_reps: The number of ansatz repetitions.</span>
 <span class="sd">            interaction_pairs: Optional restrictions on allowed orbital interactions</span>
 <span class="sd">                for the diagonal Coulomb operators.</span>
@@ -462,8 +445,8 @@ <h1>Source code for ffsim.variational.ucj_spin_balanced</h1><div class="highligh
         <span class="k">if</span> <span class="n">interaction_pairs</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
             <span class="n">interaction_pairs</span> <span class="o">=</span> <span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
         <span class="n">pairs_aa</span><span class="p">,</span> <span class="n">pairs_ab</span> <span class="o">=</span> <span class="n">interaction_pairs</span>
-        <span class="n">_validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_aa</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
-        <span class="n">_validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_ab</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+        <span class="n">validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_aa</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+        <span class="n">validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_ab</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
         <span class="c1"># Each diagonal Coulomb matrix has one parameter per upper triangular</span>
         <span class="c1"># entry unless indices are passed explicitly</span>
         <span class="n">n_triu_indices</span> <span class="o">=</span> <span class="n">norb</span> <span class="o">*</span> <span class="p">(</span><span class="n">norb</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">//</span> <span class="mi">2</span>
@@ -723,8 +706,8 @@ <h1>Source code for ffsim.variational.ucj_spin_balanced</h1><div class="highligh
         <span class="k">if</span> <span class="n">interaction_pairs</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
             <span class="n">interaction_pairs</span> <span class="o">=</span> <span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
         <span class="n">pairs_aa</span><span class="p">,</span> <span class="n">pairs_ab</span> <span class="o">=</span> <span class="n">interaction_pairs</span>
-        <span class="n">_validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_aa</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
-        <span class="n">_validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_ab</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+        <span class="n">validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_aa</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+        <span class="n">validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_ab</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
 
         <span class="n">nocc</span><span class="p">,</span> <span class="n">_</span><span class="p">,</span> <span class="n">nvrt</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">t2</span><span class="o">.</span><span class="n">shape</span>
         <span class="n">norb</span> <span class="o">=</span> <span class="n">nocc</span> <span class="o">+</span> <span class="n">nvrt</span>
@@ -870,7 +853,7 @@ <h1>Source code for ffsim.variational.ucj_spin_balanced</h1><div class="highligh
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/variational/ucj_spin_unbalanced.html b/_modules/ffsim/variational/ucj_spin_unbalanced.html
index 7e5db6694..be68eb510 100644
--- a/_modules/ffsim/variational/ucj_spin_unbalanced.html
+++ b/_modules/ffsim/variational/ucj_spin_unbalanced.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.variational.ucj_spin_unbalanced - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.variational.ucj_spin_unbalanced - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -289,28 +289,10 @@ <h1>Source code for ffsim.variational.ucj_spin_unbalanced</h1><div class="highli
 <span class="kn">from</span> <span class="nn">ffsim.variational.util</span> <span class="kn">import</span> <span class="p">(</span>
     <span class="n">orbital_rotation_from_parameters</span><span class="p">,</span>
     <span class="n">orbital_rotation_to_parameters</span><span class="p">,</span>
+    <span class="n">validate_interaction_pairs</span><span class="p">,</span>
 <span class="p">)</span>
 
 
-<span class="k">def</span> <span class="nf">_validate_interaction_pairs</span><span class="p">(</span>
-    <span class="n">interaction_pairs</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">ordered</span><span class="p">:</span> <span class="nb">bool</span>
-<span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-    <span class="k">if</span> <span class="n">interaction_pairs</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="k">return</span>
-    <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="nb">set</span><span class="p">(</span><span class="n">interaction_pairs</span><span class="p">))</span> <span class="o">!=</span> <span class="nb">len</span><span class="p">(</span><span class="n">interaction_pairs</span><span class="p">):</span>
-        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-            <span class="sa">f</span><span class="s2">&quot;Duplicate interaction pairs encountered: </span><span class="si">{</span><span class="n">interaction_pairs</span><span class="si">}</span><span class="s2">.&quot;</span>
-        <span class="p">)</span>
-    <span class="k">if</span> <span class="ow">not</span> <span class="n">ordered</span><span class="p">:</span>
-        <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">j</span> <span class="ow">in</span> <span class="n">interaction_pairs</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">i</span> <span class="o">&gt;</span> <span class="n">j</span><span class="p">:</span>
-                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-                    <span class="s2">&quot;When specifying alpha-alpha or beta-beta interaction pairs, &quot;</span>
-                    <span class="s2">&quot;you must provide only upper triangular pairs. &quot;</span>
-                    <span class="sa">f</span><span class="s2">&quot;Got </span><span class="si">{</span><span class="p">(</span><span class="n">i</span><span class="p">,</span><span class="w"> </span><span class="n">j</span><span class="p">)</span><span class="si">}</span><span class="s2">, which is a lower triangular pair.&quot;</span>
-                <span class="p">)</span>
-
-
 <div class="viewcode-block" id="UCJOpSpinUnbalanced">
 <a class="viewcode-back" href="../../../api/ffsim.html#ffsim.UCJOpSpinUnbalanced">[docs]</a>
 <span class="nd">@dataclass</span><span class="p">(</span><span class="n">frozen</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
@@ -445,6 +427,7 @@ <h1>Source code for ffsim.variational.ucj_spin_unbalanced</h1><div class="highli
 <span class="w">        </span><span class="sa">r</span><span class="sd">&quot;&quot;&quot;Return the number of parameters of an ansatz with given settings.</span>
 
 <span class="sd">        Args:</span>
+<span class="sd">            norb: The number of spatial orbitals.</span>
 <span class="sd">            n_reps: The number of ansatz repetitions.</span>
 <span class="sd">            interaction_pairs: Optional restrictions on allowed orbital interactions</span>
 <span class="sd">                for the diagonal Coulomb operators.</span>
@@ -473,9 +456,9 @@ <h1>Source code for ffsim.variational.ucj_spin_unbalanced</h1><div class="highli
         <span class="k">if</span> <span class="n">interaction_pairs</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
             <span class="n">interaction_pairs</span> <span class="o">=</span> <span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
         <span class="n">pairs_aa</span><span class="p">,</span> <span class="n">pairs_ab</span><span class="p">,</span> <span class="n">pairs_bb</span> <span class="o">=</span> <span class="n">interaction_pairs</span>
-        <span class="n">_validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_aa</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
-        <span class="n">_validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_ab</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-        <span class="n">_validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_bb</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+        <span class="n">validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_aa</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+        <span class="n">validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_ab</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+        <span class="n">validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_bb</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
         <span class="c1"># Each same-spin diagonal Coulomb matrix has one parameter per upper triangular</span>
         <span class="c1"># entry unless indices are passed explicitly</span>
         <span class="n">n_triu_indices</span> <span class="o">=</span> <span class="n">norb</span> <span class="o">*</span> <span class="p">(</span><span class="n">norb</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">//</span> <span class="mi">2</span>
@@ -581,17 +564,28 @@ <h1>Source code for ffsim.variational.ucj_spin_unbalanced</h1><div class="highli
                 <span class="p">)</span>
                 <span class="n">index</span> <span class="o">+=</span> <span class="n">n_params</span>
             <span class="c1"># Diag Coulomb matrices</span>
-            <span class="k">for</span> <span class="n">indices</span><span class="p">,</span> <span class="n">this_diag_coulomb_mat</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span>
-                <span class="p">(</span><span class="n">pairs_aa</span><span class="p">,</span> <span class="n">pairs_ab</span><span class="p">,</span> <span class="n">pairs_bb</span><span class="p">),</span>
-                <span class="n">diag_coulomb_mat</span><span class="p">,</span>
-            <span class="p">):</span>
-                <span class="k">if</span> <span class="n">indices</span><span class="p">:</span>
-                    <span class="n">n_params</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">indices</span><span class="p">)</span>
-                    <span class="n">rows</span><span class="p">,</span> <span class="n">cols</span> <span class="o">=</span> <span class="nb">zip</span><span class="p">(</span><span class="o">*</span><span class="n">indices</span><span class="p">)</span>
-                    <span class="n">vals</span> <span class="o">=</span> <span class="n">params</span><span class="p">[</span><span class="n">index</span> <span class="p">:</span> <span class="n">index</span> <span class="o">+</span> <span class="n">n_params</span><span class="p">]</span>
-                    <span class="n">this_diag_coulomb_mat</span><span class="p">[</span><span class="n">cols</span><span class="p">,</span> <span class="n">rows</span><span class="p">]</span> <span class="o">=</span> <span class="n">vals</span>
-                    <span class="n">this_diag_coulomb_mat</span><span class="p">[</span><span class="n">rows</span><span class="p">,</span> <span class="n">cols</span><span class="p">]</span> <span class="o">=</span> <span class="n">vals</span>
-                    <span class="n">index</span> <span class="o">+=</span> <span class="n">n_params</span>
+            <span class="c1"># for indices, this_diag_coulomb_mat in zip(</span>
+            <span class="c1">#     (pairs_aa, pairs_ab, pairs_bb),</span>
+            <span class="c1">#     diag_coulomb_mat,</span>
+            <span class="c1"># ):</span>
+            <span class="c1">#     if indices:</span>
+            <span class="n">n_params</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">pairs_aa</span><span class="p">)</span>
+            <span class="n">rows</span><span class="p">,</span> <span class="n">cols</span> <span class="o">=</span> <span class="nb">zip</span><span class="p">(</span><span class="o">*</span><span class="n">pairs_aa</span><span class="p">)</span>
+            <span class="n">vals</span> <span class="o">=</span> <span class="n">params</span><span class="p">[</span><span class="n">index</span> <span class="p">:</span> <span class="n">index</span> <span class="o">+</span> <span class="n">n_params</span><span class="p">]</span>
+            <span class="n">diag_coulomb_mat</span><span class="p">[</span><span class="mi">0</span><span class="p">,</span> <span class="n">cols</span><span class="p">,</span> <span class="n">rows</span><span class="p">]</span> <span class="o">=</span> <span class="n">vals</span>
+            <span class="n">diag_coulomb_mat</span><span class="p">[</span><span class="mi">0</span><span class="p">,</span> <span class="n">rows</span><span class="p">,</span> <span class="n">cols</span><span class="p">]</span> <span class="o">=</span> <span class="n">vals</span>
+            <span class="n">index</span> <span class="o">+=</span> <span class="n">n_params</span>
+            <span class="n">n_params</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">pairs_ab</span><span class="p">)</span>
+            <span class="n">rows</span><span class="p">,</span> <span class="n">cols</span> <span class="o">=</span> <span class="nb">zip</span><span class="p">(</span><span class="o">*</span><span class="n">pairs_ab</span><span class="p">)</span>
+            <span class="n">vals</span> <span class="o">=</span> <span class="n">params</span><span class="p">[</span><span class="n">index</span> <span class="p">:</span> <span class="n">index</span> <span class="o">+</span> <span class="n">n_params</span><span class="p">]</span>
+            <span class="n">diag_coulomb_mat</span><span class="p">[</span><span class="mi">1</span><span class="p">,</span> <span class="n">rows</span><span class="p">,</span> <span class="n">cols</span><span class="p">]</span> <span class="o">=</span> <span class="n">vals</span>
+            <span class="n">index</span> <span class="o">+=</span> <span class="n">n_params</span>
+            <span class="n">n_params</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">pairs_bb</span><span class="p">)</span>
+            <span class="n">rows</span><span class="p">,</span> <span class="n">cols</span> <span class="o">=</span> <span class="nb">zip</span><span class="p">(</span><span class="o">*</span><span class="n">pairs_bb</span><span class="p">)</span>
+            <span class="n">vals</span> <span class="o">=</span> <span class="n">params</span><span class="p">[</span><span class="n">index</span> <span class="p">:</span> <span class="n">index</span> <span class="o">+</span> <span class="n">n_params</span><span class="p">]</span>
+            <span class="n">diag_coulomb_mat</span><span class="p">[</span><span class="mi">2</span><span class="p">,</span> <span class="n">cols</span><span class="p">,</span> <span class="n">rows</span><span class="p">]</span> <span class="o">=</span> <span class="n">vals</span>
+            <span class="n">diag_coulomb_mat</span><span class="p">[</span><span class="mi">2</span><span class="p">,</span> <span class="n">rows</span><span class="p">,</span> <span class="n">cols</span><span class="p">]</span> <span class="o">=</span> <span class="n">vals</span>
+            <span class="n">index</span> <span class="o">+=</span> <span class="n">n_params</span>
         <span class="c1"># Final orbital rotation</span>
         <span class="n">final_orbital_rotation</span> <span class="o">=</span> <span class="kc">None</span>
         <span class="k">if</span> <span class="n">with_final_orbital_rotation</span><span class="p">:</span>
@@ -783,9 +777,9 @@ <h1>Source code for ffsim.variational.ucj_spin_unbalanced</h1><div class="highli
         <span class="k">if</span> <span class="n">interaction_pairs</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
             <span class="n">interaction_pairs</span> <span class="o">=</span> <span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
         <span class="n">pairs_aa</span><span class="p">,</span> <span class="n">pairs_ab</span><span class="p">,</span> <span class="n">pairs_bb</span> <span class="o">=</span> <span class="n">interaction_pairs</span>
-        <span class="n">_validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_aa</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
-        <span class="n">_validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_bb</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-        <span class="n">_validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_bb</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+        <span class="n">validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_aa</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+        <span class="n">validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_bb</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+        <span class="n">validate_interaction_pairs</span><span class="p">(</span><span class="n">pairs_bb</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
 
         <span class="n">t2aa</span><span class="p">,</span> <span class="n">t2ab</span><span class="p">,</span> <span class="n">t2bb</span> <span class="o">=</span> <span class="n">t2</span>
         <span class="n">nocc_a</span><span class="p">,</span> <span class="n">nocc_b</span><span class="p">,</span> <span class="n">nvrt_a</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">t2ab</span><span class="o">.</span><span class="n">shape</span>
@@ -893,7 +887,6 @@ <h1>Source code for ffsim.variational.ucj_spin_unbalanced</h1><div class="highli
             <span class="n">mask</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">bool</span><span class="p">)</span>
             <span class="n">rows</span><span class="p">,</span> <span class="n">cols</span> <span class="o">=</span> <span class="nb">zip</span><span class="p">(</span><span class="o">*</span><span class="n">pairs_ab</span><span class="p">)</span>
             <span class="n">mask</span><span class="p">[</span><span class="n">rows</span><span class="p">,</span> <span class="n">cols</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
-            <span class="n">mask</span><span class="p">[</span><span class="n">cols</span><span class="p">,</span> <span class="n">rows</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
             <span class="n">diag_coulomb_mats</span><span class="p">[:,</span> <span class="mi">1</span><span class="p">]</span> <span class="o">*=</span> <span class="n">mask</span>
         <span class="k">if</span> <span class="n">pairs_bb</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
             <span class="n">mask</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">norb</span><span class="p">,</span> <span class="n">norb</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">bool</span><span class="p">)</span>
@@ -1032,7 +1025,7 @@ <h1>Source code for ffsim.variational.ucj_spin_unbalanced</h1><div class="highli
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/ffsim/variational/ucj_spinless.html b/_modules/ffsim/variational/ucj_spinless.html
index 3ec0b40d7..21a21cdb7 100644
--- a/_modules/ffsim/variational/ucj_spinless.html
+++ b/_modules/ffsim/variational/ucj_spinless.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.variational.ucj_spinless - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.variational.ucj_spinless - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../../../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../../../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -289,28 +289,10 @@ <h1>Source code for ffsim.variational.ucj_spinless</h1><div class="highlight"><p
 <span class="kn">from</span> <span class="nn">ffsim.variational.util</span> <span class="kn">import</span> <span class="p">(</span>
     <span class="n">orbital_rotation_from_parameters</span><span class="p">,</span>
     <span class="n">orbital_rotation_to_parameters</span><span class="p">,</span>
+    <span class="n">validate_interaction_pairs</span><span class="p">,</span>
 <span class="p">)</span>
 
 
-<span class="k">def</span> <span class="nf">_validate_interaction_pairs</span><span class="p">(</span>
-    <span class="n">interaction_pairs</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]]</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">ordered</span><span class="p">:</span> <span class="nb">bool</span>
-<span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-    <span class="k">if</span> <span class="n">interaction_pairs</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="k">return</span>
-    <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="nb">set</span><span class="p">(</span><span class="n">interaction_pairs</span><span class="p">))</span> <span class="o">!=</span> <span class="nb">len</span><span class="p">(</span><span class="n">interaction_pairs</span><span class="p">):</span>
-        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-            <span class="sa">f</span><span class="s2">&quot;Duplicate interaction pairs encountered: </span><span class="si">{</span><span class="n">interaction_pairs</span><span class="si">}</span><span class="s2">.&quot;</span>
-        <span class="p">)</span>
-    <span class="k">if</span> <span class="ow">not</span> <span class="n">ordered</span><span class="p">:</span>
-        <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">j</span> <span class="ow">in</span> <span class="n">interaction_pairs</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">i</span> <span class="o">&gt;</span> <span class="n">j</span><span class="p">:</span>
-                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-                    <span class="s2">&quot;When specifying interaction pairs, &quot;</span>
-                    <span class="s2">&quot;you must provide only upper triangular pairs. &quot;</span>
-                    <span class="sa">f</span><span class="s2">&quot;Got </span><span class="si">{</span><span class="p">(</span><span class="n">i</span><span class="p">,</span><span class="w"> </span><span class="n">j</span><span class="p">)</span><span class="si">}</span><span class="s2">, which is a lower triangular pair.&quot;</span>
-                <span class="p">)</span>
-
-
 <div class="viewcode-block" id="UCJOpSpinless">
 <a class="viewcode-back" href="../../../api/ffsim.html#ffsim.UCJOpSpinless">[docs]</a>
 <span class="nd">@dataclass</span><span class="p">(</span><span class="n">frozen</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
@@ -421,6 +403,7 @@ <h1>Source code for ffsim.variational.ucj_spinless</h1><div class="highlight"><p
 <span class="w">        </span><span class="sa">r</span><span class="sd">&quot;&quot;&quot;Return the number of parameters of an ansatz with given settings.</span>
 
 <span class="sd">        Args:</span>
+<span class="sd">            norb: The number of spatial orbitals.</span>
 <span class="sd">            n_reps: The number of ansatz repetitions.</span>
 <span class="sd">            interaction_pairs: Optional restrictions on allowed orbital interactions</span>
 <span class="sd">                for the diagonal Coulomb operators.</span>
@@ -440,7 +423,7 @@ <h1>Source code for ffsim.variational.ucj_spinless</h1><div class="highlight"><p
 <span class="sd">            ValueError: Interaction pairs list contained duplicate interactions.</span>
 <span class="sd">            ValueError: Interaction pairs list contained lower triangular pairs.</span>
 <span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">_validate_interaction_pairs</span><span class="p">(</span><span class="n">interaction_pairs</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+        <span class="n">validate_interaction_pairs</span><span class="p">(</span><span class="n">interaction_pairs</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
         <span class="c1"># Each diagonal Coulomb matrix has one parameter per upper triangular</span>
         <span class="c1"># entry unless indices are passed explicitly</span>
         <span class="n">n_triu_indices</span> <span class="o">=</span> <span class="n">norb</span> <span class="o">*</span> <span class="p">(</span><span class="n">norb</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">//</span> <span class="mi">2</span>
@@ -659,7 +642,7 @@ <h1>Source code for ffsim.variational.ucj_spinless</h1><div class="highlight"><p
 <span class="sd">            ValueError: Interaction pairs list contained duplicate interactions.</span>
 <span class="sd">            ValueError: Interaction pairs list contained lower triangular pairs.</span>
 <span class="sd">        &quot;&quot;&quot;</span>
-        <span class="n">_validate_interaction_pairs</span><span class="p">(</span><span class="n">interaction_pairs</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+        <span class="n">validate_interaction_pairs</span><span class="p">(</span><span class="n">interaction_pairs</span><span class="p">,</span> <span class="n">ordered</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
 
         <span class="n">nocc</span><span class="p">,</span> <span class="n">_</span><span class="p">,</span> <span class="n">nvrt</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">t2</span><span class="o">.</span><span class="n">shape</span>
         <span class="n">norb</span> <span class="o">=</span> <span class="n">nocc</span> <span class="o">+</span> <span class="n">nvrt</span>
@@ -818,7 +801,7 @@ <h1>Source code for ffsim.variational.ucj_spinless</h1><div class="highlight"><p
       
     </aside>
   </div>
-</div><script src="../../../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../../../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../../../_static/doctools.js?v=9bcbadda"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_modules/index.html b/_modules/index.html
index 79a37af11..3aab5073f 100644
--- a/_modules/index.html
+++ b/_modules/index.html
@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>Overview: module code - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>Overview: module code - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -158,7 +158,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -182,7 +182,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -300,7 +300,6 @@ <h1>All modules for which code is available</h1>
 <li><a href="ffsim/qiskit/gates/orbital_rotation.html">ffsim.qiskit.gates.orbital_rotation</a></li>
 <li><a href="ffsim/qiskit/gates/slater_determinant.html">ffsim.qiskit.gates.slater_determinant</a></li>
 <li><a href="ffsim/qiskit/gates/ucj.html">ffsim.qiskit.gates.ucj</a></li>
-<li><a href="ffsim/qiskit/gates/ucj_operator.html">ffsim.qiskit.gates.ucj_operator</a></li>
 <li><a href="ffsim/qiskit/jordan_wigner.html">ffsim.qiskit.jordan_wigner</a></li>
 <li><a href="ffsim/qiskit/sampler.html">ffsim.qiskit.sampler</a></li>
 <li><a href="ffsim/qiskit/sim.html">ffsim.qiskit.sim</a></li>
@@ -313,6 +312,7 @@ <h1>All modules for which code is available</h1>
 <li><a href="ffsim/states/bitstring.html">ffsim.states.bitstring</a></li>
 <li><a href="ffsim/states/product_state_sum.html">ffsim.states.product_state_sum</a></li>
 <li><a href="ffsim/states/rdm.html">ffsim.states.rdm</a></li>
+<li><a href="ffsim/states/sample_slater.html">ffsim.states.sample_slater</a></li>
 <li><a href="ffsim/states/slater.html">ffsim.states.slater</a></li>
 <li><a href="ffsim/states/states.html">ffsim.states.states</a></li>
 <li><a href="ffsim/states/wick.html">ffsim.states.wick</a></li>
@@ -324,7 +324,7 @@ <h1>All modules for which code is available</h1>
 <li><a href="ffsim/variational/hopgate.html">ffsim.variational.hopgate</a></li>
 <li><a href="ffsim/variational/multireference.html">ffsim.variational.multireference</a></li>
 <li><a href="ffsim/variational/num_num.html">ffsim.variational.num_num</a></li>
-<li><a href="ffsim/variational/ucj.html">ffsim.variational.ucj</a></li>
+<li><a href="ffsim/variational/uccsd.html">ffsim.variational.uccsd</a></li>
 <li><a href="ffsim/variational/ucj_spin_balanced.html">ffsim.variational.ucj_spin_balanced</a></li>
 <li><a href="ffsim/variational/ucj_spin_unbalanced.html">ffsim.variational.ucj_spin_unbalanced</a></li>
 <li><a href="ffsim/variational/ucj_spinless.html">ffsim.variational.ucj_spinless</a></li>
@@ -360,7 +360,7 @@ <h1>All modules for which code is available</h1>
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/_static/documentation_options.js b/_static/documentation_options.js
index acd6ea3f0..d5cc51dc8 100644
--- a/_static/documentation_options.js
+++ b/_static/documentation_options.js
@@ -1,5 +1,5 @@
 const DOCUMENTATION_OPTIONS = {
-    VERSION: '0.0.47',
+    VERSION: '0.0.48',
     LANGUAGE: 'en',
     COLLAPSE_INDEX: false,
     BUILDER: 'html',
diff --git a/api/ffsim.contract.html b/api/ffsim.contract.html
index e520cf6bf..cbd10b0f3 100644
--- a/api/ffsim.contract.html
+++ b/api/ffsim.contract.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="ffsim.linalg" href="ffsim.linalg.html" /><link rel="prev" title="ffsim" href="ffsim.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.contract - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.contract - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -159,7 +159,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -183,7 +183,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -549,7 +549,7 @@
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/api/ffsim.html b/api/ffsim.html
index b3ae2d10b..80f6b7791 100644
--- a/api/ffsim.html
+++ b/api/ffsim.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="ffsim.contract" href="ffsim.contract.html" /><link rel="prev" title="API reference" href="index.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -159,7 +159,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -183,7 +183,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -880,83 +880,6 @@
 
 </dd></dl>
 
-<dl class="py class">
-<dt class="sig sig-object py" id="ffsim.GivensAnsatzOperator">
-<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">ffsim.</span></span><span class="sig-name descname"><span class="pre">GivensAnsatzOperator</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">interaction_pairs</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">thetas</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/givens.html#GivensAnsatzOperator"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.GivensAnsatzOperator" title="Link to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">object</span></code></p>
-<p>A Givens rotation ansatz operator.</p>
-<div class="admonition warning">
-<p class="admonition-title">Warning</p>
-<p>This class is deprecated. Use <a class="reference internal" href="#ffsim.GivensAnsatzOp" title="ffsim.GivensAnsatzOp"><code class="xref py py-class docutils literal notranslate"><span class="pre">ffsim.GivensAnsatzOp</span></code></a> instead.</p>
-</div>
-<p>The Givens rotation ansatz consists of a sequence of <a class="reference external" href="ffsim.html#ffsim.apply_givens_rotation">Givens rotations</a>.</p>
-<p>Note that this ansatz does not implement any interactions between spin alpha and
-spin beta orbitals.</p>
-<dl class="py attribute">
-<dt class="sig sig-object py" id="ffsim.GivensAnsatzOperator.norb">
-<span class="sig-name descname"><span class="pre">norb</span></span><a class="headerlink" href="#ffsim.GivensAnsatzOperator.norb" title="Link to this definition">¶</a></dt>
-<dd><p>The number of spatial orbitals.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Type<span class="colon">:</span></dt>
-<dd class="field-odd"><p>int</p>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py attribute">
-<dt class="sig sig-object py" id="ffsim.GivensAnsatzOperator.interaction_pairs">
-<span class="sig-name descname"><span class="pre">interaction_pairs</span></span><a class="headerlink" href="#ffsim.GivensAnsatzOperator.interaction_pairs" title="Link to this definition">¶</a></dt>
-<dd><p>The orbital pairs to apply the Givens
-rotations to.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Type<span class="colon">:</span></dt>
-<dd class="field-odd"><p>list[tuple[int, int]]</p>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py attribute">
-<dt class="sig sig-object py" id="ffsim.GivensAnsatzOperator.thetas">
-<span class="sig-name descname"><span class="pre">thetas</span></span><a class="headerlink" href="#ffsim.GivensAnsatzOperator.thetas" title="Link to this definition">¶</a></dt>
-<dd><p>The angles for the Givens rotations.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Type<span class="colon">:</span></dt>
-<dd class="field-odd"><p>np.ndarray</p>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.GivensAnsatzOperator.from_parameters">
-<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">from_parameters</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">params</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">interaction_pairs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/givens.html#GivensAnsatzOperator.from_parameters"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.GivensAnsatzOperator.from_parameters" title="Link to this definition">¶</a></dt>
-<dd><p>Initialize the operator from a real-valued parameter vector.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Parameters<span class="colon">:</span></dt>
-<dd class="field-odd"><ul class="simple">
-<li><p><strong>params</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">ndarray</span></code></span>) – The real-valued parameter vector.</p></li>
-<li><p><strong>norb</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of spatial orbitals.</p></li>
-<li><p><strong>interaction_pairs</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]]</span>) – The orbital pairs to apply the Givens rotation gates to.</p></li>
-</ul>
-</dd>
-<dt class="field-even">Return type<span class="colon">:</span></dt>
-<dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#ffsim.GivensAnsatzOperator" title="ffsim.variational.givens.GivensAnsatzOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">GivensAnsatzOperator</span></code></a></span></p>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.GivensAnsatzOperator.to_parameters">
-<span class="sig-name descname"><span class="pre">to_parameters</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/givens.html#GivensAnsatzOperator.to_parameters"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.GivensAnsatzOperator.to_parameters" title="Link to this definition">¶</a></dt>
-<dd><p>Convert the operator to a real-valued parameter vector.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">ndarray</span></code></span></p>
-</dd>
-</dl>
-</dd></dl>
-
-</dd></dl>
-
 <dl class="py class">
 <dt class="sig sig-object py" id="ffsim.HopGateAnsatzOperator">
 <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">ffsim.</span></span><span class="sig-name descname"><span class="pre">HopGateAnsatzOperator</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">interaction_pairs</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">thetas</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">final_orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/hopgate.html#HopGateAnsatzOperator"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.HopGateAnsatzOperator" title="Link to this definition">¶</a></dt>
@@ -1726,7 +1649,7 @@
 <dd><p>Return the number of parameters of an ansatz with given settings.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
-<dd class="field-odd"><p><strong>interaction_pairs</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]]</span>) – The orbital pairs to apply the number-number interactions
+<dd class="field-odd"><p><strong>interaction_pairs</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]], <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]]]</span>) – The orbital pairs to apply the number-number interactions
 to.</p>
 </dd>
 <dt class="field-even">Return type<span class="colon">:</span></dt>
@@ -1793,192 +1716,6 @@
 
 </dd></dl>
 
-<dl class="py class">
-<dt class="sig sig-object py" id="ffsim.RealUCJOperator">
-<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">ffsim.</span></span><span class="sig-name descname"><span class="pre">RealUCJOperator</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">diag_coulomb_mats_alpha_alpha</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">diag_coulomb_mats_alpha_beta</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">orbital_rotations</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">final_orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/ucj.html#RealUCJOperator"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.RealUCJOperator" title="Link to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">object</span></code></p>
-<p>Real-valued unitary cluster Jastrow operator.</p>
-<div class="admonition warning">
-<p class="admonition-title">Warning</p>
-<p>The RealUCJOperator class is deprecated. Use <a class="reference internal" href="#ffsim.UCJOpSpinBalanced" title="ffsim.UCJOpSpinBalanced"><code class="xref py py-class docutils literal notranslate"><span class="pre">ffsim.UCJOpSpinBalanced</span></code></a>
-instead.</p>
-</div>
-<p>A real-valued unitary cluster Jastrow (UCJ) operator has the form</p>
-<div class="math-wrapper docutils container">
-<div class="math notranslate nohighlight">
-\[\prod_{k = 1}^L
-\mathcal{W_k^*} e^{i \mathcal{-J}_k} \mathcal{W_k}^T
-\mathcal{W_k} e^{i \mathcal{J}_k} \mathcal{W_k^\dagger}\]</div>
-</div>
-<p>where each <span class="math notranslate nohighlight">\(\mathcal{W_k}\)</span> is an orbital rotation and each <span class="math notranslate nohighlight">\(\mathcal{J}\)</span>
-is a diagonal Coulomb operator of the form</p>
-<div class="math-wrapper docutils container">
-<div class="math notranslate nohighlight">
-\[\mathcal{J} = \frac12\sum_{ij,\sigma \tau}
-\mathbf{J}^{\sigma \tau}_{ij} n_{i,\sigma} n_{j,\tau}.\]</div>
-</div>
-<p>In order that the operator commutes with the total spin Z operator, we enforce that
-<span class="math notranslate nohighlight">\(\mathbf{J}^{\alpha\alpha} = \mathbf{J}^{\beta\beta}\)</span> and
-<span class="math notranslate nohighlight">\(\mathbf{J}^{\alpha\beta} = \mathbf{J}^{\beta\alpha}\)</span>. As a result, we have
-two sets of matrices for describing the diagonal Coulomb operators:
-“alpha-alpha” matrices containing coefficients for terms involving the same spin,
-and “alpha-beta” matrices containing coefficients for terms involving different
-spins.</p>
-<p>To support variational optimization of the orbital basis, an optional final
-orbital rotation can be included in the operator, to be performed at the end.</p>
-<dl class="py attribute">
-<dt class="sig sig-object py" id="ffsim.RealUCJOperator.diag_coulomb_mats_alpha_alpha">
-<span class="sig-name descname"><span class="pre">diag_coulomb_mats_alpha_alpha</span></span><a class="headerlink" href="#ffsim.RealUCJOperator.diag_coulomb_mats_alpha_alpha" title="Link to this definition">¶</a></dt>
-<dd><p>The “alpha-alpha” diagonal Coulomb matrices.</p>
-</dd></dl>
-
-<dl class="py attribute">
-<dt class="sig sig-object py" id="ffsim.RealUCJOperator.diag_coulomb_mats_alpha_beta">
-<span class="sig-name descname"><span class="pre">diag_coulomb_mats_alpha_beta</span></span><a class="headerlink" href="#ffsim.RealUCJOperator.diag_coulomb_mats_alpha_beta" title="Link to this definition">¶</a></dt>
-<dd><p>The “alpha-beta” diagonal Coulomb matrices.</p>
-</dd></dl>
-
-<dl class="py attribute">
-<dt class="sig sig-object py" id="ffsim.RealUCJOperator.orbital_rotations">
-<span class="sig-name descname"><span class="pre">orbital_rotations</span></span><a class="headerlink" href="#ffsim.RealUCJOperator.orbital_rotations" title="Link to this definition">¶</a></dt>
-<dd><p>The orbital rotations.</p>
-</dd></dl>
-
-<dl class="py attribute">
-<dt class="sig sig-object py" id="ffsim.RealUCJOperator.final_orbital_rotation">
-<span class="sig-name descname"><span class="pre">final_orbital_rotation</span></span><a class="headerlink" href="#ffsim.RealUCJOperator.final_orbital_rotation" title="Link to this definition">¶</a></dt>
-<dd><p>The optional final orbital rotation.</p>
-</dd></dl>
-
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.RealUCJOperator.from_parameters">
-<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">from_parameters</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">params</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n_reps</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">alpha_alpha_indices</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">alpha_beta_indices</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">with_final_orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/ucj.html#RealUCJOperator.from_parameters"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.RealUCJOperator.from_parameters" title="Link to this definition">¶</a></dt>
-<dd><p>Initialize the real UCJ operator from a real-valued parameter vector.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Parameters<span class="colon">:</span></dt>
-<dd class="field-odd"><ul class="simple">
-<li><p><strong>params</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">ndarray</span></code></span>) – The real-valued parameter vector.</p></li>
-<li><p><strong>norb</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of spatial orbitals.</p></li>
-<li><p><strong>n_reps</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of ansatz repetitions (<span class="math notranslate nohighlight">\(L\)</span> from the docstring of
-this class).</p></li>
-<li><p><strong>alpha_alpha_indices</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></span>) – Allowed indices for nonzero values of the “alpha-alpha”
-diagonal Coulomb matrices (see the docstring of this class).
-If not specified, all matrix entries are allowed to be nonzero.
-This list should contain only upper trianglular indices, i.e.,
-pairs <span class="math notranslate nohighlight">\((i, j)\)</span> where <span class="math notranslate nohighlight">\(i \leq j\)</span>. Passing a list with
-lower triangular indices will raise an error.</p></li>
-<li><p><strong>alpha_beta_indices</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></span>) – Allowed indices for nonzero values of the “alpha-beta”
-diagonal Coulomb matrices (see the docstring of this class).
-If not specified, all matrix entries are allowed to be nonzero.
-This list should contain only upper trianglular indices, i.e.,
-pairs <span class="math notranslate nohighlight">\((i, j)\)</span> where <span class="math notranslate nohighlight">\(i \leq j\)</span>. Passing a list with
-lower triangular indices will raise an error.</p></li>
-<li><p><strong>with_final_orbital_rotation</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code></span>) – Whether to include a final orbital rotation
-in the operator.</p></li>
-</ul>
-</dd>
-<dt class="field-even">Return type<span class="colon">:</span></dt>
-<dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#ffsim.RealUCJOperator" title="ffsim.variational.ucj.RealUCJOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">RealUCJOperator</span></code></a></span></p>
-</dd>
-<dt class="field-odd">Returns<span class="colon">:</span></dt>
-<dd class="field-odd"><p>The real UCJ operator constructed from the given parameters.</p>
-</dd>
-<dt class="field-even">Raises<span class="colon">:</span></dt>
-<dd class="field-even"><ul class="simple">
-<li><p><strong>ValueError</strong> – alpha_alpha_indices contains lower triangular indices.</p></li>
-<li><p><strong>ValueError</strong> – alpha_beta_indices contains lower triangular indices.</p></li>
-</ul>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.RealUCJOperator.from_t_amplitudes">
-<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">from_t_amplitudes</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">t2</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">t1</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n_reps</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">tol</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1e-08</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/ucj.html#RealUCJOperator.from_t_amplitudes"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.RealUCJOperator.from_t_amplitudes" title="Link to this definition">¶</a></dt>
-<dd><p>Initialize the real UCJ operator from t2 (and optionally t1) amplitudes.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#ffsim.RealUCJOperator" title="ffsim.variational.ucj.RealUCJOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">RealUCJOperator</span></code></a></span></p>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.RealUCJOperator.n_params">
-<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">n_params</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n_reps</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">alpha_alpha_indices</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">alpha_beta_indices</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">with_final_orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/ucj.html#RealUCJOperator.n_params"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.RealUCJOperator.n_params" title="Link to this definition">¶</a></dt>
-<dd><p>Return the number of parameters of an ansatz with given settings.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span></p>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py property">
-<dt class="sig sig-object py" id="ffsim.RealUCJOperator.n_reps">
-<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">n_reps</span></span><a class="headerlink" href="#ffsim.RealUCJOperator.n_reps" title="Link to this definition">¶</a></dt>
-<dd><p>The number of ansatz repetitions.</p>
-</dd></dl>
-
-<dl class="py property">
-<dt class="sig sig-object py" id="ffsim.RealUCJOperator.norb">
-<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">norb</span></span><a class="headerlink" href="#ffsim.RealUCJOperator.norb" title="Link to this definition">¶</a></dt>
-<dd><p>The number of spatial orbitals.</p>
-</dd></dl>
-
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.RealUCJOperator.to_parameters">
-<span class="sig-name descname"><span class="pre">to_parameters</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">alpha_alpha_indices</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">alpha_beta_indices</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/ucj.html#RealUCJOperator.to_parameters"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.RealUCJOperator.to_parameters" title="Link to this definition">¶</a></dt>
-<dd><p>Convert the real UCJ operator to a real-valued parameter vector.</p>
-<p>If <cite>alpha_alpha_indices</cite> or <cite>alpha_beta_indices</cite> is specified, the returned
-parameter vector will incorporate only the diagonal Coulomb matrix entries
-corresponding to the given indices, so the original operator will not be
-recoverable from the parameter vector.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Parameters<span class="colon">:</span></dt>
-<dd class="field-odd"><ul class="simple">
-<li><p><strong>alpha_alpha_indices</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></span>) – Allowed indices for nonzero values of the “alpha-alpha”
-diagonal Coulomb matrices (see the docstring of this class).
-If not specified, all matrix entries are allowed to be nonzero.
-This list should contain only upper trianglular indices, i.e.,
-pairs <span class="math notranslate nohighlight">\((i, j)\)</span> where <span class="math notranslate nohighlight">\(i \leq j\)</span>. Passing a list with
-lower triangular indices will raise an error.</p></li>
-<li><p><strong>alpha_beta_indices</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></span>) – Allowed indices for nonzero values of the “alpha-beta”
-diagonal Coulomb matrices (see the docstring of this class).
-If not specified, all matrix entries are allowed to be nonzero.
-This list should contain only upper trianglular indices, i.e.,
-pairs <span class="math notranslate nohighlight">\((i, j)\)</span> where <span class="math notranslate nohighlight">\(i \leq j\)</span>. Passing a list with
-lower triangular indices will raise an error.</p></li>
-</ul>
-</dd>
-<dt class="field-even">Return type<span class="colon">:</span></dt>
-<dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">ndarray</span></code></span></p>
-</dd>
-<dt class="field-odd">Returns<span class="colon">:</span></dt>
-<dd class="field-odd"><p>The real-valued parameter vector.</p>
-</dd>
-<dt class="field-even">Raises<span class="colon">:</span></dt>
-<dd class="field-even"><ul class="simple">
-<li><p><strong>ValueError</strong> – alpha_alpha_indices contains lower triangular indices.</p></li>
-<li><p><strong>ValueError</strong> – alpha_beta_indices contains lower triangular indices.</p></li>
-</ul>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.RealUCJOperator.to_t_amplitudes">
-<span class="sig-name descname"><span class="pre">to_t_amplitudes</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">nocc</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/ucj.html#RealUCJOperator.to_t_amplitudes"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.RealUCJOperator.to_t_amplitudes" title="Link to this definition">¶</a></dt>
-<dd><p>Convert the UCJ operator to t2 (and possibly t1) amplitudes.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">ndarray</span></code> | <code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">ndarray</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">ndarray</span></code>]</span></p>
-</dd>
-</dl>
-</dd></dl>
-
-</dd></dl>
-
 <dl class="py class">
 <dt class="sig sig-object py" id="ffsim.SingleFactorizedHamiltonian">
 <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">ffsim.</span></span><span class="sig-name descname"><span class="pre">SingleFactorizedHamiltonian</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">one_body_tensor</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">one_body_squares</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">constant</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">0.0</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/hamiltonians/single_factorized_hamiltonian.html#SingleFactorizedHamiltonian"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.SingleFactorizedHamiltonian" title="Link to this definition">¶</a></dt>
@@ -2213,6 +1950,82 @@
 <p>A linear operator whose trace can be computed.</p>
 </dd></dl>
 
+<dl class="py class">
+<dt class="sig sig-object py" id="ffsim.UCCSDOpRestrictedReal">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">ffsim.</span></span><span class="sig-name descname"><span class="pre">UCCSDOpRestrictedReal</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">t1</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">t2</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">final_orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">validate</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">rtol</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1e-05</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">atol</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1e-08</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/uccsd.html#UCCSDOpRestrictedReal"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.UCCSDOpRestrictedReal" title="Link to this definition">¶</a></dt>
+<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">object</span></code></p>
+<p>Real-valued restricted unitary coupled cluster, singles and doubles operator.</p>
+<dl class="py method">
+<dt class="sig sig-object py" id="ffsim.UCCSDOpRestrictedReal.from_parameters">
+<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">from_parameters</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">params</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">nocc</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">with_final_orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/uccsd.html#UCCSDOpRestrictedReal.from_parameters"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.UCCSDOpRestrictedReal.from_parameters" title="Link to this definition">¶</a></dt>
+<dd><p>Initialize the UCCSD operator from a real-valued parameter vector.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>params</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">ndarray</span></code></span>) – The real-valued parameter vector.</p></li>
+<li><p><strong>norb</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of spatial orbitals.</p></li>
+<li><p><strong>nocc</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of spatial orbitals that are occupied by electrons.</p></li>
+<li><p><strong>with_final_orbital_rotation</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code></span>) – Whether to include a final orbital rotation
+in the operator.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Return type<span class="colon">:</span></dt>
+<dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#ffsim.UCCSDOpRestrictedReal" title="ffsim.variational.uccsd.UCCSDOpRestrictedReal"><code class="xref py py-class docutils literal notranslate"><span class="pre">UCCSDOpRestrictedReal</span></code></a></span></p>
+</dd>
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p>The UCCSD operator constructed from the given parameters.</p>
+</dd>
+<dt class="field-even">Raises<span class="colon">:</span></dt>
+<dd class="field-even"><p><strong>ValueError</strong> – The number of parameters passed did not match the number
+    expected based on the function inputs.</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ffsim.UCCSDOpRestrictedReal.n_params">
+<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">n_params</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">nocc</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">with_final_orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/uccsd.html#UCCSDOpRestrictedReal.n_params"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.UCCSDOpRestrictedReal.n_params" title="Link to this definition">¶</a></dt>
+<dd><p>Return the number of parameters of an ansatz with given settings.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>norb</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of spatial orbitals.</p></li>
+<li><p><strong>nocc</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of spatial orbitals that are occupied by electrons.</p></li>
+<li><p><strong>with_final_orbital_rotation</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code></span>) – Whether to include a final orbital rotation
+in the operator.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Return type<span class="colon">:</span></dt>
+<dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span></p>
+</dd>
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p>The number of parameters of the ansatz.</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="ffsim.UCCSDOpRestrictedReal.norb">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">norb</span></span><a class="headerlink" href="#ffsim.UCCSDOpRestrictedReal.norb" title="Link to this definition">¶</a></dt>
+<dd><p>The number of spatial orbitals.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ffsim.UCCSDOpRestrictedReal.to_parameters">
+<span class="sig-name descname"><span class="pre">to_parameters</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/uccsd.html#UCCSDOpRestrictedReal.to_parameters"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.UCCSDOpRestrictedReal.to_parameters" title="Link to this definition">¶</a></dt>
+<dd><p>Convert the UCCSD operator to a real-valued parameter vector.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">ndarray</span></code></span></p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>The real-valued parameter vector.</p>
+</dd>
+</dl>
+</dd></dl>
+
+</dd></dl>
+
 <dl class="py class">
 <dt class="sig sig-object py" id="ffsim.UCJOpSpinBalanced">
 <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">ffsim.</span></span><span class="sig-name descname"><span class="pre">UCJOpSpinBalanced</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">diag_coulomb_mats</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">orbital_rotations</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">final_orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">validate</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">rtol</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1e-05</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">atol</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1e-08</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/ucj_spin_balanced.html#UCJOpSpinBalanced"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.UCJOpSpinBalanced" title="Link to this definition">¶</a></dt>
@@ -2385,6 +2198,7 @@
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
+<li><p><strong>norb</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of spatial orbitals.</p></li>
 <li><p><strong>n_reps</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of ansatz repetitions.</p></li>
 <li><p><strong>interaction_pairs</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code>] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></span>) – Optional restrictions on allowed orbital interactions
 for the diagonal Coulomb operators.
@@ -2661,6 +2475,7 @@
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
+<li><p><strong>norb</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of spatial orbitals.</p></li>
 <li><p><strong>n_reps</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of ansatz repetitions.</p></li>
 <li><p><strong>interaction_pairs</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code>] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></span>) – Optional restrictions on allowed orbital interactions
 for the diagonal Coulomb operators.
@@ -2905,6 +2720,7 @@
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
+<li><p><strong>norb</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of spatial orbitals.</p></li>
 <li><p><strong>n_reps</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of ansatz repetitions.</p></li>
 <li><p><strong>interaction_pairs</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></span>) – Optional restrictions on allowed orbital interactions
 for the diagonal Coulomb operators.
@@ -2984,212 +2800,6 @@
 
 </dd></dl>
 
-<dl class="py class">
-<dt class="sig sig-object py" id="ffsim.UCJOperator">
-<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">ffsim.</span></span><span class="sig-name descname"><span class="pre">UCJOperator</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">diag_coulomb_mats_alpha_alpha</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">diag_coulomb_mats_alpha_beta</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">orbital_rotations</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">final_orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/ucj.html#UCJOperator"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.UCJOperator" title="Link to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">object</span></code></p>
-<p>A unitary cluster Jastrow operator.</p>
-<div class="admonition warning">
-<p class="admonition-title">Warning</p>
-<p>The UCJOperator class is deprecated. Use <a class="reference internal" href="#ffsim.UCJOpSpinBalanced" title="ffsim.UCJOpSpinBalanced"><code class="xref py py-class docutils literal notranslate"><span class="pre">ffsim.UCJOpSpinBalanced</span></code></a>
-instead.</p>
-</div>
-<p>A unitary cluster Jastrow (UCJ) operator has the form</p>
-<div class="math-wrapper docutils container">
-<div class="math notranslate nohighlight">
-\[\prod_{k = 1}^L \mathcal{W}_k e^{i \mathcal{J}_k} \mathcal{W}_k^\dagger\]</div>
-</div>
-<p>where each <span class="math notranslate nohighlight">\(\mathcal{W_k}\)</span> is an orbital rotation and each <span class="math notranslate nohighlight">\(\mathcal{J}\)</span>
-is a diagonal Coulomb operator of the form</p>
-<div class="math-wrapper docutils container">
-<div class="math notranslate nohighlight">
-\[\mathcal{J} = \frac12\sum_{\sigma \tau, ij}
-\mathbf{J}^{\sigma \tau}_{ij} n_{\sigma, i} n_{\tau, j}.\]</div>
-</div>
-<p>In order that the operator commutes with the total spin Z operator, we enforce that
-<span class="math notranslate nohighlight">\(\mathbf{J}^{\alpha\alpha} = \mathbf{J}^{\beta\beta}\)</span> and
-<span class="math notranslate nohighlight">\(\mathbf{J}^{\alpha\beta} = \mathbf{J}^{\beta\alpha}\)</span>. As a result, we have
-two sets of matrices for describing the diagonal Coulomb operators:
-“alpha-alpha” matrices containing coefficients for terms involving the same spin,
-and “alpha-beta” matrices containing coefficients for terms involving different
-spins.</p>
-<p>To support variational optimization of the orbital basis, an optional final
-orbital rotation can be included in the operator, to be performed at the end.</p>
-<dl class="py attribute">
-<dt class="sig sig-object py" id="ffsim.UCJOperator.diag_coulomb_mats_alpha_alpha">
-<span class="sig-name descname"><span class="pre">diag_coulomb_mats_alpha_alpha</span></span><a class="headerlink" href="#ffsim.UCJOperator.diag_coulomb_mats_alpha_alpha" title="Link to this definition">¶</a></dt>
-<dd><p>The “alpha-alpha” diagonal Coulomb
-matrices.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Type<span class="colon">:</span></dt>
-<dd class="field-odd"><p>np.ndarray</p>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py attribute">
-<dt class="sig sig-object py" id="ffsim.UCJOperator.diag_coulomb_mats_alpha_beta">
-<span class="sig-name descname"><span class="pre">diag_coulomb_mats_alpha_beta</span></span><a class="headerlink" href="#ffsim.UCJOperator.diag_coulomb_mats_alpha_beta" title="Link to this definition">¶</a></dt>
-<dd><p>The “alpha-beta” diagonal Coulomb
-matrices.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Type<span class="colon">:</span></dt>
-<dd class="field-odd"><p>np.ndarray</p>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py attribute">
-<dt class="sig sig-object py" id="ffsim.UCJOperator.orbital_rotations">
-<span class="sig-name descname"><span class="pre">orbital_rotations</span></span><a class="headerlink" href="#ffsim.UCJOperator.orbital_rotations" title="Link to this definition">¶</a></dt>
-<dd><p>The orbital rotations.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Type<span class="colon">:</span></dt>
-<dd class="field-odd"><p>np.ndarray</p>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py attribute">
-<dt class="sig sig-object py" id="ffsim.UCJOperator.final_orbital_rotation">
-<span class="sig-name descname"><span class="pre">final_orbital_rotation</span></span><a class="headerlink" href="#ffsim.UCJOperator.final_orbital_rotation" title="Link to this definition">¶</a></dt>
-<dd><p>The optional final orbital rotation.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Type<span class="colon">:</span></dt>
-<dd class="field-odd"><p>np.ndarray</p>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.UCJOperator.from_parameters">
-<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">from_parameters</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">params</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n_reps</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">alpha_alpha_indices</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">alpha_beta_indices</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">with_final_orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/ucj.html#UCJOperator.from_parameters"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.UCJOperator.from_parameters" title="Link to this definition">¶</a></dt>
-<dd><p>Initialize the UCJ operator from a real-valued parameter vector.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Parameters<span class="colon">:</span></dt>
-<dd class="field-odd"><ul class="simple">
-<li><p><strong>params</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">ndarray</span></code></span>) – The real-valued parameter vector.</p></li>
-<li><p><strong>norb</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of spatial orbitals.</p></li>
-<li><p><strong>n_reps</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of ansatz repetitions (<span class="math notranslate nohighlight">\(L\)</span> from the docstring of
-this class).</p></li>
-<li><p><strong>alpha_alpha_indices</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></span>) – Allowed indices for nonzero values of the “alpha-alpha”
-diagonal Coulomb matrices (see the docstring of this class).
-If not specified, all matrix entries are allowed to be nonzero.
-This list should contain only upper trianglular indices, i.e.,
-pairs <span class="math notranslate nohighlight">\((i, j)\)</span> where <span class="math notranslate nohighlight">\(i \leq j\)</span>. Passing a list with
-lower triangular indices will raise an error.</p></li>
-<li><p><strong>alpha_beta_indices</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></span>) – Allowed indices for nonzero values of the “alpha-beta”
-diagonal Coulomb matrices (see the docstring of this class).
-If not specified, all matrix entries are allowed to be nonzero.
-This list should contain only upper trianglular indices, i.e.,
-pairs <span class="math notranslate nohighlight">\((i, j)\)</span> where <span class="math notranslate nohighlight">\(i \leq j\)</span>. Passing a list with
-lower triangular indices will raise an error.</p></li>
-<li><p><strong>with_final_orbital_rotation</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code></span>) – Whether to include a final orbital rotation
-in the operator.</p></li>
-</ul>
-</dd>
-<dt class="field-even">Return type<span class="colon">:</span></dt>
-<dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#ffsim.UCJOperator" title="ffsim.variational.ucj.UCJOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">UCJOperator</span></code></a></span></p>
-</dd>
-<dt class="field-odd">Returns<span class="colon">:</span></dt>
-<dd class="field-odd"><p>The UCJ operator constructed from the given parameters.</p>
-</dd>
-<dt class="field-even">Raises<span class="colon">:</span></dt>
-<dd class="field-even"><ul class="simple">
-<li><p><strong>ValueError</strong> – alpha_alpha_indices contains lower triangular indices.</p></li>
-<li><p><strong>ValueError</strong> – alpha_beta_indices contains lower triangular indices.</p></li>
-</ul>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.UCJOperator.from_t_amplitudes">
-<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">from_t_amplitudes</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">t2</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">t1</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n_reps</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">tol</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1e-08</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/ucj.html#UCJOperator.from_t_amplitudes"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.UCJOperator.from_t_amplitudes" title="Link to this definition">¶</a></dt>
-<dd><p>Initialize the UCJ operator from t2 (and optionally t1) amplitudes.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#ffsim.UCJOperator" title="ffsim.variational.ucj.UCJOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">UCJOperator</span></code></a></span></p>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.UCJOperator.n_params">
-<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">n_params</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n_reps</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">alpha_alpha_indices</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">alpha_beta_indices</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">with_final_orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/ucj.html#UCJOperator.n_params"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.UCJOperator.n_params" title="Link to this definition">¶</a></dt>
-<dd><p>Return the number of parameters of an ansatz with given settings.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span></p>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py property">
-<dt class="sig sig-object py" id="ffsim.UCJOperator.n_reps">
-<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">n_reps</span></span><a class="headerlink" href="#ffsim.UCJOperator.n_reps" title="Link to this definition">¶</a></dt>
-<dd><p>The number of ansatz repetitions.</p>
-</dd></dl>
-
-<dl class="py property">
-<dt class="sig sig-object py" id="ffsim.UCJOperator.norb">
-<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">norb</span></span><a class="headerlink" href="#ffsim.UCJOperator.norb" title="Link to this definition">¶</a></dt>
-<dd><p>The number of spatial orbitals.</p>
-</dd></dl>
-
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.UCJOperator.to_parameters">
-<span class="sig-name descname"><span class="pre">to_parameters</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">alpha_alpha_indices</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">alpha_beta_indices</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/ucj.html#UCJOperator.to_parameters"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.UCJOperator.to_parameters" title="Link to this definition">¶</a></dt>
-<dd><p>Convert the UCJ operator to a real-valued parameter vector.</p>
-<p>If <cite>alpha_alpha_indices</cite> or <cite>alpha_beta_indices</cite> is specified, the returned
-parameter vector will incorporate only the diagonal Coulomb matrix entries
-corresponding to the given indices, so the original operator will not be
-recoverable from the parameter vector.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Parameters<span class="colon">:</span></dt>
-<dd class="field-odd"><ul class="simple">
-<li><p><strong>alpha_alpha_indices</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></span>) – Allowed indices for nonzero values of the “alpha-alpha”
-diagonal Coulomb matrices (see the docstring of this class).
-If not specified, all matrix entries are allowed to be nonzero.
-This list should contain only upper trianglular indices, i.e.,
-pairs <span class="math notranslate nohighlight">\((i, j)\)</span> where <span class="math notranslate nohighlight">\(i \leq j\)</span>. Passing a list with
-lower triangular indices will raise an error.</p></li>
-<li><p><strong>alpha_beta_indices</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></span>) – Allowed indices for nonzero values of the “alpha-beta”
-diagonal Coulomb matrices (see the docstring of this class).
-If not specified, all matrix entries are allowed to be nonzero.
-This list should contain only upper trianglular indices, i.e.,
-pairs <span class="math notranslate nohighlight">\((i, j)\)</span> where <span class="math notranslate nohighlight">\(i \leq j\)</span>. Passing a list with
-lower triangular indices will raise an error.</p></li>
-</ul>
-</dd>
-<dt class="field-even">Return type<span class="colon">:</span></dt>
-<dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">ndarray</span></code></span></p>
-</dd>
-<dt class="field-odd">Returns<span class="colon">:</span></dt>
-<dd class="field-odd"><p>The real-valued parameter vector.</p>
-</dd>
-<dt class="field-even">Raises<span class="colon">:</span></dt>
-<dd class="field-even"><ul class="simple">
-<li><p><strong>ValueError</strong> – alpha_alpha_indices contains lower triangular indices.</p></li>
-<li><p><strong>ValueError</strong> – alpha_beta_indices contains lower triangular indices.</p></li>
-</ul>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.UCJOperator.to_t_amplitudes">
-<span class="sig-name descname"><span class="pre">to_t_amplitudes</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">nocc</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/variational/ucj.html#UCJOperator.to_t_amplitudes"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.UCJOperator.to_t_amplitudes" title="Link to this definition">¶</a></dt>
-<dd><p>Convert the UCJ operator to t2 (and possibly t1) amplitudes.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">ndarray</span></code> | <code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">ndarray</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">ndarray</span></code>]</span></p>
-</dd>
-</dl>
-</dd></dl>
-
-</dd></dl>
-
 <dl class="py function">
 <dt class="sig sig-object py" id="ffsim.addresses_to_strings">
 <span class="sig-prename descclassname"><span class="pre">ffsim.</span></span><span class="sig-name descname"><span class="pre">addresses_to_strings</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">addresses</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">nelec</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">concatenate</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">bitstring_type</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">BitstringType.INT</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/states/bitstring.html#addresses_to_strings"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.addresses_to_strings" title="Link to this definition">¶</a></dt>
@@ -4296,7 +3906,7 @@
 
 <dl class="py function">
 <dt class="sig sig-object py" id="ffsim.hartree_fock_state">
-<span class="sig-prename descclassname"><span class="pre">ffsim.</span></span><span class="sig-name descname"><span class="pre">hartree_fock_state</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">nelec</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/states/states.html#hartree_fock_state"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.hartree_fock_state" title="Link to this definition">¶</a></dt>
+<span class="sig-prename descclassname"><span class="pre">ffsim.</span></span><span class="sig-name descname"><span class="pre">hartree_fock_state</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">nelec</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/states/slater.html#hartree_fock_state"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.hartree_fock_state" title="Link to this definition">¶</a></dt>
 <dd><p>Return the Hartree-Fock state.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
@@ -4627,7 +4237,7 @@
 
 <dl class="py function">
 <dt class="sig sig-object py" id="ffsim.sample_slater_determinant">
-<span class="sig-prename descclassname"><span class="pre">ffsim.</span></span><span class="sig-name descname"><span class="pre">sample_slater_determinant</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">rdm</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">nelec</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">orbs</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">shots</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">concatenate</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">bitstring_type</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">BitstringType.STRING</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">seed</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/states/slater.html#sample_slater_determinant"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.sample_slater_determinant" title="Link to this definition">¶</a></dt>
+<span class="sig-prename descclassname"><span class="pre">ffsim.</span></span><span class="sig-name descname"><span class="pre">sample_slater_determinant</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">rdm</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">nelec</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">orbs</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">shots</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">concatenate</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">bitstring_type</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">BitstringType.STRING</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">seed</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/states/sample_slater.html#sample_slater_determinant"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.sample_slater_determinant" title="Link to this definition">¶</a></dt>
 <dd><p>Collect samples of electronic configurations from a Slater determinant.</p>
 <p>The Slater determinant is defined by its one-body reduced density matrix (RDM).
 The sampler uses a determinantal point process to auto-regressively produce
@@ -4825,7 +4435,7 @@
 
 <dl class="py function">
 <dt class="sig sig-object py" id="ffsim.slater_determinant">
-<span class="sig-prename descclassname"><span class="pre">ffsim.</span></span><span class="sig-name descname"><span class="pre">slater_determinant</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">occupied_orbitals</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/states/states.html#slater_determinant"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.slater_determinant" title="Link to this definition">¶</a></dt>
+<span class="sig-prename descclassname"><span class="pre">ffsim.</span></span><span class="sig-name descname"><span class="pre">slater_determinant</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">occupied_orbitals</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/states/slater.html#slater_determinant"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.slater_determinant" title="Link to this definition">¶</a></dt>
 <dd><p>Return a Slater determinant.</p>
 <p>A Slater determinant is a state of the form</p>
 <div class="math-wrapper docutils container">
@@ -4861,9 +4471,40 @@
 </dl>
 </dd></dl>
 
+<dl class="py function">
+<dt class="sig sig-object py" id="ffsim.slater_determinant_amplitudes">
+<span class="sig-prename descclassname"><span class="pre">ffsim.</span></span><span class="sig-name descname"><span class="pre">slater_determinant_amplitudes</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">bitstrings</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">occupied_orbitals</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">orbital_rotation</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/states/slater.html#slater_determinant_amplitudes"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.slater_determinant_amplitudes" title="Link to this definition">¶</a></dt>
+<dd><p>Compute state vector amplitudes for a Slater determinant.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>bitstrings</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">Sequence</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>] | <code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">Sequence</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>], <code class="xref py py-class docutils literal notranslate"><span class="pre">Sequence</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]]</span>) – The bitstrings to return the amplitudes for, in integer
+representation. In the spinless case this is a list of integers. In the
+spinful case, this is a pair of lists of equal length specifying the
+alpha and beta parts of the bitstrings.</p></li>
+<li><p><strong>norb</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of spatial orbitals.</p></li>
+<li><p><strong>occupied_orbitals</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">Sequence</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>] | <code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">Sequence</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>], <code class="xref py py-class docutils literal notranslate"><span class="pre">Sequence</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]]</span>) – The occupied orbitals in the electronic configuration.
+This is either a list of integers specifying spinless orbitals, or a
+pair of lists, where the first list specifies the spin alpha orbitals and
+the second list specifies the spin beta orbitals.</p></li>
+<li><p><strong>orbital_rotation</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">ndarray</span></code> | <code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">ndarray</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">ndarray</span></code>]</span>) – The orbital rotation describing the Slater determinant.
+You can pass either a single Numpy array specifying the orbital rotation
+to apply to both spin sectors, or you can pass a pair of Numpy arrays
+specifying independent orbital rotations for spin alpha and spin beta.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Return type<span class="colon">:</span></dt>
+<dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">ndarray</span></code></span></p>
+</dd>
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p>The amplitudes of the requested bitstrings.</p>
+</dd>
+</dl>
+</dd></dl>
+
 <dl class="py function">
 <dt class="sig sig-object py" id="ffsim.slater_determinant_rdm">
-<span class="sig-prename descclassname"><span class="pre">ffsim.</span></span><span class="sig-name descname"><span class="pre">slater_determinant_rdm</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">occupied_orbitals</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">rank</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">spin_summed</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/states/states.html#slater_determinant_rdm"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.slater_determinant_rdm" title="Link to this definition">¶</a></dt>
+<span class="sig-prename descclassname"><span class="pre">ffsim.</span></span><span class="sig-name descname"><span class="pre">slater_determinant_rdm</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">occupied_orbitals</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">rank</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">spin_summed</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/states/slater.html#slater_determinant_rdm"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.slater_determinant_rdm" title="Link to this definition">¶</a></dt>
 <dd><p>Return the reduced density matrix of a <a class="reference external" href="ffsim.html#ffsim.slater_determinant">Slater determinant</a>.</p>
 <div class="admonition warning">
 <p class="admonition-title">Warning</p>
@@ -4904,7 +4545,7 @@
 
 <dl class="py function">
 <dt class="sig sig-object py" id="ffsim.slater_determinant_rdms">
-<span class="sig-prename descclassname"><span class="pre">ffsim.</span></span><span class="sig-name descname"><span class="pre">slater_determinant_rdms</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">occupied_orbitals</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">rank</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/states/states.html#slater_determinant_rdms"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.slater_determinant_rdms" title="Link to this definition">¶</a></dt>
+<span class="sig-prename descclassname"><span class="pre">ffsim.</span></span><span class="sig-name descname"><span class="pre">slater_determinant_rdms</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">occupied_orbitals</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">rank</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/states/slater.html#slater_determinant_rdms"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.slater_determinant_rdms" title="Link to this definition">¶</a></dt>
 <dd><p>Return the reduced density matrices of a <a class="reference external" href="ffsim.html#ffsim.slater_determinant">Slater determinant</a>.</p>
 <div class="admonition note">
 <p class="admonition-title">Note</p>
@@ -5185,14 +4826,6 @@
 <li><a class="reference internal" href="#ffsim.GivensAnsatzOp.to_parameters"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOp.to_parameters()</span></code></a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#ffsim.GivensAnsatzOperator"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOperator</span></code></a><ul>
-<li><a class="reference internal" href="#ffsim.GivensAnsatzOperator.norb"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOperator.norb</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.GivensAnsatzOperator.interaction_pairs"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOperator.interaction_pairs</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.GivensAnsatzOperator.thetas"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOperator.thetas</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.GivensAnsatzOperator.from_parameters"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOperator.from_parameters()</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.GivensAnsatzOperator.to_parameters"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOperator.to_parameters()</span></code></a></li>
-</ul>
-</li>
 <li><a class="reference internal" href="#ffsim.HopGateAnsatzOperator"><code class="docutils literal notranslate"><span class="pre">HopGateAnsatzOperator</span></code></a><ul>
 <li><a class="reference internal" href="#ffsim.HopGateAnsatzOperator.norb"><code class="docutils literal notranslate"><span class="pre">HopGateAnsatzOperator.norb</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.HopGateAnsatzOperator.interaction_pairs"><code class="docutils literal notranslate"><span class="pre">HopGateAnsatzOperator.interaction_pairs</span></code></a></li>
@@ -5272,20 +4905,6 @@
 <li><a class="reference internal" href="#ffsim.ProductStateSum.states"><code class="docutils literal notranslate"><span class="pre">ProductStateSum.states</span></code></a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#ffsim.RealUCJOperator"><code class="docutils literal notranslate"><span class="pre">RealUCJOperator</span></code></a><ul>
-<li><a class="reference internal" href="#ffsim.RealUCJOperator.diag_coulomb_mats_alpha_alpha"><code class="docutils literal notranslate"><span class="pre">RealUCJOperator.diag_coulomb_mats_alpha_alpha</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.RealUCJOperator.diag_coulomb_mats_alpha_beta"><code class="docutils literal notranslate"><span class="pre">RealUCJOperator.diag_coulomb_mats_alpha_beta</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.RealUCJOperator.orbital_rotations"><code class="docutils literal notranslate"><span class="pre">RealUCJOperator.orbital_rotations</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.RealUCJOperator.final_orbital_rotation"><code class="docutils literal notranslate"><span class="pre">RealUCJOperator.final_orbital_rotation</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.RealUCJOperator.from_parameters"><code class="docutils literal notranslate"><span class="pre">RealUCJOperator.from_parameters()</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.RealUCJOperator.from_t_amplitudes"><code class="docutils literal notranslate"><span class="pre">RealUCJOperator.from_t_amplitudes()</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.RealUCJOperator.n_params"><code class="docutils literal notranslate"><span class="pre">RealUCJOperator.n_params()</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.RealUCJOperator.n_reps"><code class="docutils literal notranslate"><span class="pre">RealUCJOperator.n_reps</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.RealUCJOperator.norb"><code class="docutils literal notranslate"><span class="pre">RealUCJOperator.norb</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.RealUCJOperator.to_parameters"><code class="docutils literal notranslate"><span class="pre">RealUCJOperator.to_parameters()</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.RealUCJOperator.to_t_amplitudes"><code class="docutils literal notranslate"><span class="pre">RealUCJOperator.to_t_amplitudes()</span></code></a></li>
-</ul>
-</li>
 <li><a class="reference internal" href="#ffsim.SingleFactorizedHamiltonian"><code class="docutils literal notranslate"><span class="pre">SingleFactorizedHamiltonian</span></code></a><ul>
 <li><a class="reference internal" href="#ffsim.SingleFactorizedHamiltonian.one_body_tensor"><code class="docutils literal notranslate"><span class="pre">SingleFactorizedHamiltonian.one_body_tensor</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.SingleFactorizedHamiltonian.one_body_squares"><code class="docutils literal notranslate"><span class="pre">SingleFactorizedHamiltonian.one_body_squares</span></code></a></li>
@@ -5314,6 +4933,13 @@
 <li><a class="reference internal" href="#ffsim.SupportsFermionOperator"><code class="docutils literal notranslate"><span class="pre">SupportsFermionOperator</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.SupportsLinearOperator"><code class="docutils literal notranslate"><span class="pre">SupportsLinearOperator</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.SupportsTrace"><code class="docutils literal notranslate"><span class="pre">SupportsTrace</span></code></a></li>
+<li><a class="reference internal" href="#ffsim.UCCSDOpRestrictedReal"><code class="docutils literal notranslate"><span class="pre">UCCSDOpRestrictedReal</span></code></a><ul>
+<li><a class="reference internal" href="#ffsim.UCCSDOpRestrictedReal.from_parameters"><code class="docutils literal notranslate"><span class="pre">UCCSDOpRestrictedReal.from_parameters()</span></code></a></li>
+<li><a class="reference internal" href="#ffsim.UCCSDOpRestrictedReal.n_params"><code class="docutils literal notranslate"><span class="pre">UCCSDOpRestrictedReal.n_params()</span></code></a></li>
+<li><a class="reference internal" href="#ffsim.UCCSDOpRestrictedReal.norb"><code class="docutils literal notranslate"><span class="pre">UCCSDOpRestrictedReal.norb</span></code></a></li>
+<li><a class="reference internal" href="#ffsim.UCCSDOpRestrictedReal.to_parameters"><code class="docutils literal notranslate"><span class="pre">UCCSDOpRestrictedReal.to_parameters()</span></code></a></li>
+</ul>
+</li>
 <li><a class="reference internal" href="#ffsim.UCJOpSpinBalanced"><code class="docutils literal notranslate"><span class="pre">UCJOpSpinBalanced</span></code></a><ul>
 <li><a class="reference internal" href="#ffsim.UCJOpSpinBalanced.diag_coulomb_mats"><code class="docutils literal notranslate"><span class="pre">UCJOpSpinBalanced.diag_coulomb_mats</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.UCJOpSpinBalanced.orbital_rotations"><code class="docutils literal notranslate"><span class="pre">UCJOpSpinBalanced.orbital_rotations</span></code></a></li>
@@ -5350,20 +4976,6 @@
 <li><a class="reference internal" href="#ffsim.UCJOpSpinless.to_parameters"><code class="docutils literal notranslate"><span class="pre">UCJOpSpinless.to_parameters()</span></code></a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#ffsim.UCJOperator"><code class="docutils literal notranslate"><span class="pre">UCJOperator</span></code></a><ul>
-<li><a class="reference internal" href="#ffsim.UCJOperator.diag_coulomb_mats_alpha_alpha"><code class="docutils literal notranslate"><span class="pre">UCJOperator.diag_coulomb_mats_alpha_alpha</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.UCJOperator.diag_coulomb_mats_alpha_beta"><code class="docutils literal notranslate"><span class="pre">UCJOperator.diag_coulomb_mats_alpha_beta</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.UCJOperator.orbital_rotations"><code class="docutils literal notranslate"><span class="pre">UCJOperator.orbital_rotations</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.UCJOperator.final_orbital_rotation"><code class="docutils literal notranslate"><span class="pre">UCJOperator.final_orbital_rotation</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.UCJOperator.from_parameters"><code class="docutils literal notranslate"><span class="pre">UCJOperator.from_parameters()</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.UCJOperator.from_t_amplitudes"><code class="docutils literal notranslate"><span class="pre">UCJOperator.from_t_amplitudes()</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.UCJOperator.n_params"><code class="docutils literal notranslate"><span class="pre">UCJOperator.n_params()</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.UCJOperator.n_reps"><code class="docutils literal notranslate"><span class="pre">UCJOperator.n_reps</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.UCJOperator.norb"><code class="docutils literal notranslate"><span class="pre">UCJOperator.norb</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.UCJOperator.to_parameters"><code class="docutils literal notranslate"><span class="pre">UCJOperator.to_parameters()</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.UCJOperator.to_t_amplitudes"><code class="docutils literal notranslate"><span class="pre">UCJOperator.to_t_amplitudes()</span></code></a></li>
-</ul>
-</li>
 <li><a class="reference internal" href="#ffsim.addresses_to_strings"><code class="docutils literal notranslate"><span class="pre">addresses_to_strings()</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.apply_diag_coulomb_evolution"><code class="docutils literal notranslate"><span class="pre">apply_diag_coulomb_evolution()</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.apply_fsim_gate"><code class="docutils literal notranslate"><span class="pre">apply_fsim_gate()</span></code></a></li>
@@ -5409,6 +5021,7 @@
 <li><a class="reference internal" href="#ffsim.simulate_trotter_diag_coulomb_split_op"><code class="docutils literal notranslate"><span class="pre">simulate_trotter_diag_coulomb_split_op()</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.simulate_trotter_double_factorized"><code class="docutils literal notranslate"><span class="pre">simulate_trotter_double_factorized()</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.slater_determinant"><code class="docutils literal notranslate"><span class="pre">slater_determinant()</span></code></a></li>
+<li><a class="reference internal" href="#ffsim.slater_determinant_amplitudes"><code class="docutils literal notranslate"><span class="pre">slater_determinant_amplitudes()</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.slater_determinant_rdm"><code class="docutils literal notranslate"><span class="pre">slater_determinant_rdm()</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.slater_determinant_rdms"><code class="docutils literal notranslate"><span class="pre">slater_determinant_rdms()</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.spin_square"><code class="docutils literal notranslate"><span class="pre">spin_square()</span></code></a></li>
@@ -5426,7 +5039,7 @@
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/api/ffsim.linalg.html b/api/ffsim.linalg.html
index daf308b83..a06565674 100644
--- a/api/ffsim.linalg.html
+++ b/api/ffsim.linalg.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="ffsim.optimize" href="ffsim.optimize.html" /><link rel="prev" title="ffsim.contract" href="ffsim.contract.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.linalg - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.linalg - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -159,7 +159,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -183,7 +183,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -964,7 +964,7 @@
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/api/ffsim.optimize.html b/api/ffsim.optimize.html
index b6796e162..1321f3c47 100644
--- a/api/ffsim.optimize.html
+++ b/api/ffsim.optimize.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="ffsim.qiskit" href="ffsim.qiskit.html" /><link rel="prev" title="ffsim.linalg" href="ffsim.linalg.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.optimize - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.optimize - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -159,7 +159,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -183,7 +183,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -429,7 +429,7 @@
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/api/ffsim.qiskit.html b/api/ffsim.qiskit.html
index 234844f5c..8ca434397 100644
--- a/api/ffsim.qiskit.html
+++ b/api/ffsim.qiskit.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="ffsim.random" href="ffsim.random.html" /><link rel="prev" title="ffsim.optimize" href="ffsim.optimize.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.qiskit - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.qiskit - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -159,7 +159,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -183,7 +183,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -492,80 +492,6 @@
 
 </dd></dl>
 
-<dl class="py class">
-<dt class="sig sig-object py" id="ffsim.qiskit.GivensAnsatzOperatorJW">
-<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">ffsim.qiskit.</span></span><span class="sig-name descname"><span class="pre">GivensAnsatzOperatorJW</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">givens_ansatz_operator</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">label</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/qiskit/gates/givens_ansatz.html#GivensAnsatzOperatorJW"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.qiskit.GivensAnsatzOperatorJW" title="Link to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">Gate</span></code></p>
-<p>Givens rotation ansatz operator under the Jordan-Wigner transformation.</p>
-<div class="admonition warning">
-<p class="admonition-title">Warning</p>
-<p>This class is deprecated. Use <a class="reference internal" href="#ffsim.qiskit.GivensAnsatzOpJW" title="ffsim.qiskit.GivensAnsatzOpJW"><code class="xref py py-class docutils literal notranslate"><span class="pre">ffsim.qiskit.GivensAnsatzOpJW</span></code></a> instead.</p>
-</div>
-<p>See <a class="reference internal" href="ffsim.html#ffsim.GivensAnsatzOperator" title="ffsim.GivensAnsatzOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">ffsim.GivensAnsatzOperator</span></code></a> for a description of this gate’s unitary.</p>
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.qiskit.GivensAnsatzOperatorJW.__init__">
-<span class="sig-name descname"><span class="pre">__init__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">givens_ansatz_operator</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">label</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/qiskit/gates/givens_ansatz.html#GivensAnsatzOperatorJW.__init__"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.qiskit.GivensAnsatzOperatorJW.__init__" title="Link to this definition">¶</a></dt>
-<dd><p>Create a new Givens ansatz operator gate.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Parameters<span class="colon">:</span></dt>
-<dd class="field-odd"><ul class="simple">
-<li><p><strong>givens_ansatz_operator</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="ffsim.html#ffsim.GivensAnsatzOperator" title="ffsim.variational.givens.GivensAnsatzOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">GivensAnsatzOperator</span></code></a></span>) – The Givens rotation ansatz operator.</p></li>
-<li><p><strong>label</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></span>) – The label of the gate.</p></li>
-</ul>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.qiskit.GivensAnsatzOperatorJW.__init_subclass__">
-<span class="sig-name descname"><span class="pre">__init_subclass__</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#ffsim.qiskit.GivensAnsatzOperatorJW.__init_subclass__" title="Link to this definition">¶</a></dt>
-<dd><p>This method is called when a class is subclassed.</p>
-<p>The default implementation does nothing. It may be
-overridden to extend subclasses.</p>
-</dd></dl>
-
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.qiskit.GivensAnsatzOperatorJW.__new__">
-<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">__new__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#ffsim.qiskit.GivensAnsatzOperatorJW.__new__" title="Link to this definition">¶</a></dt>
-<dd></dd></dl>
-
-</dd></dl>
-
-<dl class="py class">
-<dt class="sig sig-object py" id="ffsim.qiskit.GivensAnsatzOperatorSpinlessJW">
-<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">ffsim.qiskit.</span></span><span class="sig-name descname"><span class="pre">GivensAnsatzOperatorSpinlessJW</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">givens_ansatz_operator</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">label</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/qiskit/gates/givens_ansatz.html#GivensAnsatzOperatorSpinlessJW"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.qiskit.GivensAnsatzOperatorSpinlessJW" title="Link to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">Gate</span></code></p>
-<p>Givens rotation ansatz operator under the Jordan-Wigner transformation, spinless.</p>
-<p>Like <a class="reference internal" href="#ffsim.qiskit.GivensAnsatzOperatorJW" title="ffsim.qiskit.GivensAnsatzOperatorJW"><code class="xref py py-class docutils literal notranslate"><span class="pre">GivensAnsatzOperatorJW</span></code></a> but only acts on a single spin species.</p>
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.qiskit.GivensAnsatzOperatorSpinlessJW.__init__">
-<span class="sig-name descname"><span class="pre">__init__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">givens_ansatz_operator</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">label</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/qiskit/gates/givens_ansatz.html#GivensAnsatzOperatorSpinlessJW.__init__"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.qiskit.GivensAnsatzOperatorSpinlessJW.__init__" title="Link to this definition">¶</a></dt>
-<dd><p>Create a new Givens ansatz operator gate.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Parameters<span class="colon">:</span></dt>
-<dd class="field-odd"><ul class="simple">
-<li><p><strong>givens_ansatz_operator</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="ffsim.html#ffsim.GivensAnsatzOperator" title="ffsim.variational.givens.GivensAnsatzOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">GivensAnsatzOperator</span></code></a></span>) – The Givens rotation ansatz operator.</p></li>
-<li><p><strong>label</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></span>) – The label of the gate.</p></li>
-</ul>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.qiskit.GivensAnsatzOperatorSpinlessJW.__init_subclass__">
-<span class="sig-name descname"><span class="pre">__init_subclass__</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#ffsim.qiskit.GivensAnsatzOperatorSpinlessJW.__init_subclass__" title="Link to this definition">¶</a></dt>
-<dd><p>This method is called when a class is subclassed.</p>
-<p>The default implementation does nothing. It may be
-overridden to extend subclasses.</p>
-</dd></dl>
-
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.qiskit.GivensAnsatzOperatorSpinlessJW.__new__">
-<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">__new__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#ffsim.qiskit.GivensAnsatzOperatorSpinlessJW.__new__" title="Link to this definition">¶</a></dt>
-<dd></dd></dl>
-
-</dd></dl>
-
 <dl class="py class">
 <dt class="sig sig-object py" id="ffsim.qiskit.MergeOrbitalRotations">
 <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">ffsim.qiskit.</span></span><span class="sig-name descname"><span class="pre">MergeOrbitalRotations</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/qiskit/transpiler_passes/merge_orbital_rotations.html#MergeOrbitalRotations"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.qiskit.MergeOrbitalRotations" title="Link to this definition">¶</a></dt>
@@ -1064,48 +990,6 @@
 
 </dd></dl>
 
-<dl class="py class">
-<dt class="sig sig-object py" id="ffsim.qiskit.UCJOperatorJW">
-<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">ffsim.qiskit.</span></span><span class="sig-name descname"><span class="pre">UCJOperatorJW</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ucj_operator</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">label</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/qiskit/gates/ucj_operator.html#UCJOperatorJW"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.qiskit.UCJOperatorJW" title="Link to this definition">¶</a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">Gate</span></code></p>
-<p>Unitary cluster Jastrow operator under the Jordan-Wigner transformation.</p>
-<div class="admonition warning">
-<p class="admonition-title">Warning</p>
-<p>This class is deprecated. Use <a class="reference internal" href="#ffsim.qiskit.UCJOpSpinBalancedJW" title="ffsim.qiskit.UCJOpSpinBalancedJW"><code class="xref py py-class docutils literal notranslate"><span class="pre">ffsim.qiskit.UCJOpSpinBalancedJW</span></code></a> instead.</p>
-</div>
-<p>See <a class="reference internal" href="ffsim.html#ffsim.UCJOperator" title="ffsim.UCJOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">ffsim.UCJOperator</span></code></a> for a description of this gate’s unitary.</p>
-<p>This gate assumes that qubits are ordered such that the first <cite>norb</cite> qubits
-correspond to the alpha orbitals and the last <cite>norb</cite> qubits correspond to the
-beta orbitals.</p>
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.qiskit.UCJOperatorJW.__init__">
-<span class="sig-name descname"><span class="pre">__init__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ucj_operator</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">label</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/qiskit/gates/ucj_operator.html#UCJOperatorJW.__init__"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.qiskit.UCJOperatorJW.__init__" title="Link to this definition">¶</a></dt>
-<dd><p>Create a new unitary cluster Jastrow (UCJ) gate.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Parameters<span class="colon">:</span></dt>
-<dd class="field-odd"><ul class="simple">
-<li><p><strong>ucj_operator</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="ffsim.html#ffsim.UCJOperator" title="ffsim.variational.ucj.UCJOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">UCJOperator</span></code></a></span>) – The UCJ operator.</p></li>
-<li><p><strong>label</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code> | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></span>) – The label of the gate.</p></li>
-</ul>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.qiskit.UCJOperatorJW.__init_subclass__">
-<span class="sig-name descname"><span class="pre">__init_subclass__</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#ffsim.qiskit.UCJOperatorJW.__init_subclass__" title="Link to this definition">¶</a></dt>
-<dd><p>This method is called when a class is subclassed.</p>
-<p>The default implementation does nothing. It may be
-overridden to extend subclasses.</p>
-</dd></dl>
-
-<dl class="py method">
-<dt class="sig sig-object py" id="ffsim.qiskit.UCJOperatorJW.__new__">
-<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">__new__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#ffsim.qiskit.UCJOperatorJW.__new__" title="Link to this definition">¶</a></dt>
-<dd></dd></dl>
-
-</dd></dl>
-
 <dl class="py function">
 <dt class="sig sig-object py" id="ffsim.qiskit.ffsim_vec_to_qiskit_vec">
 <span class="sig-prename descclassname"><span class="pre">ffsim.qiskit.</span></span><span class="sig-name descname"><span class="pre">ffsim_vec_to_qiskit_vec</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">vec</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">nelec</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/qiskit/util.html#ffsim_vec_to_qiskit_vec"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.qiskit.ffsim_vec_to_qiskit_vec" title="Link to this definition">¶</a></dt>
@@ -1183,7 +1067,7 @@
 :rtype: <span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">Iterator</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">BasePass</span></code>]</span></p>
 <ul class="simple">
 <li><p><a class="reference external" href="https://docs.quantum.ibm.com/api/qiskit/qiskit.transpiler.passes.Decompose#decompose">Decompose</a> pass that decomposes <a class="reference internal" href="#ffsim.qiskit.PrepareHartreeFockJW" title="ffsim.qiskit.PrepareHartreeFockJW"><code class="xref py py-class docutils literal notranslate"><span class="pre">PrepareHartreeFockJW</span></code></a> and
-<a class="reference internal" href="#ffsim.qiskit.UCJOperatorJW" title="ffsim.qiskit.UCJOperatorJW"><code class="xref py py-class docutils literal notranslate"><span class="pre">UCJOperatorJW</span></code></a> gates to expose the underlying
+<code class="xref py py-class docutils literal notranslate"><span class="pre">UCJOperatorJW</span></code> gates to expose the underlying
 <a class="reference internal" href="#ffsim.qiskit.PrepareSlaterDeterminantJW" title="ffsim.qiskit.PrepareSlaterDeterminantJW"><code class="xref py py-class docutils literal notranslate"><span class="pre">PrepareSlaterDeterminantJW</span></code></a> and <a class="reference internal" href="#ffsim.qiskit.OrbitalRotationJW" title="ffsim.qiskit.OrbitalRotationJW"><code class="xref py py-class docutils literal notranslate"><span class="pre">OrbitalRotationJW</span></code></a> gates.</p></li>
 <li><p><a class="reference internal" href="#ffsim.qiskit.MergeOrbitalRotations" title="ffsim.qiskit.MergeOrbitalRotations"><code class="xref py py-class docutils literal notranslate"><span class="pre">MergeOrbitalRotations</span></code></a> pass to merge the Slater determinant preparation
 and orbital rotation gates.</p></li>
@@ -1297,18 +1181,6 @@
 <li><a class="reference internal" href="#ffsim.qiskit.GivensAnsatzOpSpinlessJW.__init__"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOpSpinlessJW.__init__()</span></code></a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#ffsim.qiskit.GivensAnsatzOperatorJW"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOperatorJW</span></code></a><ul>
-<li><a class="reference internal" href="#ffsim.qiskit.GivensAnsatzOperatorJW.__init__"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOperatorJW.__init__()</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.qiskit.GivensAnsatzOperatorJW.__init_subclass__"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOperatorJW.__init_subclass__()</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.qiskit.GivensAnsatzOperatorJW.__new__"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOperatorJW.__new__()</span></code></a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#ffsim.qiskit.GivensAnsatzOperatorSpinlessJW"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOperatorSpinlessJW</span></code></a><ul>
-<li><a class="reference internal" href="#ffsim.qiskit.GivensAnsatzOperatorSpinlessJW.__init__"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOperatorSpinlessJW.__init__()</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.qiskit.GivensAnsatzOperatorSpinlessJW.__init_subclass__"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOperatorSpinlessJW.__init_subclass__()</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.qiskit.GivensAnsatzOperatorSpinlessJW.__new__"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOperatorSpinlessJW.__new__()</span></code></a></li>
-</ul>
-</li>
 <li><a class="reference internal" href="#ffsim.qiskit.MergeOrbitalRotations"><code class="docutils literal notranslate"><span class="pre">MergeOrbitalRotations</span></code></a><ul>
 <li><a class="reference internal" href="#ffsim.qiskit.MergeOrbitalRotations.run"><code class="docutils literal notranslate"><span class="pre">MergeOrbitalRotations.run()</span></code></a></li>
 </ul>
@@ -1374,12 +1246,6 @@
 <li><a class="reference internal" href="#ffsim.qiskit.UCJOpSpinlessJW.__init__"><code class="docutils literal notranslate"><span class="pre">UCJOpSpinlessJW.__init__()</span></code></a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#ffsim.qiskit.UCJOperatorJW"><code class="docutils literal notranslate"><span class="pre">UCJOperatorJW</span></code></a><ul>
-<li><a class="reference internal" href="#ffsim.qiskit.UCJOperatorJW.__init__"><code class="docutils literal notranslate"><span class="pre">UCJOperatorJW.__init__()</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.qiskit.UCJOperatorJW.__init_subclass__"><code class="docutils literal notranslate"><span class="pre">UCJOperatorJW.__init_subclass__()</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.qiskit.UCJOperatorJW.__new__"><code class="docutils literal notranslate"><span class="pre">UCJOperatorJW.__new__()</span></code></a></li>
-</ul>
-</li>
 <li><a class="reference internal" href="#ffsim.qiskit.ffsim_vec_to_qiskit_vec"><code class="docutils literal notranslate"><span class="pre">ffsim_vec_to_qiskit_vec()</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.qiskit.final_state_vector"><code class="docutils literal notranslate"><span class="pre">final_state_vector()</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.qiskit.jordan_wigner"><code class="docutils literal notranslate"><span class="pre">jordan_wigner()</span></code></a></li>
@@ -1396,7 +1262,7 @@
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/api/ffsim.random.html b/api/ffsim.random.html
index 63f40787a..8640ed11a 100644
--- a/api/ffsim.random.html
+++ b/api/ffsim.random.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="ffsim.testing" href="ffsim.testing.html" /><link rel="prev" title="ffsim.qiskit" href="ffsim.qiskit.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.random - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.random - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -159,7 +159,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -183,7 +183,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -611,46 +611,59 @@
 </dd></dl>
 
 <dl class="py function">
-<dt class="sig sig-object py" id="ffsim.random.random_ucj_op_spin_balanced">
-<span class="sig-prename descclassname"><span class="pre">ffsim.random.</span></span><span class="sig-name descname"><span class="pre">random_ucj_op_spin_balanced</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n_reps</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">with_final_orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">seed</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/random/random.html#random_ucj_op_spin_balanced"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.random.random_ucj_op_spin_balanced" title="Link to this definition">¶</a></dt>
-<dd><p>Sample a random spin-balanced unitary cluster Jastrow (UCJ) operator.</p>
+<dt class="sig sig-object py" id="ffsim.random.random_uccsd_restricted">
+<span class="sig-prename descclassname"><span class="pre">ffsim.random.</span></span><span class="sig-name descname"><span class="pre">random_uccsd_restricted</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">nocc</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">with_final_orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">real</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">seed</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/random/random.html#random_uccsd_restricted"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.random.random_uccsd_restricted" title="Link to this definition">¶</a></dt>
+<dd><p>Sample a random UCCSD operator.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
 <li><p><strong>norb</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of spatial orbitals.</p></li>
-<li><p><strong>n_reps</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of ansatz repetitions.</p></li>
+<li><p><strong>nocc</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of spatial orbitals that are occupied by electrons.</p></li>
 <li><p><strong>with_final_orbital_rotation</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code></span>) – Whether to include a final orbital rotation
 in the operator.</p></li>
+<li><p><strong>real</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code></span>) – Whether to sample a real-valued object rather than a complex-valued one.</p></li>
 <li><p><strong>seed</strong> – A seed to initialize the pseudorandom number generator.
 Should be a valid input to <code class="docutils literal notranslate"><span class="pre">np.random.default_rng</span></code>.</p></li>
 </ul>
 </dd>
 <dt class="field-even">Return type<span class="colon">:</span></dt>
-<dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="ffsim.html#ffsim.UCJOpSpinBalanced" title="ffsim.variational.ucj_spin_balanced.UCJOpSpinBalanced"><code class="xref py py-class docutils literal notranslate"><span class="pre">UCJOpSpinBalanced</span></code></a></span></p>
+<dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="ffsim.html#ffsim.UCCSDOpRestrictedReal" title="ffsim.variational.uccsd.UCCSDOpRestrictedReal"><code class="xref py py-class docutils literal notranslate"><span class="pre">UCCSDOpRestrictedReal</span></code></a></span></p>
 </dd>
 <dt class="field-odd">Returns<span class="colon">:</span></dt>
-<dd class="field-odd"><p>The sampled UCJ operator.</p>
+<dd class="field-odd"><p>The sampled UCCSD operator.</p>
 </dd>
 </dl>
 </dd></dl>
 
 <dl class="py function">
-<dt class="sig sig-object py" id="ffsim.random.random_ucj_op_spin_unbalanced">
-<span class="sig-prename descclassname"><span class="pre">ffsim.random.</span></span><span class="sig-name descname"><span class="pre">random_ucj_op_spin_unbalanced</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n_reps</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">with_final_orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">seed</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/random/random.html#random_ucj_op_spin_unbalanced"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.random.random_ucj_op_spin_unbalanced" title="Link to this definition">¶</a></dt>
-<dd><p>Sample a random spin-unbalanced unitary cluster Jastrow (UCJ) operator.</p>
+<dt class="sig sig-object py" id="ffsim.random.random_ucj_op_spin_balanced">
+<span class="sig-prename descclassname"><span class="pre">ffsim.random.</span></span><span class="sig-name descname"><span class="pre">random_ucj_op_spin_balanced</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n_reps</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">with_final_orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">interaction_pairs</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">seed</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/random/random.html#random_ucj_op_spin_balanced"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.random.random_ucj_op_spin_balanced" title="Link to this definition">¶</a></dt>
+<dd><p>Sample a random spin-balanced unitary cluster Jastrow (UCJ) operator.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
-<li><p><strong>norb</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of orbitals.</p></li>
+<li><p><strong>norb</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of spatial orbitals.</p></li>
 <li><p><strong>n_reps</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of ansatz repetitions.</p></li>
 <li><p><strong>with_final_orbital_rotation</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code></span>) – Whether to include a final orbital rotation
 in the operator.</p></li>
+<li><p><strong>interaction_pairs</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code>] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></span>) – Optional restrictions on allowed orbital interactions
+for the diagonal Coulomb operators.
+If specified, <cite>interaction_pairs</cite> should be a pair of lists,
+for alpha-alpha and alpha-beta interactions, in that order.
+Either list can be substituted with <code class="docutils literal notranslate"><span class="pre">None</span></code> to indicate no restrictions
+on interactions.
+Each list should contain pairs of integers representing the orbitals
+that are allowed to interact. These pairs can also be interpreted as
+indices of diagonal Coulomb matrix entries that are allowed to be
+nonzero.
+Each integer pair must be upper triangular, that is, of the form
+<span class="math notranslate nohighlight">\((i, j)\)</span> where <span class="math notranslate nohighlight">\(i \leq j\)</span>.</p></li>
 <li><p><strong>seed</strong> – A seed to initialize the pseudorandom number generator.
 Should be a valid input to <code class="docutils literal notranslate"><span class="pre">np.random.default_rng</span></code>.</p></li>
 </ul>
 </dd>
 <dt class="field-even">Return type<span class="colon">:</span></dt>
-<dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="ffsim.html#ffsim.UCJOpSpinUnbalanced" title="ffsim.variational.ucj_spin_unbalanced.UCJOpSpinUnbalanced"><code class="xref py py-class docutils literal notranslate"><span class="pre">UCJOpSpinUnbalanced</span></code></a></span></p>
+<dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="ffsim.html#ffsim.UCJOpSpinBalanced" title="ffsim.variational.ucj_spin_balanced.UCJOpSpinBalanced"><code class="xref py py-class docutils literal notranslate"><span class="pre">UCJOpSpinBalanced</span></code></a></span></p>
 </dd>
 <dt class="field-odd">Returns<span class="colon">:</span></dt>
 <dd class="field-odd"><p>The sampled UCJ operator.</p>
@@ -659,14 +672,27 @@
 </dd></dl>
 
 <dl class="py function">
-<dt class="sig sig-object py" id="ffsim.random.random_ucj_op_spinless">
-<span class="sig-prename descclassname"><span class="pre">ffsim.random.</span></span><span class="sig-name descname"><span class="pre">random_ucj_op_spinless</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n_reps</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">with_final_orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">seed</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/random/random.html#random_ucj_op_spinless"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.random.random_ucj_op_spinless" title="Link to this definition">¶</a></dt>
-<dd><p>Sample a random spinless unitary cluster Jastrow (UCJ) operator.</p>
+<dt class="sig sig-object py" id="ffsim.random.random_ucj_op_spin_unbalanced">
+<span class="sig-prename descclassname"><span class="pre">ffsim.random.</span></span><span class="sig-name descname"><span class="pre">random_ucj_op_spin_unbalanced</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n_reps</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">interaction_pairs</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">with_final_orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">seed</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/random/random.html#random_ucj_op_spin_unbalanced"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.random.random_ucj_op_spin_unbalanced" title="Link to this definition">¶</a></dt>
+<dd><p>Sample a random spin-unbalanced unitary cluster Jastrow (UCJ) operator.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
 <li><p><strong>norb</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of orbitals.</p></li>
 <li><p><strong>n_reps</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of ansatz repetitions.</p></li>
+<li><p><strong>interaction_pairs</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code>] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></span>) – Optional restrictions on allowed orbital interactions
+for the diagonal Coulomb operators.
+If specified, <cite>interaction_pairs</cite> should be a tuple of 3 lists,
+for alpha-alpha, alpha-beta, and beta-beta interactions, in that order.
+Any list can be substituted with <code class="docutils literal notranslate"><span class="pre">None</span></code> to indicate no restrictions
+on interactions.
+Each list should contain pairs of integers representing the orbitals
+that are allowed to interact. These pairs can also be interpreted as
+indices of diagonal Coulomb matrix entries that are allowed to be
+nonzero.
+For the alpha-alpha and beta-beta interactions, each integer
+pair must be upper triangular, that is, of the form <span class="math notranslate nohighlight">\((i, j)\)</span> where
+<span class="math notranslate nohighlight">\(i \leq j\)</span>.</p></li>
 <li><p><strong>with_final_orbital_rotation</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code></span>) – Whether to include a final orbital rotation
 in the operator.</p></li>
 <li><p><strong>seed</strong> – A seed to initialize the pseudorandom number generator.
@@ -674,7 +700,7 @@
 </ul>
 </dd>
 <dt class="field-even">Return type<span class="colon">:</span></dt>
-<dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="ffsim.html#ffsim.UCJOpSpinless" title="ffsim.variational.ucj_spinless.UCJOpSpinless"><code class="xref py py-class docutils literal notranslate"><span class="pre">UCJOpSpinless</span></code></a></span></p>
+<dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="ffsim.html#ffsim.UCJOpSpinUnbalanced" title="ffsim.variational.ucj_spin_unbalanced.UCJOpSpinUnbalanced"><code class="xref py py-class docutils literal notranslate"><span class="pre">UCJOpSpinUnbalanced</span></code></a></span></p>
 </dd>
 <dt class="field-odd">Returns<span class="colon">:</span></dt>
 <dd class="field-odd"><p>The sampled UCJ operator.</p>
@@ -683,9 +709,9 @@
 </dd></dl>
 
 <dl class="py function">
-<dt class="sig sig-object py" id="ffsim.random.random_ucj_operator">
-<span class="sig-prename descclassname"><span class="pre">ffsim.random.</span></span><span class="sig-name descname"><span class="pre">random_ucj_operator</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n_reps</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">with_final_orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">seed</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/random/random.html#random_ucj_operator"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.random.random_ucj_operator" title="Link to this definition">¶</a></dt>
-<dd><p>Sample a random unitary cluster Jastrow (UCJ) operator.</p>
+<dt class="sig sig-object py" id="ffsim.random.random_ucj_op_spinless">
+<span class="sig-prename descclassname"><span class="pre">ffsim.random.</span></span><span class="sig-name descname"><span class="pre">random_ucj_op_spinless</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">norb</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n_reps</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">interaction_pairs</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">with_final_orbital_rotation</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">seed</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/ffsim/random/random.html#random_ucj_op_spinless"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ffsim.random.random_ucj_op_spinless" title="Link to this definition">¶</a></dt>
+<dd><p>Sample a random spinless unitary cluster Jastrow (UCJ) operator.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
@@ -693,12 +719,20 @@
 <li><p><strong>n_reps</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></span>) – The number of ansatz repetitions.</p></li>
 <li><p><strong>with_final_orbital_rotation</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code></span>) – Whether to include a final orbital rotation
 in the operator.</p></li>
+<li><p><strong>interaction_pairs</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">tuple</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>]] | <code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></span>) – Optional restrictions on allowed orbital interactions
+for the diagonal Coulomb operators.
+If specified, <cite>interaction_pairs</cite> should be a list of integer pairs
+representing the orbitals that are allowed to interact. These pairs
+can also be interpreted as indices of diagonal Coulomb matrix entries
+that are allowed to be nonzero.
+Each integer pair must be upper triangular, that is, of the form
+<span class="math notranslate nohighlight">\((i, j)\)</span> where <span class="math notranslate nohighlight">\(i \leq j\)</span>.</p></li>
 <li><p><strong>seed</strong> – A seed to initialize the pseudorandom number generator.
 Should be a valid input to <code class="docutils literal notranslate"><span class="pre">np.random.default_rng</span></code>.</p></li>
 </ul>
 </dd>
 <dt class="field-even">Return type<span class="colon">:</span></dt>
-<dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="ffsim.html#ffsim.UCJOperator" title="ffsim.variational.ucj.UCJOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">UCJOperator</span></code></a></span></p>
+<dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="ffsim.html#ffsim.UCJOpSpinless" title="ffsim.variational.ucj_spinless.UCJOpSpinless"><code class="xref py py-class docutils literal notranslate"><span class="pre">UCJOpSpinless</span></code></a></span></p>
 </dd>
 <dt class="field-odd">Returns<span class="colon">:</span></dt>
 <dd class="field-odd"><p>The sampled UCJ operator.</p>
@@ -804,10 +838,10 @@
 <li><a class="reference internal" href="#ffsim.random.random_statevector"><code class="docutils literal notranslate"><span class="pre">random_statevector()</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.random.random_t2_amplitudes"><code class="docutils literal notranslate"><span class="pre">random_t2_amplitudes()</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.random.random_two_body_tensor"><code class="docutils literal notranslate"><span class="pre">random_two_body_tensor()</span></code></a></li>
+<li><a class="reference internal" href="#ffsim.random.random_uccsd_restricted"><code class="docutils literal notranslate"><span class="pre">random_uccsd_restricted()</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.random.random_ucj_op_spin_balanced"><code class="docutils literal notranslate"><span class="pre">random_ucj_op_spin_balanced()</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.random.random_ucj_op_spin_unbalanced"><code class="docutils literal notranslate"><span class="pre">random_ucj_op_spin_unbalanced()</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.random.random_ucj_op_spinless"><code class="docutils literal notranslate"><span class="pre">random_ucj_op_spinless()</span></code></a></li>
-<li><a class="reference internal" href="#ffsim.random.random_ucj_operator"><code class="docutils literal notranslate"><span class="pre">random_ucj_operator()</span></code></a></li>
 <li><a class="reference internal" href="#ffsim.random.random_unitary"><code class="docutils literal notranslate"><span class="pre">random_unitary()</span></code></a></li>
 </ul>
 </li>
@@ -820,10 +854,12 @@
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
     <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+    <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+    <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
     </body>
 </html>
\ No newline at end of file
diff --git a/api/ffsim.testing.html b/api/ffsim.testing.html
index 1261aa50f..777495851 100644
--- a/api/ffsim.testing.html
+++ b/api/ffsim.testing.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="prev" title="ffsim.random" href="ffsim.random.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim.testing - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim.testing - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -159,7 +159,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -183,7 +183,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -464,7 +464,7 @@
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/api/index.html b/api/index.html
index 328d13239..744769b58 100644
--- a/api/index.html
+++ b/api/index.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="ffsim" href="ffsim.html" /><link rel="prev" title="How to use ffsim’s Qiskit Sampler primitive" href="../how-to-guides/qiskit-sampler.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>API reference - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>API reference - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -159,7 +159,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -183,7 +183,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -285,13 +285,11 @@ <h1>API reference<a class="headerlink" href="#api-reference" title="Link to this
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.FermionAction"><code class="docutils literal notranslate"><span class="pre">FermionAction</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.FermionOperator"><code class="docutils literal notranslate"><span class="pre">FermionOperator</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.GivensAnsatzOp"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOp</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.GivensAnsatzOperator"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOperator</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.HopGateAnsatzOperator"><code class="docutils literal notranslate"><span class="pre">HopGateAnsatzOperator</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.MolecularData"><code class="docutils literal notranslate"><span class="pre">MolecularData</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.MolecularHamiltonian"><code class="docutils literal notranslate"><span class="pre">MolecularHamiltonian</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.NumNumAnsatzOpSpinBalanced"><code class="docutils literal notranslate"><span class="pre">NumNumAnsatzOpSpinBalanced</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.ProductStateSum"><code class="docutils literal notranslate"><span class="pre">ProductStateSum</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.RealUCJOperator"><code class="docutils literal notranslate"><span class="pre">RealUCJOperator</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.SingleFactorizedHamiltonian"><code class="docutils literal notranslate"><span class="pre">SingleFactorizedHamiltonian</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.Spin"><code class="docutils literal notranslate"><span class="pre">Spin</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.StateVector"><code class="docutils literal notranslate"><span class="pre">StateVector</span></code></a></li>
@@ -301,10 +299,10 @@ <h1>API reference<a class="headerlink" href="#api-reference" title="Link to this
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.SupportsFermionOperator"><code class="docutils literal notranslate"><span class="pre">SupportsFermionOperator</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.SupportsLinearOperator"><code class="docutils literal notranslate"><span class="pre">SupportsLinearOperator</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.SupportsTrace"><code class="docutils literal notranslate"><span class="pre">SupportsTrace</span></code></a></li>
+<li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.UCCSDOpRestrictedReal"><code class="docutils literal notranslate"><span class="pre">UCCSDOpRestrictedReal</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.UCJOpSpinBalanced"><code class="docutils literal notranslate"><span class="pre">UCJOpSpinBalanced</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.UCJOpSpinUnbalanced"><code class="docutils literal notranslate"><span class="pre">UCJOpSpinUnbalanced</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.UCJOpSpinless"><code class="docutils literal notranslate"><span class="pre">UCJOpSpinless</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.UCJOperator"><code class="docutils literal notranslate"><span class="pre">UCJOperator</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.addresses_to_strings"><code class="docutils literal notranslate"><span class="pre">addresses_to_strings()</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.apply_diag_coulomb_evolution"><code class="docutils literal notranslate"><span class="pre">apply_diag_coulomb_evolution()</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.apply_fsim_gate"><code class="docutils literal notranslate"><span class="pre">apply_fsim_gate()</span></code></a></li>
@@ -350,6 +348,7 @@ <h1>API reference<a class="headerlink" href="#api-reference" title="Link to this
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.simulate_trotter_diag_coulomb_split_op"><code class="docutils literal notranslate"><span class="pre">simulate_trotter_diag_coulomb_split_op()</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.simulate_trotter_double_factorized"><code class="docutils literal notranslate"><span class="pre">simulate_trotter_double_factorized()</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.slater_determinant"><code class="docutils literal notranslate"><span class="pre">slater_determinant()</span></code></a></li>
+<li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.slater_determinant_amplitudes"><code class="docutils literal notranslate"><span class="pre">slater_determinant_amplitudes()</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.slater_determinant_rdm"><code class="docutils literal notranslate"><span class="pre">slater_determinant_rdm()</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.slater_determinant_rdms"><code class="docutils literal notranslate"><span class="pre">slater_determinant_rdms()</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.html#ffsim.spin_square"><code class="docutils literal notranslate"><span class="pre">spin_square()</span></code></a></li>
@@ -399,8 +398,6 @@ <h1>API reference<a class="headerlink" href="#api-reference" title="Link to this
 <li class="toctree-l2"><a class="reference internal" href="ffsim.qiskit.html#ffsim.qiskit.FfsimSampler"><code class="docutils literal notranslate"><span class="pre">FfsimSampler</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.qiskit.html#ffsim.qiskit.GivensAnsatzOpJW"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOpJW</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.qiskit.html#ffsim.qiskit.GivensAnsatzOpSpinlessJW"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOpSpinlessJW</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="ffsim.qiskit.html#ffsim.qiskit.GivensAnsatzOperatorJW"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOperatorJW</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="ffsim.qiskit.html#ffsim.qiskit.GivensAnsatzOperatorSpinlessJW"><code class="docutils literal notranslate"><span class="pre">GivensAnsatzOperatorSpinlessJW</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.qiskit.html#ffsim.qiskit.MergeOrbitalRotations"><code class="docutils literal notranslate"><span class="pre">MergeOrbitalRotations</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.qiskit.html#ffsim.qiskit.NumNumAnsatzOpSpinBalancedJW"><code class="docutils literal notranslate"><span class="pre">NumNumAnsatzOpSpinBalancedJW</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.qiskit.html#ffsim.qiskit.NumOpSumEvolutionJW"><code class="docutils literal notranslate"><span class="pre">NumOpSumEvolutionJW</span></code></a></li>
@@ -417,7 +414,6 @@ <h1>API reference<a class="headerlink" href="#api-reference" title="Link to this
 <li class="toctree-l2"><a class="reference internal" href="ffsim.qiskit.html#ffsim.qiskit.UCJOpSpinBalancedJW"><code class="docutils literal notranslate"><span class="pre">UCJOpSpinBalancedJW</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.qiskit.html#ffsim.qiskit.UCJOpSpinUnbalancedJW"><code class="docutils literal notranslate"><span class="pre">UCJOpSpinUnbalancedJW</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.qiskit.html#ffsim.qiskit.UCJOpSpinlessJW"><code class="docutils literal notranslate"><span class="pre">UCJOpSpinlessJW</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="ffsim.qiskit.html#ffsim.qiskit.UCJOperatorJW"><code class="docutils literal notranslate"><span class="pre">UCJOperatorJW</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.qiskit.html#ffsim.qiskit.ffsim_vec_to_qiskit_vec"><code class="docutils literal notranslate"><span class="pre">ffsim_vec_to_qiskit_vec()</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.qiskit.html#ffsim.qiskit.final_state_vector"><code class="docutils literal notranslate"><span class="pre">final_state_vector()</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.qiskit.html#ffsim.qiskit.jordan_wigner"><code class="docutils literal notranslate"><span class="pre">jordan_wigner()</span></code></a></li>
@@ -440,10 +436,10 @@ <h1>API reference<a class="headerlink" href="#api-reference" title="Link to this
 <li class="toctree-l2"><a class="reference internal" href="ffsim.random.html#ffsim.random.random_statevector"><code class="docutils literal notranslate"><span class="pre">random_statevector()</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.random.html#ffsim.random.random_t2_amplitudes"><code class="docutils literal notranslate"><span class="pre">random_t2_amplitudes()</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.random.html#ffsim.random.random_two_body_tensor"><code class="docutils literal notranslate"><span class="pre">random_two_body_tensor()</span></code></a></li>
+<li class="toctree-l2"><a class="reference internal" href="ffsim.random.html#ffsim.random.random_uccsd_restricted"><code class="docutils literal notranslate"><span class="pre">random_uccsd_restricted()</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.random.html#ffsim.random.random_ucj_op_spin_balanced"><code class="docutils literal notranslate"><span class="pre">random_ucj_op_spin_balanced()</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.random.html#ffsim.random.random_ucj_op_spin_unbalanced"><code class="docutils literal notranslate"><span class="pre">random_ucj_op_spin_unbalanced()</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.random.html#ffsim.random.random_ucj_op_spinless"><code class="docutils literal notranslate"><span class="pre">random_ucj_op_spinless()</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="ffsim.random.html#ffsim.random.random_ucj_operator"><code class="docutils literal notranslate"><span class="pre">random_ucj_operator()</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="ffsim.random.html#ffsim.random.random_unitary"><code class="docutils literal notranslate"><span class="pre">random_unitary()</span></code></a></li>
 </ul>
 </li>
@@ -510,7 +506,7 @@ <h1>API reference<a class="headerlink" href="#api-reference" title="Link to this
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/explanations/double-factorized.html b/explanations/double-factorized.html
index f9c462335..1e78bca53 100644
--- a/explanations/double-factorized.html
+++ b/explanations/double-factorized.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="The local unitary cluster Jastrow (LUCJ) ansatz" href="lucj.html" /><link rel="prev" title="Orbital rotations and quadratic Hamiltonians" href="orbital-rotation.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>Double-factorized representation of the molecular Hamiltonian - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>Double-factorized representation of the molecular Hamiltonian - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -159,7 +159,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -183,7 +183,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -431,7 +431,7 @@ <h3>Application to the double-factorized Hamiltonian<a class="headerlink" href="
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/explanations/hamiltonians.html b/explanations/hamiltonians.html
index 4cefe94d6..0ca95f1b8 100644
--- a/explanations/hamiltonians.html
+++ b/explanations/hamiltonians.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Orbital rotations and quadratic Hamiltonians" href="orbital-rotation.html" /><link rel="prev" title="State vectors and gates" href="state-vectors-and-gates.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>Hamiltonians - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>Hamiltonians - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -160,7 +160,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -184,7 +184,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -377,7 +377,7 @@ <h2>Operator action via SciPy LinearOperators<a class="headerlink" href="#Operat
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-np.float64(-99.55717072551563)
+np.float64(-99.55717072551556)
 </pre></div></div>
 </div>
 <p>Time evolution by the Hamiltonian can be computed using <code class="docutils literal notranslate"><span class="pre">expm_multiply</span></code>:</p>
@@ -395,7 +395,7 @@ <h2>Operator action via SciPy LinearOperators<a class="headerlink" href="#Operat
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-/tmp/ipykernel_4237/2190712273.py:2: UserWarning: Trace of LinearOperator not available, it will be estimated. Provide `traceA` to ensure performance.
+/tmp/ipykernel_4175/2190712273.py:2: UserWarning: Trace of LinearOperator not available, it will be estimated. Provide `traceA` to ensure performance.
   evolved_vec = scipy.sparse.linalg.expm_multiply(-1j * time * linop, vec)
 </pre></div></div>
 </div>
@@ -483,7 +483,7 @@ <h2>Operator action via SciPy LinearOperators<a class="headerlink" href="#Operat
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/explanations/hamiltonians.ipynb b/explanations/hamiltonians.ipynb
index f6b911685..2252d2655 100644
--- a/explanations/hamiltonians.ipynb
+++ b/explanations/hamiltonians.ipynb
@@ -33,10 +33,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:03.485145Z",
-     "iopub.status.busy": "2024-10-10T17:21:03.484958Z",
-     "iopub.status.idle": "2024-10-10T17:21:04.191751Z",
-     "shell.execute_reply": "2024-10-10T17:21:04.191231Z"
+     "iopub.execute_input": "2024-10-30T17:26:54.772283Z",
+     "iopub.status.busy": "2024-10-30T17:26:54.772070Z",
+     "iopub.status.idle": "2024-10-30T17:26:55.493928Z",
+     "shell.execute_reply": "2024-10-30T17:26:55.493354Z"
     }
    },
    "outputs": [],
@@ -68,10 +68,10 @@
    "execution_count": 2,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:04.194153Z",
-     "iopub.status.busy": "2024-10-10T17:21:04.193867Z",
-     "iopub.status.idle": "2024-10-10T17:21:04.196762Z",
-     "shell.execute_reply": "2024-10-10T17:21:04.196291Z"
+     "iopub.execute_input": "2024-10-30T17:26:55.496452Z",
+     "iopub.status.busy": "2024-10-30T17:26:55.495975Z",
+     "iopub.status.idle": "2024-10-30T17:26:55.499145Z",
+     "shell.execute_reply": "2024-10-30T17:26:55.498671Z"
     }
    },
    "outputs": [],
@@ -99,10 +99,10 @@
    "execution_count": 3,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:04.198510Z",
-     "iopub.status.busy": "2024-10-10T17:21:04.198324Z",
-     "iopub.status.idle": "2024-10-10T17:21:04.201628Z",
-     "shell.execute_reply": "2024-10-10T17:21:04.201061Z"
+     "iopub.execute_input": "2024-10-30T17:26:55.500894Z",
+     "iopub.status.busy": "2024-10-30T17:26:55.500696Z",
+     "iopub.status.idle": "2024-10-30T17:26:55.504318Z",
+     "shell.execute_reply": "2024-10-30T17:26:55.503769Z"
     }
    },
    "outputs": [],
@@ -127,10 +127,10 @@
    "execution_count": 4,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:04.203659Z",
-     "iopub.status.busy": "2024-10-10T17:21:04.203329Z",
-     "iopub.status.idle": "2024-10-10T17:21:04.207886Z",
-     "shell.execute_reply": "2024-10-10T17:21:04.207317Z"
+     "iopub.execute_input": "2024-10-30T17:26:55.506488Z",
+     "iopub.status.busy": "2024-10-30T17:26:55.506167Z",
+     "iopub.status.idle": "2024-10-30T17:26:55.510814Z",
+     "shell.execute_reply": "2024-10-30T17:26:55.510264Z"
     }
    },
    "outputs": [],
@@ -152,17 +152,17 @@
    "execution_count": 5,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:04.210160Z",
-     "iopub.status.busy": "2024-10-10T17:21:04.209747Z",
-     "iopub.status.idle": "2024-10-10T17:21:04.235530Z",
-     "shell.execute_reply": "2024-10-10T17:21:04.234960Z"
+     "iopub.execute_input": "2024-10-30T17:26:55.513724Z",
+     "iopub.status.busy": "2024-10-30T17:26:55.513306Z",
+     "iopub.status.idle": "2024-10-30T17:26:55.541337Z",
+     "shell.execute_reply": "2024-10-30T17:26:55.540634Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "np.float64(-99.55717072551563)"
+       "np.float64(-99.55717072551556)"
       ]
      },
      "execution_count": 5,
@@ -191,10 +191,10 @@
    "execution_count": 6,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:04.270599Z",
-     "iopub.status.busy": "2024-10-10T17:21:04.270067Z",
-     "iopub.status.idle": "2024-10-10T17:21:04.933925Z",
-     "shell.execute_reply": "2024-10-10T17:21:04.933299Z"
+     "iopub.execute_input": "2024-10-30T17:26:55.572876Z",
+     "iopub.status.busy": "2024-10-30T17:26:55.572325Z",
+     "iopub.status.idle": "2024-10-30T17:26:56.238213Z",
+     "shell.execute_reply": "2024-10-30T17:26:56.237552Z"
     }
    },
    "outputs": [
@@ -202,7 +202,7 @@
      "name": "stderr",
      "output_type": "stream",
      "text": [
-      "/tmp/ipykernel_4237/2190712273.py:2: UserWarning: Trace of LinearOperator not available, it will be estimated. Provide `traceA` to ensure performance.\n",
+      "/tmp/ipykernel_4175/2190712273.py:2: UserWarning: Trace of LinearOperator not available, it will be estimated. Provide `traceA` to ensure performance.\n",
       "  evolved_vec = scipy.sparse.linalg.expm_multiply(-1j * time * linop, vec)\n"
      ]
     }
@@ -224,10 +224,10 @@
    "execution_count": 7,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:04.937758Z",
-     "iopub.status.busy": "2024-10-10T17:21:04.936948Z",
-     "iopub.status.idle": "2024-10-10T17:21:05.616394Z",
-     "shell.execute_reply": "2024-10-10T17:21:05.615709Z"
+     "iopub.execute_input": "2024-10-30T17:26:56.240996Z",
+     "iopub.status.busy": "2024-10-30T17:26:56.240500Z",
+     "iopub.status.idle": "2024-10-30T17:26:56.847408Z",
+     "shell.execute_reply": "2024-10-30T17:26:56.846761Z"
     }
    },
    "outputs": [],
diff --git a/explanations/index.html b/explanations/index.html
index 11cbd8713..c47dd7335 100644
--- a/explanations/index.html
+++ b/explanations/index.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="State vectors and gates" href="state-vectors-and-gates.html" /><link rel="prev" title="Implementing Trotter simulation of the double-factorized Hamiltonian" href="../tutorials/double-factorized-trotter.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>Explanations - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>Explanations - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -159,7 +159,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -183,7 +183,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -337,7 +337,7 @@ <h1>Explanations<a class="headerlink" href="#explanations" title="Link to this h
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/explanations/lucj.html b/explanations/lucj.html
index e561bd1cc..bc1d69e9d 100644
--- a/explanations/lucj.html
+++ b/explanations/lucj.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Qubit gate decompositions of fermionic gates" href="qiskit-gate-decompositions.html" /><link rel="prev" title="Double-factorized representation of the molecular Hamiltonian" href="double-factorized.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>The local unitary cluster Jastrow (LUCJ) ansatz - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>The local unitary cluster Jastrow (LUCJ) ansatz - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -159,7 +159,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -183,7 +183,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -388,7 +388,7 @@ <h2>The local UCJ (LUCJ) ansatz<a class="headerlink" href="#The-local-UCJ-(LUCJ)
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/explanations/orbital-rotation.html b/explanations/orbital-rotation.html
index 0ae0cb6b8..75956c66f 100644
--- a/explanations/orbital-rotation.html
+++ b/explanations/orbital-rotation.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Double-factorized representation of the molecular Hamiltonian" href="double-factorized.html" /><link rel="prev" title="Hamiltonians" href="hamiltonians.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>Orbital rotations and quadratic Hamiltonians - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>Orbital rotations and quadratic Hamiltonians - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -160,7 +160,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -184,7 +184,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -418,7 +418,7 @@ <h2>Time evolution by a quadratic Hamiltonian<a class="headerlink" href="#Time-e
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/explanations/orbital-rotation.ipynb b/explanations/orbital-rotation.ipynb
index 4cae8fee3..5c278adb8 100644
--- a/explanations/orbital-rotation.ipynb
+++ b/explanations/orbital-rotation.ipynb
@@ -62,10 +62,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:08.707558Z",
-     "iopub.status.busy": "2024-10-10T17:21:08.707362Z",
-     "iopub.status.idle": "2024-10-10T17:21:09.428870Z",
-     "shell.execute_reply": "2024-10-10T17:21:09.428214Z"
+     "iopub.execute_input": "2024-10-30T17:27:00.234613Z",
+     "iopub.status.busy": "2024-10-30T17:27:00.234418Z",
+     "iopub.status.idle": "2024-10-30T17:27:00.990409Z",
+     "shell.execute_reply": "2024-10-30T17:27:00.989866Z"
     }
    },
    "outputs": [],
diff --git a/explanations/qiskit-gate-decompositions.html b/explanations/qiskit-gate-decompositions.html
index 0c6011a42..ade8155d9 100644
--- a/explanations/qiskit-gate-decompositions.html
+++ b/explanations/qiskit-gate-decompositions.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="How-to guides" href="../how-to-guides/index.html" /><link rel="prev" title="The local unitary cluster Jastrow (LUCJ) ansatz" href="lucj.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>Qubit gate decompositions of fermionic gates - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>Qubit gate decompositions of fermionic gates - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -160,7 +160,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -184,7 +184,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -850,7 +850,7 @@ <h3>Locality in the UCJ operator<a class="headerlink" href="#Locality-in-the-UCJ
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/explanations/qiskit-gate-decompositions.ipynb b/explanations/qiskit-gate-decompositions.ipynb
index 64688c307..9096de595 100644
--- a/explanations/qiskit-gate-decompositions.ipynb
+++ b/explanations/qiskit-gate-decompositions.ipynb
@@ -16,10 +16,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:10.838944Z",
-     "iopub.status.busy": "2024-10-10T17:21:10.838758Z",
-     "iopub.status.idle": "2024-10-10T17:21:12.521911Z",
-     "shell.execute_reply": "2024-10-10T17:21:12.521256Z"
+     "iopub.execute_input": "2024-10-30T17:27:02.607124Z",
+     "iopub.status.busy": "2024-10-30T17:27:02.606924Z",
+     "iopub.status.idle": "2024-10-30T17:27:06.593316Z",
+     "shell.execute_reply": "2024-10-30T17:27:06.592711Z"
     }
    },
    "outputs": [
@@ -81,10 +81,10 @@
    "execution_count": 2,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:12.524449Z",
-     "iopub.status.busy": "2024-10-10T17:21:12.523996Z",
-     "iopub.status.idle": "2024-10-10T17:21:12.732271Z",
-     "shell.execute_reply": "2024-10-10T17:21:12.731653Z"
+     "iopub.execute_input": "2024-10-30T17:27:06.595577Z",
+     "iopub.status.busy": "2024-10-30T17:27:06.595122Z",
+     "iopub.status.idle": "2024-10-30T17:27:06.806346Z",
+     "shell.execute_reply": "2024-10-30T17:27:06.805818Z"
     }
    },
    "outputs": [
@@ -119,10 +119,10 @@
    "execution_count": 3,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:12.734452Z",
-     "iopub.status.busy": "2024-10-10T17:21:12.734123Z",
-     "iopub.status.idle": "2024-10-10T17:21:12.844935Z",
-     "shell.execute_reply": "2024-10-10T17:21:12.844366Z"
+     "iopub.execute_input": "2024-10-30T17:27:06.808476Z",
+     "iopub.status.busy": "2024-10-30T17:27:06.808177Z",
+     "iopub.status.idle": "2024-10-30T17:27:06.918391Z",
+     "shell.execute_reply": "2024-10-30T17:27:06.917877Z"
     }
    },
    "outputs": [
@@ -156,10 +156,10 @@
    "execution_count": 4,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:12.846966Z",
-     "iopub.status.busy": "2024-10-10T17:21:12.846594Z",
-     "iopub.status.idle": "2024-10-10T17:21:12.957794Z",
-     "shell.execute_reply": "2024-10-10T17:21:12.957286Z"
+     "iopub.execute_input": "2024-10-30T17:27:06.920436Z",
+     "iopub.status.busy": "2024-10-30T17:27:06.920128Z",
+     "iopub.status.idle": "2024-10-30T17:27:07.032871Z",
+     "shell.execute_reply": "2024-10-30T17:27:07.032260Z"
     }
    },
    "outputs": [
@@ -196,10 +196,10 @@
    "execution_count": 5,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:12.959672Z",
-     "iopub.status.busy": "2024-10-10T17:21:12.959480Z",
-     "iopub.status.idle": "2024-10-10T17:21:13.146846Z",
-     "shell.execute_reply": "2024-10-10T17:21:13.146311Z"
+     "iopub.execute_input": "2024-10-30T17:27:07.035167Z",
+     "iopub.status.busy": "2024-10-30T17:27:07.034794Z",
+     "iopub.status.idle": "2024-10-30T17:27:07.222737Z",
+     "shell.execute_reply": "2024-10-30T17:27:07.222077Z"
     }
    },
    "outputs": [
@@ -250,10 +250,10 @@
    "execution_count": 6,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:13.149032Z",
-     "iopub.status.busy": "2024-10-10T17:21:13.148655Z",
-     "iopub.status.idle": "2024-10-10T17:21:13.376897Z",
-     "shell.execute_reply": "2024-10-10T17:21:13.376293Z"
+     "iopub.execute_input": "2024-10-30T17:27:07.225066Z",
+     "iopub.status.busy": "2024-10-30T17:27:07.224663Z",
+     "iopub.status.idle": "2024-10-30T17:27:07.449531Z",
+     "shell.execute_reply": "2024-10-30T17:27:07.448982Z"
     }
    },
    "outputs": [
@@ -292,10 +292,10 @@
    "execution_count": 7,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:13.378856Z",
-     "iopub.status.busy": "2024-10-10T17:21:13.378656Z",
-     "iopub.status.idle": "2024-10-10T17:21:13.518126Z",
-     "shell.execute_reply": "2024-10-10T17:21:13.517518Z"
+     "iopub.execute_input": "2024-10-30T17:27:07.451843Z",
+     "iopub.status.busy": "2024-10-30T17:27:07.451401Z",
+     "iopub.status.idle": "2024-10-30T17:27:07.592320Z",
+     "shell.execute_reply": "2024-10-30T17:27:07.591710Z"
     }
    },
    "outputs": [
@@ -334,10 +334,10 @@
    "execution_count": 8,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:13.520233Z",
-     "iopub.status.busy": "2024-10-10T17:21:13.519894Z",
-     "iopub.status.idle": "2024-10-10T17:21:14.050224Z",
-     "shell.execute_reply": "2024-10-10T17:21:14.049601Z"
+     "iopub.execute_input": "2024-10-30T17:27:07.594907Z",
+     "iopub.status.busy": "2024-10-30T17:27:07.594473Z",
+     "iopub.status.idle": "2024-10-30T17:27:08.139898Z",
+     "shell.execute_reply": "2024-10-30T17:27:08.139294Z"
     }
    },
    "outputs": [
@@ -378,10 +378,10 @@
    "execution_count": 9,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:14.052407Z",
-     "iopub.status.busy": "2024-10-10T17:21:14.052071Z",
-     "iopub.status.idle": "2024-10-10T17:21:14.234624Z",
-     "shell.execute_reply": "2024-10-10T17:21:14.234012Z"
+     "iopub.execute_input": "2024-10-30T17:27:08.142187Z",
+     "iopub.status.busy": "2024-10-30T17:27:08.141809Z",
+     "iopub.status.idle": "2024-10-30T17:27:08.336062Z",
+     "shell.execute_reply": "2024-10-30T17:27:08.335369Z"
     }
    },
    "outputs": [
@@ -430,10 +430,10 @@
    "execution_count": 10,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:14.236774Z",
-     "iopub.status.busy": "2024-10-10T17:21:14.236343Z",
-     "iopub.status.idle": "2024-10-10T17:21:14.406477Z",
-     "shell.execute_reply": "2024-10-10T17:21:14.405936Z"
+     "iopub.execute_input": "2024-10-30T17:27:08.338832Z",
+     "iopub.status.busy": "2024-10-30T17:27:08.338387Z",
+     "iopub.status.idle": "2024-10-30T17:27:08.519514Z",
+     "shell.execute_reply": "2024-10-30T17:27:08.519002Z"
     }
    },
    "outputs": [
@@ -474,10 +474,10 @@
    "execution_count": 11,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:14.408510Z",
-     "iopub.status.busy": "2024-10-10T17:21:14.408306Z",
-     "iopub.status.idle": "2024-10-10T17:21:14.542693Z",
-     "shell.execute_reply": "2024-10-10T17:21:14.542205Z"
+     "iopub.execute_input": "2024-10-30T17:27:08.521659Z",
+     "iopub.status.busy": "2024-10-30T17:27:08.521281Z",
+     "iopub.status.idle": "2024-10-30T17:27:08.652145Z",
+     "shell.execute_reply": "2024-10-30T17:27:08.651538Z"
     }
    },
    "outputs": [
@@ -513,10 +513,10 @@
    "execution_count": 12,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:14.544729Z",
-     "iopub.status.busy": "2024-10-10T17:21:14.544359Z",
-     "iopub.status.idle": "2024-10-10T17:21:14.727510Z",
-     "shell.execute_reply": "2024-10-10T17:21:14.726960Z"
+     "iopub.execute_input": "2024-10-30T17:27:08.654309Z",
+     "iopub.status.busy": "2024-10-30T17:27:08.653918Z",
+     "iopub.status.idle": "2024-10-30T17:27:08.835091Z",
+     "shell.execute_reply": "2024-10-30T17:27:08.834516Z"
     }
    },
    "outputs": [
@@ -553,10 +553,10 @@
    "execution_count": 13,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:14.729474Z",
-     "iopub.status.busy": "2024-10-10T17:21:14.729278Z",
-     "iopub.status.idle": "2024-10-10T17:21:14.892263Z",
-     "shell.execute_reply": "2024-10-10T17:21:14.891740Z"
+     "iopub.execute_input": "2024-10-30T17:27:08.837363Z",
+     "iopub.status.busy": "2024-10-30T17:27:08.836939Z",
+     "iopub.status.idle": "2024-10-30T17:27:08.997578Z",
+     "shell.execute_reply": "2024-10-30T17:27:08.996943Z"
     }
    },
    "outputs": [
@@ -593,10 +593,10 @@
    "execution_count": 14,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:14.894273Z",
-     "iopub.status.busy": "2024-10-10T17:21:14.894078Z",
-     "iopub.status.idle": "2024-10-10T17:21:15.025893Z",
-     "shell.execute_reply": "2024-10-10T17:21:15.025410Z"
+     "iopub.execute_input": "2024-10-30T17:27:08.999532Z",
+     "iopub.status.busy": "2024-10-30T17:27:08.999338Z",
+     "iopub.status.idle": "2024-10-30T17:27:09.132483Z",
+     "shell.execute_reply": "2024-10-30T17:27:09.131862Z"
     }
    },
    "outputs": [
@@ -630,10 +630,10 @@
    "execution_count": 15,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:15.027712Z",
-     "iopub.status.busy": "2024-10-10T17:21:15.027520Z",
-     "iopub.status.idle": "2024-10-10T17:21:15.281421Z",
-     "shell.execute_reply": "2024-10-10T17:21:15.280677Z"
+     "iopub.execute_input": "2024-10-30T17:27:09.134646Z",
+     "iopub.status.busy": "2024-10-30T17:27:09.134280Z",
+     "iopub.status.idle": "2024-10-30T17:27:09.296639Z",
+     "shell.execute_reply": "2024-10-30T17:27:09.296017Z"
     }
    },
    "outputs": [
@@ -677,10 +677,10 @@
    "execution_count": 16,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:15.283721Z",
-     "iopub.status.busy": "2024-10-10T17:21:15.283332Z",
-     "iopub.status.idle": "2024-10-10T17:21:15.375513Z",
-     "shell.execute_reply": "2024-10-10T17:21:15.374999Z"
+     "iopub.execute_input": "2024-10-30T17:27:09.298921Z",
+     "iopub.status.busy": "2024-10-30T17:27:09.298567Z",
+     "iopub.status.idle": "2024-10-30T17:27:09.481927Z",
+     "shell.execute_reply": "2024-10-30T17:27:09.481306Z"
     }
    },
    "outputs": [
@@ -736,16 +736,16 @@
    "execution_count": 17,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:15.377520Z",
-     "iopub.status.busy": "2024-10-10T17:21:15.377187Z",
-     "iopub.status.idle": "2024-10-10T17:21:15.842745Z",
-     "shell.execute_reply": "2024-10-10T17:21:15.842201Z"
+     "iopub.execute_input": "2024-10-30T17:27:09.484154Z",
+     "iopub.status.busy": "2024-10-30T17:27:09.483807Z",
+     "iopub.status.idle": "2024-10-30T17:27:09.944385Z",
+     "shell.execute_reply": "2024-10-30T17:27:09.943758Z"
     }
    },
    "outputs": [
     {
      "data": {
-      "image/png": "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bVq8/ec///mAF00AP//5z5k9ezYjRozg/vvvL27Py8sjNzeXRo0aAdC0adPiocOSJFUmh3odLMuHH35Ix44dSUpKKm470GtjzZo1+frrr8u3cOk7DjYSpqioiPnz5x9wSYp9mjdvzrRp0/joo49466232LlzZ4n9a9asYcGCBbz33ntkZmbSokWLUv3T09OZM2eOS1eoXJX1HL1161Zq164NQK1atdi6dWup2/fu3Zvbb7+d8847r0T/5ORktm3bxubNm1mxYgVvvvkmffr04bnnngN8/yIFmWFXwI0ZM4ZwOMzpp59O+/btD9hn9uzZtGrViurVqx9wf7169QA477zz+Oqrr4rbJ0+eTN++fcu9ZkmSysvhvA4eyjPPPMNPfvKTEm0He22UKsp3R8J89tlnnHXWWWXe5rTTTqNq1aoAJCYmlhrR/84777Bjxw569erFiBEjDtq/efPmLFy4sDwPRyeow3mOrlu3Ltu3bwcgNzeXunXrlurz3nvv8frrrzNixIgS/fPy8qhTpw516tShc+fOVKtWjQsvvJClS5cer0OSVEkYdgXcvk//Hn744RLtaWlp5OTkAPD555/z7rvv0rdvX+bNm8cjjzxSom9ubi4AK1eu5KSTTipunzBhApdffnnxdk5OTpmfJkqSVNEO53XwUFauXMmAAQMYNWoUjz/+ODk5OQd8bdy5c+cB34RJx8N3R8JkZ2fTrFmzw7rtu+++S4sWLUp90Ll582ZCoRDvv/8+q1atYt68eQfs72gYlZfDeY7u0KED06ZNAyheb+vbCgoKAKhTpw41atTgpJNOIjc3l127dhX3P+uss9iwYQORSIQFCxYU/7/i+xcpuJIO3UVBlJKSUjx0/YYbbuCGG24AoE+fPvzyl78E4O6772bUqFHcf//9fPbZZyQkJPDUU08BUFhYyLJly2jVqlXxfU6dOpWLL764Yg9EkqSj8O3XQYDBgwfz/vvvs2LFCkaMGEHv3r2LXwdnzJgBwIsvvkhSUhJNmzbl1ltvLfXaOG3aNC666KKYHI9OHGPGjGHKlCl069btoCNhFi1axK233lqirW/fvjzwwAOsW7eOxx57jDfffLPU7erUqVO8NtK+0S8nn3zyQftLx8u3n6MbNmxI27Zt6d69O23btqVjx45s3LiRsWPHcu+999K/f3/y8/MJhULFz8d33XUXPXv2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",
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAABLsAAAMkCAYAAABQkSLjAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjkuMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8hTgPZAAAACXBIWXMAAA9hAAAPYQGoP6dpAADV7ElEQVR4nOzdeXxTVf7/8VeSlpbSltKyFShtoQXLUtoBQfYAFWUcUUAcRRQRxn0cZhR1WPwyI6joz+Wro6hfZERGFGUYEQdlUSICxcpSdkrLUva1bKV0TX5/RAKhG1Care/n45GHveee5Hzu9ZKcfHLOuQabzWZDRERERERERETEBxjdHYCIiIiIiIiIiMj1omSXiIiIiIiIiIj4DCW7RERERERERETEZyjZJSIiIiIiIiIiPkPJLhERERERERER8RlKdomIiIiIiIiIiM9QsktERERERERERHyGkl0iIiIiIiIiIuIzlOwSERERERERERGfoWSXiIiIiIiIiIj4DCW7RERERERERETEZyjZJSIiIiIiIiIiPkPJLhERERERERER8RlKdomIiIiIiIiIiM9QsktERERERERERHyGkl0iIiIiIiIiIuIzlOwSERERERERERGfoWSXiIiIiIiIiIj4DCW7RERERERERETEZyjZJSIiIiIiIiIiPkPJLhERERERERER8RlKdomIiIiIiIiIiM9QsktERERERERERHyGkl0iIiIiIiIiIuIzlOwSERERERERERGfoWSXiIiIiIiIiIj4DCW7RERERERERETEZyjZJSIiIiIiIiIiPkPJLhERERERERER8Rl+7g7AkxWezePktr3uDsNn1EtoTq2QoErr5RZB1hkXBFSGuFAI9ndP2yIiIiIiIiJSdUp2VeDktr18e8cEd4fhMwbMn0yjzjdUWi/rDIxe6YKAyjC9OyRFuKdtEREREREREak6TWMUERERERERERGfoWSXiIiIiIiIiIj4DCW7RERERERERETEZyjZJSIiIiIiIiIiPkML1ItPyBhv5tz2VAx+/hhMfgQ2vYEmw6cQ2qGfu0MTERERERERERfSyC7xGU2GTyF5Ti6JM49Qp3VXdr50JyXnTrs7LBERERERERFxISW7xOcY/QOof/MorPm55B/Kcnc4IiIiIiIiIuJCSnaJz7EWnOf4kukYg0IJbBLv7nBERERERERE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GA+v2OyU3Er/f184kl+Nu7fj0MrNVW5DREREpDpdGDUwefJkp/K4uDiys7MB2Lx5M0uWLOHWW28lPT2dKVOmONXt3LkzW7ZsIT8/n+Li8n84zMvLIyws7Lofg4iIr7t89G1mZiYxMTEVPufUqVOEhtq/c4eEhHDq1KkK67du3Zoff/wRm83GTz/9xOnTp4mMjCQjI4PFixfzwQcfcOLECQCio6PZsWNHlY5Jqp+SXdUgP+csALUblR6NVbthPXudE2cAOHfgWKk65/Y7l+XuO3ZFI7uKzxdQ8GvbAEGREeRe/lrZRwiKrPrq74dWbKLRTW2oFRpEaIsm7P5qJaZafgRFhhPZox2HftpU5TZERERE3CE8PJy8vDwAHnzwQZYtW8Z3331HUlIS48ePB+Dpp58G4Nlnn2XMmDGYzWaeeeYZAD755BOefvppPv74Y5599lkAli9fTv/+/d1wNCIi3ulKRt9u3boVs9ns9HjllVcICwvjzBn7d+6zZ89W+mPDwIEDOXbsGDfffDMNGjSgYcOGBAQEEBQURO3atenZsyc7d+68zkco1UljravBmZ0HObv3CLEDu3H4shFOsXd04+zeI5zZdQgAm7X0XN86zRo4bQdHNeDYusozxzar1Wk779AJGndte9lrNSTv0Iky61+NnC17sFmttPnD7zj6y3ZsViuHVmym1bAUghrW4+gv26/5tUVERESq24UvReUZOHAgS5cuJSUlxVG2dOlSx9+vv/46AM2aNXMqB3jggQccixlfsGDBAi1qLCJyFS7cMfdy8fHxzJs3D4A2bdpgsVhK1fnll1/47LPPuP3221m+fDl33313hW2ZTCamTZuGzWZjxIgRdO3aldzcXIKDg7HZbKxZs4Ynn3wSgOzsbLp37171A5RqpZFd1STthY+J+30f2j5yO/7BtfEPCaLNI78j7u4+pE38Z4XPbXxTG6L6d8JgMtJicE/qtYlmz39XX3UMu+evolGXBKJv64LBaKRpnySibunEzrnLATh//DR1mta/5rtAHl61hTYP38ahFfZRXIdWbqLNw7dxdO0OSgqKruk1RURERDzBAw884JToqqp3333XcdcvERG5dh06dCAjI6PCOjfeeCMFBQX07NmTDh060KhRIw4fPuy40yJASkoK69evJyUlheXLl2M2m+nXrx933XUXQUFBrFq1ik6dOtGt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5vXXX+e5555jw4YNGI1G3n33XQD+/ve/Y7FYaNq0KR988AFg/xF0wIABbjkeT/DRRx+xdOlSevToUe4ouq1bt/L44487ld16662lZk60bNmywrYGDhzI4sWLufnmm2nQoAENGzYkICDAsb9nz57s3LmTiIiIqh2UiI9RskukBjKbzZjN5nL3Dxw4kKVLl5KSksLEiROZOHGiY1/jxo0ZO3YsYJ+2uHr1aqfnvvfee6Ve78MPP3TazsnJISwsjJCQkCochYiIiIjA1fXt/vWvf5Xa//rrrwNl9+NeeOEFXnjhBaeyn3/+mYcffrhqQXuxUaNGMWHChFLl8fHxzJs3D4A2bdqUeTOmX375hc8++4zbb7+d5cuXc/fdd1fYlslkYtq0adhsNkaMGEHXrl3Jzc0lODgYm83GmjVrePLJJwH7iLvu3btX/QBFfICmMYpIKQ888AApKSnV9vrh4eFau0tERETERa533+6f//wnRqO+Sl6uQ4cOZGRkVFjnxhtvpKCggJ49e9KhQwcaNWrE4cOHHXdaBEhJSWH9+vWkpKSwfPlyzGYz/fr146677iIoKIhVq1bRqVMnunXrRv/+/YmMjATsNyNo165dtR6jiLfQyC4RERERERGRK1DRKDqj0UhiYiKZmZkVrml2YYroBZfOnABYunSp0/7LR4j179+f/v37O5Vt27aNjh07YjAYruAoRHyfkl0iIiIiIiIi10FZ0xtdISEhgYSEBLe0LeKJNPZURERERERERER8hpJdIiIiIiIiIiLiM5TsEhERERERERERn6E1u8Tj5BZB1hn3tB0XCsH+7mlbRERERERERKpOyS7xOFlnYPRK97Q9vTskRbinbRERERERERGpOk1jFBERERERERERn6Fkl4iIiIiIiIiI+Awlu0RERERERERExGdozS7xCRnjzZzbnorBzx+DyY/ApjfQZPgUQjv0c3doIiIiIiIiIuJCGtklPqPJ8Ckkz8klceYR6rTuys6X7qTk3Gl3hyUiIiIiIiIiLqRkl/gco38A9W8ehTU/l/xDWe4OR0RERERERERcSMku8TnWgvMcXzIdY1AogU3i3R2OiIiIiIiIiLiQ1yS7CgsLmThxIlFRUdSuXZu+ffuSlpaGwWBg/vz57g5PPMDB2RNJHxbGpj/EkLd7A3ETvsEUFOrusERERERERETEhbxigXqb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",
       "text/plain": [
        "<Figure size 1547.39x1018.38 with 1 Axes>"
       ]
@@ -776,10 +776,10 @@
    "execution_count": 18,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:15.844900Z",
-     "iopub.status.busy": "2024-10-10T17:21:15.844504Z",
-     "iopub.status.idle": "2024-10-10T17:21:16.106211Z",
-     "shell.execute_reply": "2024-10-10T17:21:16.105617Z"
+     "iopub.execute_input": "2024-10-30T17:27:09.946610Z",
+     "iopub.status.busy": "2024-10-30T17:27:09.946246Z",
+     "iopub.status.idle": "2024-10-30T17:27:10.205482Z",
+     "shell.execute_reply": "2024-10-30T17:27:10.204872Z"
     }
    },
    "outputs": [
diff --git a/explanations/state-vectors-and-gates.html b/explanations/state-vectors-and-gates.html
index b2dd73181..96fea79b2 100644
--- a/explanations/state-vectors-and-gates.html
+++ b/explanations/state-vectors-and-gates.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Hamiltonians" href="hamiltonians.html" /><link rel="prev" title="Explanations" href="index.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>State vectors and gates - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>State vectors and gates - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -160,7 +160,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -184,7 +184,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -563,7 +563,7 @@ <h2>Treating spinless fermions<a class="headerlink" href="#Treating-spinless-fer
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/explanations/state-vectors-and-gates.ipynb b/explanations/state-vectors-and-gates.ipynb
index a8d4b3f18..03037223a 100644
--- a/explanations/state-vectors-and-gates.ipynb
+++ b/explanations/state-vectors-and-gates.ipynb
@@ -26,10 +26,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:18.719941Z",
-     "iopub.status.busy": "2024-10-10T17:21:18.719728Z",
-     "iopub.status.idle": "2024-10-10T17:21:19.426888Z",
-     "shell.execute_reply": "2024-10-10T17:21:19.426214Z"
+     "iopub.execute_input": "2024-10-30T17:27:12.686986Z",
+     "iopub.status.busy": "2024-10-30T17:27:12.686516Z",
+     "iopub.status.idle": "2024-10-30T17:27:13.446932Z",
+     "shell.execute_reply": "2024-10-30T17:27:13.446285Z"
     }
    },
    "outputs": [
@@ -74,10 +74,10 @@
    "execution_count": 2,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:19.429569Z",
-     "iopub.status.busy": "2024-10-10T17:21:19.429034Z",
-     "iopub.status.idle": "2024-10-10T17:21:19.436074Z",
-     "shell.execute_reply": "2024-10-10T17:21:19.435556Z"
+     "iopub.execute_input": "2024-10-30T17:27:13.449473Z",
+     "iopub.status.busy": "2024-10-30T17:27:13.448898Z",
+     "iopub.status.idle": "2024-10-30T17:27:13.457314Z",
+     "shell.execute_reply": "2024-10-30T17:27:13.456674Z"
     }
    },
    "outputs": [
@@ -120,10 +120,10 @@
    "execution_count": 3,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:19.438001Z",
-     "iopub.status.busy": "2024-10-10T17:21:19.437662Z",
-     "iopub.status.idle": "2024-10-10T17:21:19.441804Z",
-     "shell.execute_reply": "2024-10-10T17:21:19.441353Z"
+     "iopub.execute_input": "2024-10-30T17:27:13.459711Z",
+     "iopub.status.busy": "2024-10-30T17:27:13.459291Z",
+     "iopub.status.idle": "2024-10-30T17:27:13.464094Z",
+     "shell.execute_reply": "2024-10-30T17:27:13.463424Z"
     }
    },
    "outputs": [
@@ -157,10 +157,10 @@
    "execution_count": 4,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:19.443651Z",
-     "iopub.status.busy": "2024-10-10T17:21:19.443311Z",
-     "iopub.status.idle": "2024-10-10T17:21:19.447166Z",
-     "shell.execute_reply": "2024-10-10T17:21:19.446717Z"
+     "iopub.execute_input": "2024-10-30T17:27:13.466363Z",
+     "iopub.status.busy": "2024-10-30T17:27:13.465887Z",
+     "iopub.status.idle": "2024-10-30T17:27:13.470532Z",
+     "shell.execute_reply": "2024-10-30T17:27:13.469937Z"
     }
    },
    "outputs": [
@@ -199,10 +199,10 @@
    "execution_count": 5,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:19.449198Z",
-     "iopub.status.busy": "2024-10-10T17:21:19.448854Z",
-     "iopub.status.idle": "2024-10-10T17:21:19.454457Z",
-     "shell.execute_reply": "2024-10-10T17:21:19.453944Z"
+     "iopub.execute_input": "2024-10-30T17:27:13.472845Z",
+     "iopub.status.busy": "2024-10-30T17:27:13.472504Z",
+     "iopub.status.idle": "2024-10-30T17:27:13.478847Z",
+     "shell.execute_reply": "2024-10-30T17:27:13.478263Z"
     }
    },
    "outputs": [
@@ -245,10 +245,10 @@
    "execution_count": 6,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:19.456383Z",
-     "iopub.status.busy": "2024-10-10T17:21:19.456043Z",
-     "iopub.status.idle": "2024-10-10T17:21:19.461634Z",
-     "shell.execute_reply": "2024-10-10T17:21:19.461104Z"
+     "iopub.execute_input": "2024-10-30T17:27:13.480833Z",
+     "iopub.status.busy": "2024-10-30T17:27:13.480646Z",
+     "iopub.status.idle": "2024-10-30T17:27:13.488132Z",
+     "shell.execute_reply": "2024-10-30T17:27:13.487481Z"
     }
    },
    "outputs": [
@@ -293,10 +293,10 @@
    "execution_count": 7,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:19.463650Z",
-     "iopub.status.busy": "2024-10-10T17:21:19.463330Z",
-     "iopub.status.idle": "2024-10-10T17:21:19.468339Z",
-     "shell.execute_reply": "2024-10-10T17:21:19.467756Z"
+     "iopub.execute_input": "2024-10-30T17:27:13.490610Z",
+     "iopub.status.busy": "2024-10-30T17:27:13.490421Z",
+     "iopub.status.idle": "2024-10-30T17:27:13.495381Z",
+     "shell.execute_reply": "2024-10-30T17:27:13.494922Z"
     }
    },
    "outputs": [
diff --git a/genindex.html b/genindex.html
index 01f03267c..38c0aad8c 100644
--- a/genindex.html
+++ b/genindex.html
@@ -4,7 +4,7 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="#" /><link rel="search" title="Search" href="search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 --><title>Index - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 --><title>Index - ffsim 0.0.48</title>
 <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -157,7 +157,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -181,7 +181,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -279,10 +279,6 @@ <h2>_</h2>
           <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.DropNegligible.__init__">(ffsim.qiskit.DropNegligible method)</a>
 </li>
           <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.FfsimSampler.__init__">(ffsim.qiskit.FfsimSampler method)</a>
-</li>
-          <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.GivensAnsatzOperatorJW.__init__">(ffsim.qiskit.GivensAnsatzOperatorJW method)</a>
-</li>
-          <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.GivensAnsatzOperatorSpinlessJW.__init__">(ffsim.qiskit.GivensAnsatzOperatorSpinlessJW method)</a>
 </li>
           <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.GivensAnsatzOpJW.__init__">(ffsim.qiskit.GivensAnsatzOpJW method)</a>
 </li>
@@ -309,32 +305,12 @@ <h2>_</h2>
           <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.SimulateTrotterDiagCoulombSplitOpJW.__init__">(ffsim.qiskit.SimulateTrotterDiagCoulombSplitOpJW method)</a>
 </li>
           <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.SimulateTrotterDoubleFactorizedJW.__init__">(ffsim.qiskit.SimulateTrotterDoubleFactorizedJW method)</a>
-</li>
-          <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.UCJOperatorJW.__init__">(ffsim.qiskit.UCJOperatorJW method)</a>
 </li>
           <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.UCJOpSpinBalancedJW.__init__">(ffsim.qiskit.UCJOpSpinBalancedJW method)</a>
 </li>
           <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.UCJOpSpinlessJW.__init__">(ffsim.qiskit.UCJOpSpinlessJW method)</a>
 </li>
           <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.UCJOpSpinUnbalancedJW.__init__">(ffsim.qiskit.UCJOpSpinUnbalancedJW method)</a>
-</li>
-        </ul></li>
-    </ul></td>
-    <td style="width: 33%; vertical-align: top;"><ul>
-        <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.GivensAnsatzOperatorJW.__init_subclass__">__init_subclass__() (ffsim.qiskit.GivensAnsatzOperatorJW method)</a>
-
-        <ul>
-          <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.GivensAnsatzOperatorSpinlessJW.__init_subclass__">(ffsim.qiskit.GivensAnsatzOperatorSpinlessJW method)</a>
-</li>
-          <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.UCJOperatorJW.__init_subclass__">(ffsim.qiskit.UCJOperatorJW method)</a>
-</li>
-        </ul></li>
-        <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.GivensAnsatzOperatorJW.__new__">__new__() (ffsim.qiskit.GivensAnsatzOperatorJW static method)</a>
-
-        <ul>
-          <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.GivensAnsatzOperatorSpinlessJW.__new__">(ffsim.qiskit.GivensAnsatzOperatorSpinlessJW static method)</a>
-</li>
-          <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.UCJOperatorJW.__new__">(ffsim.qiskit.UCJOperatorJW static method)</a>
 </li>
         </ul></li>
     </ul></td>
@@ -489,22 +465,10 @@ <h2>D</h2>
           <li><a href="api/ffsim.html#ffsim.UCJOpSpinless.diag_coulomb_mats">(ffsim.UCJOpSpinless attribute)</a>
 </li>
           <li><a href="api/ffsim.html#ffsim.UCJOpSpinUnbalanced.diag_coulomb_mats">(ffsim.UCJOpSpinUnbalanced attribute)</a>
-</li>
-        </ul></li>
-        <li><a href="api/ffsim.html#ffsim.RealUCJOperator.diag_coulomb_mats_alpha_alpha">diag_coulomb_mats_alpha_alpha (ffsim.RealUCJOperator attribute)</a>
-
-        <ul>
-          <li><a href="api/ffsim.html#ffsim.UCJOperator.diag_coulomb_mats_alpha_alpha">(ffsim.UCJOperator attribute)</a>
 </li>
         </ul></li>
     </ul></td>
     <td style="width: 33%; vertical-align: top;"><ul>
-        <li><a href="api/ffsim.html#ffsim.RealUCJOperator.diag_coulomb_mats_alpha_beta">diag_coulomb_mats_alpha_beta (ffsim.RealUCJOperator attribute)</a>
-
-        <ul>
-          <li><a href="api/ffsim.html#ffsim.UCJOperator.diag_coulomb_mats_alpha_beta">(ffsim.UCJOperator attribute)</a>
-</li>
-        </ul></li>
         <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.DiagCoulombEvolutionJW">DiagCoulombEvolutionJW (class in ffsim.qiskit)</a>
 </li>
         <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.DiagCoulombEvolutionSpinlessJW">DiagCoulombEvolutionSpinlessJW (class in ffsim.qiskit)</a>
@@ -623,10 +587,6 @@ <h2>F</h2>
         <li><a href="api/ffsim.html#ffsim.HopGateAnsatzOperator.final_orbital_rotation">final_orbital_rotation (ffsim.HopGateAnsatzOperator attribute)</a>
 
         <ul>
-          <li><a href="api/ffsim.html#ffsim.RealUCJOperator.final_orbital_rotation">(ffsim.RealUCJOperator attribute)</a>
-</li>
-          <li><a href="api/ffsim.html#ffsim.UCJOperator.final_orbital_rotation">(ffsim.UCJOperator attribute)</a>
-</li>
           <li><a href="api/ffsim.html#ffsim.UCJOpSpinBalanced.final_orbital_rotation">(ffsim.UCJOpSpinBalanced attribute)</a>
 </li>
           <li><a href="api/ffsim.html#ffsim.UCJOpSpinless.final_orbital_rotation">(ffsim.UCJOpSpinless attribute)</a>
@@ -663,15 +623,11 @@ <h2>F</h2>
         <li><a href="api/ffsim.html#ffsim.GivensAnsatzOp.from_parameters">from_parameters() (ffsim.GivensAnsatzOp static method)</a>
 
         <ul>
-          <li><a href="api/ffsim.html#ffsim.GivensAnsatzOperator.from_parameters">(ffsim.GivensAnsatzOperator static method)</a>
-</li>
           <li><a href="api/ffsim.html#ffsim.HopGateAnsatzOperator.from_parameters">(ffsim.HopGateAnsatzOperator static method)</a>
 </li>
           <li><a href="api/ffsim.html#ffsim.NumNumAnsatzOpSpinBalanced.from_parameters">(ffsim.NumNumAnsatzOpSpinBalanced static method)</a>
 </li>
-          <li><a href="api/ffsim.html#ffsim.RealUCJOperator.from_parameters">(ffsim.RealUCJOperator static method)</a>
-</li>
-          <li><a href="api/ffsim.html#ffsim.UCJOperator.from_parameters">(ffsim.UCJOperator static method)</a>
+          <li><a href="api/ffsim.html#ffsim.UCCSDOpRestrictedReal.from_parameters">(ffsim.UCCSDOpRestrictedReal static method)</a>
 </li>
           <li><a href="api/ffsim.html#ffsim.UCJOpSpinBalanced.from_parameters">(ffsim.UCJOpSpinBalanced static method)</a>
 </li>
@@ -682,13 +638,9 @@ <h2>F</h2>
         </ul></li>
         <li><a href="api/ffsim.html#ffsim.MolecularData.from_scf">from_scf() (ffsim.MolecularData static method)</a>
 </li>
-        <li><a href="api/ffsim.html#ffsim.RealUCJOperator.from_t_amplitudes">from_t_amplitudes() (ffsim.RealUCJOperator static method)</a>
+        <li><a href="api/ffsim.html#ffsim.UCJOpSpinBalanced.from_t_amplitudes">from_t_amplitudes() (ffsim.UCJOpSpinBalanced static method)</a>
 
         <ul>
-          <li><a href="api/ffsim.html#ffsim.UCJOperator.from_t_amplitudes">(ffsim.UCJOperator static method)</a>
-</li>
-          <li><a href="api/ffsim.html#ffsim.UCJOpSpinBalanced.from_t_amplitudes">(ffsim.UCJOpSpinBalanced static method)</a>
-</li>
           <li><a href="api/ffsim.html#ffsim.UCJOpSpinless.from_t_amplitudes">(ffsim.UCJOpSpinless static method)</a>
 </li>
           <li><a href="api/ffsim.html#ffsim.UCJOpSpinUnbalanced.from_t_amplitudes">(ffsim.UCJOpSpinUnbalanced static method)</a>
@@ -709,18 +661,12 @@ <h2>G</h2>
         <li><a href="api/ffsim.testing.html#ffsim.testing.generate_norb_nocc">generate_norb_nocc() (in module ffsim.testing)</a>
 </li>
         <li><a href="api/ffsim.testing.html#ffsim.testing.generate_norb_spin">generate_norb_spin() (in module ffsim.testing)</a>
-</li>
-        <li><a href="api/ffsim.linalg.html#ffsim.linalg.givens_decomposition">givens_decomposition() (in module ffsim.linalg)</a>
-</li>
-        <li><a href="api/ffsim.html#ffsim.GivensAnsatzOp">GivensAnsatzOp (class in ffsim)</a>
 </li>
     </ul></td>
     <td style="width: 33%; vertical-align: top;"><ul>
-        <li><a href="api/ffsim.html#ffsim.GivensAnsatzOperator">GivensAnsatzOperator (class in ffsim)</a>
-</li>
-        <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.GivensAnsatzOperatorJW">GivensAnsatzOperatorJW (class in ffsim.qiskit)</a>
+        <li><a href="api/ffsim.linalg.html#ffsim.linalg.givens_decomposition">givens_decomposition() (in module ffsim.linalg)</a>
 </li>
-        <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.GivensAnsatzOperatorSpinlessJW">GivensAnsatzOperatorSpinlessJW (class in ffsim.qiskit)</a>
+        <li><a href="api/ffsim.html#ffsim.GivensAnsatzOp">GivensAnsatzOp (class in ffsim)</a>
 </li>
         <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.GivensAnsatzOpJW">GivensAnsatzOpJW (class in ffsim.qiskit)</a>
 </li>
@@ -769,8 +715,6 @@ <h2>I</h2>
         <li><a href="api/ffsim.html#ffsim.GivensAnsatzOp.interaction_pairs">interaction_pairs (ffsim.GivensAnsatzOp attribute)</a>
 
         <ul>
-          <li><a href="api/ffsim.html#ffsim.GivensAnsatzOperator.interaction_pairs">(ffsim.GivensAnsatzOperator attribute)</a>
-</li>
           <li><a href="api/ffsim.html#ffsim.HopGateAnsatzOperator.interaction_pairs">(ffsim.HopGateAnsatzOperator attribute)</a>
 </li>
           <li><a href="api/ffsim.html#ffsim.NumNumAnsatzOpSpinBalanced.interaction_pairs">(ffsim.NumNumAnsatzOpSpinBalanced attribute)</a>
@@ -902,9 +846,7 @@ <h2>N</h2>
         <ul>
           <li><a href="api/ffsim.html#ffsim.NumNumAnsatzOpSpinBalanced.n_params">(ffsim.NumNumAnsatzOpSpinBalanced static method)</a>
 </li>
-          <li><a href="api/ffsim.html#ffsim.RealUCJOperator.n_params">(ffsim.RealUCJOperator static method)</a>
-</li>
-          <li><a href="api/ffsim.html#ffsim.UCJOperator.n_params">(ffsim.UCJOperator static method)</a>
+          <li><a href="api/ffsim.html#ffsim.UCCSDOpRestrictedReal.n_params">(ffsim.UCCSDOpRestrictedReal static method)</a>
 </li>
           <li><a href="api/ffsim.html#ffsim.UCJOpSpinBalanced.n_params">(ffsim.UCJOpSpinBalanced static method)</a>
 </li>
@@ -913,13 +855,9 @@ <h2>N</h2>
           <li><a href="api/ffsim.html#ffsim.UCJOpSpinUnbalanced.n_params">(ffsim.UCJOpSpinUnbalanced static method)</a>
 </li>
         </ul></li>
-        <li><a href="api/ffsim.html#ffsim.RealUCJOperator.n_reps">n_reps (ffsim.RealUCJOperator property)</a>
+        <li><a href="api/ffsim.html#ffsim.UCJOpSpinBalanced.n_reps">n_reps (ffsim.UCJOpSpinBalanced property)</a>
 
         <ul>
-          <li><a href="api/ffsim.html#ffsim.UCJOperator.n_reps">(ffsim.UCJOperator property)</a>
-</li>
-          <li><a href="api/ffsim.html#ffsim.UCJOpSpinBalanced.n_reps">(ffsim.UCJOpSpinBalanced property)</a>
-</li>
           <li><a href="api/ffsim.html#ffsim.UCJOpSpinless.n_reps">(ffsim.UCJOpSpinless property)</a>
 </li>
           <li><a href="api/ffsim.html#ffsim.UCJOpSpinUnbalanced.n_reps">(ffsim.UCJOpSpinUnbalanced property)</a>
@@ -937,8 +875,6 @@ <h2>N</h2>
           <li><a href="api/ffsim.html#ffsim.DoubleFactorizedHamiltonian.norb">(ffsim.DoubleFactorizedHamiltonian property)</a>
 </li>
           <li><a href="api/ffsim.html#ffsim.GivensAnsatzOp.norb">(ffsim.GivensAnsatzOp attribute)</a>
-</li>
-          <li><a href="api/ffsim.html#ffsim.GivensAnsatzOperator.norb">(ffsim.GivensAnsatzOperator attribute)</a>
 </li>
           <li><a href="api/ffsim.html#ffsim.HopGateAnsatzOperator.norb">(ffsim.HopGateAnsatzOperator attribute)</a>
 </li>
@@ -947,14 +883,12 @@ <h2>N</h2>
           <li><a href="api/ffsim.html#ffsim.MolecularHamiltonian.norb">(ffsim.MolecularHamiltonian property)</a>
 </li>
           <li><a href="api/ffsim.html#ffsim.NumNumAnsatzOpSpinBalanced.norb">(ffsim.NumNumAnsatzOpSpinBalanced attribute)</a>
-</li>
-          <li><a href="api/ffsim.html#ffsim.RealUCJOperator.norb">(ffsim.RealUCJOperator property)</a>
 </li>
           <li><a href="api/ffsim.html#ffsim.SingleFactorizedHamiltonian.norb">(ffsim.SingleFactorizedHamiltonian property)</a>
 </li>
           <li><a href="api/ffsim.html#ffsim.StateVector.norb">(ffsim.StateVector attribute)</a>
 </li>
-          <li><a href="api/ffsim.html#ffsim.UCJOperator.norb">(ffsim.UCJOperator property)</a>
+          <li><a href="api/ffsim.html#ffsim.UCCSDOpRestrictedReal.norb">(ffsim.UCCSDOpRestrictedReal property)</a>
 </li>
           <li><a href="api/ffsim.html#ffsim.UCJOpSpinBalanced.norb">(ffsim.UCJOpSpinBalanced property)</a>
 </li>
@@ -1016,10 +950,6 @@ <h2>O</h2>
         <li><a href="api/ffsim.html#ffsim.DoubleFactorizedHamiltonian.orbital_rotations">orbital_rotations (ffsim.DoubleFactorizedHamiltonian attribute)</a>
 
         <ul>
-          <li><a href="api/ffsim.html#ffsim.RealUCJOperator.orbital_rotations">(ffsim.RealUCJOperator attribute)</a>
-</li>
-          <li><a href="api/ffsim.html#ffsim.UCJOperator.orbital_rotations">(ffsim.UCJOperator attribute)</a>
-</li>
           <li><a href="api/ffsim.html#ffsim.UCJOpSpinBalanced.orbital_rotations">(ffsim.UCJOpSpinBalanced attribute)</a>
 </li>
           <li><a href="api/ffsim.html#ffsim.UCJOpSpinless.orbital_rotations">(ffsim.UCJOpSpinless attribute)</a>
@@ -1111,23 +1041,21 @@ <h2>R</h2>
 </li>
         <li><a href="api/ffsim.random.html#ffsim.random.random_two_body_tensor">random_two_body_tensor() (in module ffsim.random)</a>
 </li>
-        <li><a href="api/ffsim.random.html#ffsim.random.random_ucj_op_spin_balanced">random_ucj_op_spin_balanced() (in module ffsim.random)</a>
+        <li><a href="api/ffsim.random.html#ffsim.random.random_uccsd_restricted">random_uccsd_restricted() (in module ffsim.random)</a>
 </li>
     </ul></td>
     <td style="width: 33%; vertical-align: top;"><ul>
+        <li><a href="api/ffsim.random.html#ffsim.random.random_ucj_op_spin_balanced">random_ucj_op_spin_balanced() (in module ffsim.random)</a>
+</li>
         <li><a href="api/ffsim.random.html#ffsim.random.random_ucj_op_spin_unbalanced">random_ucj_op_spin_unbalanced() (in module ffsim.random)</a>
 </li>
         <li><a href="api/ffsim.random.html#ffsim.random.random_ucj_op_spinless">random_ucj_op_spinless() (in module ffsim.random)</a>
-</li>
-        <li><a href="api/ffsim.random.html#ffsim.random.random_ucj_operator">random_ucj_operator() (in module ffsim.random)</a>
 </li>
         <li><a href="api/ffsim.random.html#ffsim.random.random_unitary">random_unitary() (in module ffsim.random)</a>
 </li>
         <li><a href="api/ffsim.html#ffsim.rdm">rdm() (in module ffsim)</a>
 </li>
         <li><a href="api/ffsim.html#ffsim.rdms">rdms() (in module ffsim)</a>
-</li>
-        <li><a href="api/ffsim.html#ffsim.RealUCJOperator">RealUCJOperator (class in ffsim)</a>
 </li>
         <li><a href="api/ffsim.linalg.html#ffsim.linalg.reduced_matrix">reduced_matrix() (in module ffsim.linalg)</a>
 </li>
@@ -1186,6 +1114,8 @@ <h2>S</h2>
         <li><a href="api/ffsim.html#ffsim.SingleFactorizedHamiltonian">SingleFactorizedHamiltonian (class in ffsim)</a>
 </li>
         <li><a href="api/ffsim.html#ffsim.slater_determinant">slater_determinant() (in module ffsim)</a>
+</li>
+        <li><a href="api/ffsim.html#ffsim.slater_determinant_amplitudes">slater_determinant_amplitudes() (in module ffsim)</a>
 </li>
         <li><a href="api/ffsim.html#ffsim.slater_determinant_rdm">slater_determinant_rdm() (in module ffsim)</a>
 </li>
@@ -1238,8 +1168,6 @@ <h2>T</h2>
         <li><a href="api/ffsim.html#ffsim.GivensAnsatzOp.thetas">thetas (ffsim.GivensAnsatzOp attribute)</a>
 
         <ul>
-          <li><a href="api/ffsim.html#ffsim.GivensAnsatzOperator.thetas">(ffsim.GivensAnsatzOperator attribute)</a>
-</li>
           <li><a href="api/ffsim.html#ffsim.HopGateAnsatzOperator.thetas">(ffsim.HopGateAnsatzOperator attribute)</a>
 </li>
           <li><a href="api/ffsim.html#ffsim.NumNumAnsatzOpSpinBalanced.thetas">(ffsim.NumNumAnsatzOpSpinBalanced attribute)</a>
@@ -1260,15 +1188,11 @@ <h2>T</h2>
         <li><a href="api/ffsim.html#ffsim.GivensAnsatzOp.to_parameters">to_parameters() (ffsim.GivensAnsatzOp method)</a>
 
         <ul>
-          <li><a href="api/ffsim.html#ffsim.GivensAnsatzOperator.to_parameters">(ffsim.GivensAnsatzOperator method)</a>
-</li>
           <li><a href="api/ffsim.html#ffsim.HopGateAnsatzOperator.to_parameters">(ffsim.HopGateAnsatzOperator method)</a>
 </li>
           <li><a href="api/ffsim.html#ffsim.NumNumAnsatzOpSpinBalanced.to_parameters">(ffsim.NumNumAnsatzOpSpinBalanced method)</a>
 </li>
-          <li><a href="api/ffsim.html#ffsim.RealUCJOperator.to_parameters">(ffsim.RealUCJOperator method)</a>
-</li>
-          <li><a href="api/ffsim.html#ffsim.UCJOperator.to_parameters">(ffsim.UCJOperator method)</a>
+          <li><a href="api/ffsim.html#ffsim.UCCSDOpRestrictedReal.to_parameters">(ffsim.UCCSDOpRestrictedReal method)</a>
 </li>
           <li><a href="api/ffsim.html#ffsim.UCJOpSpinBalanced.to_parameters">(ffsim.UCJOpSpinBalanced method)</a>
 </li>
@@ -1279,12 +1203,6 @@ <h2>T</h2>
         </ul></li>
     </ul></td>
     <td style="width: 33%; vertical-align: top;"><ul>
-        <li><a href="api/ffsim.html#ffsim.RealUCJOperator.to_t_amplitudes">to_t_amplitudes() (ffsim.RealUCJOperator method)</a>
-
-        <ul>
-          <li><a href="api/ffsim.html#ffsim.UCJOperator.to_t_amplitudes">(ffsim.UCJOperator method)</a>
-</li>
-        </ul></li>
         <li><a href="api/ffsim.html#ffsim.DoubleFactorizedHamiltonian.to_z_representation">to_z_representation() (ffsim.DoubleFactorizedHamiltonian method)</a>
 </li>
         <li><a href="api/ffsim.html#ffsim.trace">trace() (in module ffsim)</a>
@@ -1301,9 +1219,7 @@ <h2>T</h2>
   <h2>U</h2>
   <table style="width: 100%" class="indextable genindextable"><tr>
     <td style="width: 33%; vertical-align: top;"><ul>
-        <li><a href="api/ffsim.html#ffsim.UCJOperator">UCJOperator (class in ffsim)</a>
-</li>
-        <li><a href="api/ffsim.qiskit.html#ffsim.qiskit.UCJOperatorJW">UCJOperatorJW (class in ffsim.qiskit)</a>
+        <li><a href="api/ffsim.html#ffsim.UCCSDOpRestrictedReal">UCCSDOpRestrictedReal (class in ffsim)</a>
 </li>
         <li><a href="api/ffsim.html#ffsim.UCJOpSpinBalanced">UCJOpSpinBalanced (class in ffsim)</a>
 </li>
@@ -1375,7 +1291,7 @@ <h2>Z</h2>
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="_static/documentation_options.js?v=a72e4630"></script>
     <script src="_static/doctools.js?v=9bcbadda"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/how-to-guides/entanglement-forging.html b/how-to-guides/entanglement-forging.html
index debb72d44..ded833494 100644
--- a/how-to-guides/entanglement-forging.html
+++ b/how-to-guides/entanglement-forging.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="How to use the FermionOperator class" href="fermion-operator.html" /><link rel="prev" title="How to simulate the local unitary cluster Jastrow (LUCJ) ansatz" href="lucj.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>How to simulate entanglement forging - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>How to simulate entanglement forging - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -160,7 +160,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -184,7 +184,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -335,7 +335,7 @@ <h2>Build a molecule<a class="headerlink" href="#Build-a-molecule" title="Link t
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 converged SCF energy = -75.6787887956297
-Parsing /tmp/tmpfo16w5i1
+Parsing /tmp/tmpjuqvvg3m
 converged SCF energy = -75.6787887956314
 CASCI E = -75.7288249991515  E(CI) = -23.6332495815006  S^2 = 0.0000000
 norb = 6
@@ -347,7 +347,7 @@ <h2>Build a molecule<a class="headerlink" href="#Build-a-molecule" title="Link t
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-Overwritten attributes  get_hcore get_ovlp  of &lt;class &#39;pyscf.scf.hf.RHF&#39;&gt;
+Overwritten attributes  get_ovlp get_hcore  of &lt;class &#39;pyscf.scf.hf.RHF&#39;&gt;
 /home/runner/work/ffsim/ffsim/.tox/docs/lib/python3.12/site-packages/pyscf/gto/mole.py:1294: UserWarning: Function mol.dumps drops attribute energy_nuc because it is not JSON-serializable
   warnings.warn(msg)
 /home/runner/work/ffsim/ffsim/.tox/docs/lib/python3.12/site-packages/pyscf/gto/mole.py:1294: UserWarning: Function mol.dumps drops attribute intor_symmetric because it is not JSON-serializable
@@ -425,7 +425,7 @@ <h2>Compute energy<a class="headerlink" href="#Compute-energy" title="Link to th
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Energy at initialialization: -75.67794403659725
+Energy at initialialization: -75.67794403659722
 </pre></div></div>
 </div>
 </section>
@@ -471,10 +471,10 @@ <h2>Optimize energy<a class="headerlink" href="#Optimize-energy" title="Link to
   message: STOP: TOTAL NO. of f AND g EVALUATIONS EXCEEDS LIMIT
   success: False
    status: 1
-      fun: -75.68381563541598
-        x: [-1.603e-01  6.417e-03 ...  5.748e-02 -1.005e-01]
+      fun: -75.68381560472928
+        x: [-1.603e-01  6.420e-03 ...  5.748e-02 -1.005e-01]
       nit: 3
-      jac: [ 2.174e-04  1.108e-04 ... -4.748e-03  7.435e-03]
+      jac: [ 2.146e-04  1.094e-04 ... -4.751e-03  7.424e-03]
      nfev: 112
      njev: 7
  hess_inv: &lt;15x15 LbfgsInvHessProduct with dtype=float64&gt;
@@ -555,7 +555,7 @@ <h2>Optimize energy<a class="headerlink" href="#Optimize-energy" title="Link to
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/how-to-guides/entanglement-forging.ipynb b/how-to-guides/entanglement-forging.ipynb
index 50b26c599..df39b9664 100644
--- a/how-to-guides/entanglement-forging.ipynb
+++ b/how-to-guides/entanglement-forging.ipynb
@@ -18,10 +18,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:21.297389Z",
-     "iopub.status.busy": "2024-10-10T17:21:21.296950Z",
-     "iopub.status.idle": "2024-10-10T17:21:22.176916Z",
-     "shell.execute_reply": "2024-10-10T17:21:22.176304Z"
+     "iopub.execute_input": "2024-10-30T17:27:15.162383Z",
+     "iopub.status.busy": "2024-10-30T17:27:15.161905Z",
+     "iopub.status.idle": "2024-10-30T17:27:16.189261Z",
+     "shell.execute_reply": "2024-10-30T17:27:16.188626Z"
     }
    },
    "outputs": [
@@ -36,7 +36,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Parsing /tmp/tmpfo16w5i1\n",
+      "Parsing /tmp/tmpjuqvvg3m\n",
       "converged SCF energy = -75.6787887956314\n"
      ]
     },
@@ -59,7 +59,7 @@
      "name": "stderr",
      "output_type": "stream",
      "text": [
-      "Overwritten attributes  get_hcore get_ovlp  of <class 'pyscf.scf.hf.RHF'>\n",
+      "Overwritten attributes  get_ovlp get_hcore  of <class 'pyscf.scf.hf.RHF'>\n",
       "/home/runner/work/ffsim/ffsim/.tox/docs/lib/python3.12/site-packages/pyscf/gto/mole.py:1294: UserWarning: Function mol.dumps drops attribute energy_nuc because it is not JSON-serializable\n",
       "  warnings.warn(msg)\n",
       "/home/runner/work/ffsim/ffsim/.tox/docs/lib/python3.12/site-packages/pyscf/gto/mole.py:1294: UserWarning: Function mol.dumps drops attribute intor_symmetric because it is not JSON-serializable\n",
@@ -125,10 +125,10 @@
    "execution_count": 2,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:22.179665Z",
-     "iopub.status.busy": "2024-10-10T17:21:22.179197Z",
-     "iopub.status.idle": "2024-10-10T17:21:22.187320Z",
-     "shell.execute_reply": "2024-10-10T17:21:22.186782Z"
+     "iopub.execute_input": "2024-10-30T17:27:16.192782Z",
+     "iopub.status.busy": "2024-10-30T17:27:16.191812Z",
+     "iopub.status.idle": "2024-10-30T17:27:16.197126Z",
+     "shell.execute_reply": "2024-10-30T17:27:16.196496Z"
     }
    },
    "outputs": [],
@@ -168,10 +168,10 @@
    "execution_count": 3,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:22.190592Z",
-     "iopub.status.busy": "2024-10-10T17:21:22.189798Z",
-     "iopub.status.idle": "2024-10-10T17:21:22.194034Z",
-     "shell.execute_reply": "2024-10-10T17:21:22.193504Z"
+     "iopub.execute_input": "2024-10-30T17:27:16.199239Z",
+     "iopub.status.busy": "2024-10-30T17:27:16.198907Z",
+     "iopub.status.idle": "2024-10-30T17:27:16.202157Z",
+     "shell.execute_reply": "2024-10-30T17:27:16.201587Z"
     }
    },
    "outputs": [],
@@ -200,10 +200,10 @@
    "execution_count": 4,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:22.197268Z",
-     "iopub.status.busy": "2024-10-10T17:21:22.196465Z",
-     "iopub.status.idle": "2024-10-10T17:21:22.332000Z",
-     "shell.execute_reply": "2024-10-10T17:21:22.331466Z"
+     "iopub.execute_input": "2024-10-30T17:27:16.204104Z",
+     "iopub.status.busy": "2024-10-30T17:27:16.203683Z",
+     "iopub.status.idle": "2024-10-30T17:27:16.329816Z",
+     "shell.execute_reply": "2024-10-30T17:27:16.329288Z"
     }
    },
    "outputs": [
@@ -211,7 +211,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Energy at initialialization: -75.67794403659725\n"
+      "Energy at initialialization: -75.67794403659722\n"
      ]
     }
    ],
@@ -238,10 +238,10 @@
    "execution_count": 5,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:22.334154Z",
-     "iopub.status.busy": "2024-10-10T17:21:22.333777Z",
-     "iopub.status.idle": "2024-10-10T17:21:30.189519Z",
-     "shell.execute_reply": "2024-10-10T17:21:30.188878Z"
+     "iopub.execute_input": "2024-10-30T17:27:16.331912Z",
+     "iopub.status.busy": "2024-10-30T17:27:16.331528Z",
+     "iopub.status.idle": "2024-10-30T17:27:24.335381Z",
+     "shell.execute_reply": "2024-10-30T17:27:24.334806Z"
     }
    },
    "outputs": [
@@ -253,10 +253,10 @@
       "  message: STOP: TOTAL NO. of f AND g EVALUATIONS EXCEEDS LIMIT\n",
       "  success: False\n",
       "   status: 1\n",
-      "      fun: -75.68381563541598\n",
-      "        x: [-1.603e-01  6.417e-03 ...  5.748e-02 -1.005e-01]\n",
+      "      fun: -75.68381560472928\n",
+      "        x: [-1.603e-01  6.420e-03 ...  5.748e-02 -1.005e-01]\n",
       "      nit: 3\n",
-      "      jac: [ 2.174e-04  1.108e-04 ... -4.748e-03  7.435e-03]\n",
+      "      jac: [ 2.146e-04  1.094e-04 ... -4.751e-03  7.424e-03]\n",
       "     nfev: 112\n",
       "     njev: 7\n",
       " hess_inv: <15x15 LbfgsInvHessProduct with dtype=float64>\n"
diff --git a/how-to-guides/fermion-operator.html b/how-to-guides/fermion-operator.html
index b03dae773..29f197c55 100644
--- a/how-to-guides/fermion-operator.html
+++ b/how-to-guides/fermion-operator.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="How to build and transpile Qiskit quantum circuits" href="qiskit-circuits.html" /><link rel="prev" title="How to simulate entanglement forging" href="entanglement-forging.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>How to use the FermionOperator class - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>How to use the FermionOperator class - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -160,7 +160,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -184,7 +184,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -364,17 +364,17 @@ <h1>How to use the FermionOperator class<a class="headerlink" href="#How-to-use-
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 FermionOperator({
+    (cre_a(3), des_a(0)): -0.5,
     (cre_b(2)): 0-0.25j,
-    (cre_a(3), des_a(0), cre_b(2)): 0-0.25j,
-    (cre_a(3), des_a(0), des_a(3), des_b(3)): 0.0625,
     (des_a(3), des_b(3)): 0.0625,
+    (cre_a(0), des_a(3), cre_b(2)): 0+0.5j,
+    (cre_b(1), des_b(5), cre_a(4), cre_b(2)): -1+1j,
     (cre_a(0), des_a(3)): 1,
     (cre_b(1), des_b(5), cre_a(4)): 2+2j,
-    (cre_b(1), des_b(5), cre_a(4), cre_b(2)): -1+1j,
-    (cre_a(3), des_a(0)): -0.5,
+    (cre_a(3), des_a(0), des_a(3), des_b(3)): 0.0625,
     (cre_b(1), des_b(5), cre_a(4), des_a(3), des_b(3)): -0.25-0.25j,
-    (cre_a(0), des_a(3), cre_b(2)): 0+0.5j,
-    (cre_a(0), des_a(3), des_a(3), des_b(3)): -0.125
+    (cre_a(0), des_a(3), des_a(3), des_b(3)): -0.125,
+    (cre_a(3), des_a(0), cre_b(2)): 0-0.25j
 })
 </pre></div></div>
 </div>
@@ -403,17 +403,17 @@ <h1>How to use the FermionOperator class<a class="headerlink" href="#How-to-use-
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 FermionOperator({
+    (cre_a(3), des_a(0)): 0+3j,
     (cre_b(2)): -5,
-    (cre_a(3), des_a(0), cre_b(2)): -1,
-    (cre_a(3), des_a(0), des_a(3), des_b(3)): 0-0.25j,
     (des_a(3), des_b(3)): 0-1.25j,
+    (cre_a(0), des_a(3), cre_b(2)): 2,
+    (cre_b(1), des_b(5), cre_a(4), cre_b(2)): 4+4j,
     (cre_a(0), des_a(3)): 0-6j,
     (cre_b(1), des_b(5), cre_a(4)): 12-12j,
-    (cre_b(1), des_b(5), cre_a(4), cre_b(2)): 4+4j,
-    (cre_a(3), des_a(0)): 0+3j,
+    (cre_a(3), des_a(0), des_a(3), des_b(3)): 0-0.25j,
     (cre_b(1), des_b(5), cre_a(4), des_a(3), des_b(3)): -1+1j,
-    (cre_a(0), des_a(3), cre_b(2)): 2,
-    (cre_a(0), des_a(3), des_a(3), des_b(3)): 0+0.5j
+    (cre_a(0), des_a(3), des_a(3), des_b(3)): 0+0.5j,
+    (cre_a(3), des_a(0), cre_b(2)): -1
 })
 </pre></div></div>
 </div>
@@ -434,16 +434,16 @@ <h1>How to use the FermionOperator class<a class="headerlink" href="#How-to-use-
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 FermionOperator({
-    (cre_a(3), des_b(3), des_a(3), des_a(0)): 0+0.25j,
-    (cre_b(1), cre_a(4), des_b(5), des_b(3), des_a(3)): -1+1j,
-    (cre_b(2), cre_a(0), des_a(3)): 2,
     (cre_b(2), cre_a(3), des_a(0)): -1,
+    (cre_a(3), des_b(3), des_a(3), des_a(0)): 0+0.25j,
     (cre_b(2)): -5,
-    (des_b(3), des_a(3)): 0+1.25j,
     (cre_b(2), cre_b(1), cre_a(4), des_b(5)): 4+4j,
-    (cre_a(3), des_a(0)): 0+3j,
+    (cre_b(1), cre_a(4), des_b(5), des_b(3), des_a(3)): -1+1j,
+    (cre_b(2), cre_a(0), des_a(3)): 2,
     (cre_b(1), cre_a(4), des_b(5)): -12+12j,
-    (cre_a(0), des_a(3)): 0-6j
+    (des_b(3), des_a(3)): 0+1.25j,
+    (cre_a(0), des_a(3)): 0-6j,
+    (cre_a(3), des_a(0)): 0+3j
 })
 </pre></div></div>
 </div>
@@ -512,11 +512,11 @@ <h1>How to use the FermionOperator class<a class="headerlink" href="#How-to-use-
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-array([ 0.        +0.j      ,  0.        +0.j      ,
-        0.        +0.j      ,  0.        +0.j      ,
-       -0.06944034+0.086307j,  0.        +0.j      ,
-        0.        +0.j      ,  0.        +0.j      ,
-        0.        +0.j      ])
+array([ 0.        +0.j        ,  0.        +0.j        ,
+        0.        +0.j        ,  0.        +0.j        ,
+       -0.15212504+0.07716715j,  0.        +0.j        ,
+        0.        +0.j        ,  0.        +0.j        ,
+        0.        +0.j        ])
 </pre></div></div>
 </div>
 <p>It can also be passed into most linear algebra routines in <code class="docutils literal notranslate"><span class="pre">scipy.sparse.linalg</span></code>.</p>
@@ -591,7 +591,7 @@ <h1>How to use the FermionOperator class<a class="headerlink" href="#How-to-use-
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/how-to-guides/fermion-operator.ipynb b/how-to-guides/fermion-operator.ipynb
index 49adb9e3e..02901c580 100644
--- a/how-to-guides/fermion-operator.ipynb
+++ b/how-to-guides/fermion-operator.ipynb
@@ -29,10 +29,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:31.695901Z",
-     "iopub.status.busy": "2024-10-10T17:21:31.695687Z",
-     "iopub.status.idle": "2024-10-10T17:21:32.411527Z",
-     "shell.execute_reply": "2024-10-10T17:21:32.410915Z"
+     "iopub.execute_input": "2024-10-30T17:27:26.120139Z",
+     "iopub.status.busy": "2024-10-30T17:27:26.119528Z",
+     "iopub.status.idle": "2024-10-30T17:27:26.847863Z",
+     "shell.execute_reply": "2024-10-30T17:27:26.847316Z"
     }
    },
    "outputs": [
@@ -76,10 +76,10 @@
    "execution_count": 2,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:32.413794Z",
-     "iopub.status.busy": "2024-10-10T17:21:32.413364Z",
-     "iopub.status.idle": "2024-10-10T17:21:32.417558Z",
-     "shell.execute_reply": "2024-10-10T17:21:32.417078Z"
+     "iopub.execute_input": "2024-10-30T17:27:26.850083Z",
+     "iopub.status.busy": "2024-10-30T17:27:26.849602Z",
+     "iopub.status.idle": "2024-10-30T17:27:26.853689Z",
+     "shell.execute_reply": "2024-10-30T17:27:26.853139Z"
     }
    },
    "outputs": [
@@ -110,10 +110,10 @@
    "execution_count": 3,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:32.419324Z",
-     "iopub.status.busy": "2024-10-10T17:21:32.419143Z",
-     "iopub.status.idle": "2024-10-10T17:21:32.423352Z",
-     "shell.execute_reply": "2024-10-10T17:21:32.422897Z"
+     "iopub.execute_input": "2024-10-30T17:27:26.855622Z",
+     "iopub.status.busy": "2024-10-30T17:27:26.855205Z",
+     "iopub.status.idle": "2024-10-30T17:27:26.859459Z",
+     "shell.execute_reply": "2024-10-30T17:27:26.859004Z"
     }
    },
    "outputs": [
@@ -121,17 +121,17 @@
      "data": {
       "text/plain": [
        "FermionOperator({\n",
+       "    (cre_a(3), des_a(0)): -0.5,\n",
        "    (cre_b(2)): 0-0.25j,\n",
-       "    (cre_a(3), des_a(0), cre_b(2)): 0-0.25j,\n",
-       "    (cre_a(3), des_a(0), des_a(3), des_b(3)): 0.0625,\n",
        "    (des_a(3), des_b(3)): 0.0625,\n",
+       "    (cre_a(0), des_a(3), cre_b(2)): 0+0.5j,\n",
+       "    (cre_b(1), des_b(5), cre_a(4), cre_b(2)): -1+1j,\n",
        "    (cre_a(0), des_a(3)): 1,\n",
        "    (cre_b(1), des_b(5), cre_a(4)): 2+2j,\n",
-       "    (cre_b(1), des_b(5), cre_a(4), cre_b(2)): -1+1j,\n",
-       "    (cre_a(3), des_a(0)): -0.5,\n",
+       "    (cre_a(3), des_a(0), des_a(3), des_b(3)): 0.0625,\n",
        "    (cre_b(1), des_b(5), cre_a(4), des_a(3), des_b(3)): -0.25-0.25j,\n",
-       "    (cre_a(0), des_a(3), cre_b(2)): 0+0.5j,\n",
-       "    (cre_a(0), des_a(3), des_a(3), des_b(3)): -0.125\n",
+       "    (cre_a(0), des_a(3), des_a(3), des_b(3)): -0.125,\n",
+       "    (cre_a(3), des_a(0), cre_b(2)): 0-0.25j\n",
        "})"
       ]
      },
@@ -170,10 +170,10 @@
    "execution_count": 4,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:32.425182Z",
-     "iopub.status.busy": "2024-10-10T17:21:32.424997Z",
-     "iopub.status.idle": "2024-10-10T17:21:32.428839Z",
-     "shell.execute_reply": "2024-10-10T17:21:32.428366Z"
+     "iopub.execute_input": "2024-10-30T17:27:26.861444Z",
+     "iopub.status.busy": "2024-10-30T17:27:26.860952Z",
+     "iopub.status.idle": "2024-10-30T17:27:26.864613Z",
+     "shell.execute_reply": "2024-10-30T17:27:26.864162Z"
     }
    },
    "outputs": [
@@ -181,17 +181,17 @@
      "data": {
       "text/plain": [
        "FermionOperator({\n",
+       "    (cre_a(3), des_a(0)): 0+3j,\n",
        "    (cre_b(2)): -5,\n",
-       "    (cre_a(3), des_a(0), cre_b(2)): -1,\n",
-       "    (cre_a(3), des_a(0), des_a(3), des_b(3)): 0-0.25j,\n",
        "    (des_a(3), des_b(3)): 0-1.25j,\n",
+       "    (cre_a(0), des_a(3), cre_b(2)): 2,\n",
+       "    (cre_b(1), des_b(5), cre_a(4), cre_b(2)): 4+4j,\n",
        "    (cre_a(0), des_a(3)): 0-6j,\n",
        "    (cre_b(1), des_b(5), cre_a(4)): 12-12j,\n",
-       "    (cre_b(1), des_b(5), cre_a(4), cre_b(2)): 4+4j,\n",
-       "    (cre_a(3), des_a(0)): 0+3j,\n",
+       "    (cre_a(3), des_a(0), des_a(3), des_b(3)): 0-0.25j,\n",
        "    (cre_b(1), des_b(5), cre_a(4), des_a(3), des_b(3)): -1+1j,\n",
-       "    (cre_a(0), des_a(3), cre_b(2)): 2,\n",
-       "    (cre_a(0), des_a(3), des_a(3), des_b(3)): 0+0.5j\n",
+       "    (cre_a(0), des_a(3), des_a(3), des_b(3)): 0+0.5j,\n",
+       "    (cre_a(3), des_a(0), cre_b(2)): -1\n",
        "})"
       ]
      },
@@ -220,10 +220,10 @@
    "execution_count": 5,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:32.430545Z",
-     "iopub.status.busy": "2024-10-10T17:21:32.430362Z",
-     "iopub.status.idle": "2024-10-10T17:21:32.434150Z",
-     "shell.execute_reply": "2024-10-10T17:21:32.433667Z"
+     "iopub.execute_input": "2024-10-30T17:27:26.866792Z",
+     "iopub.status.busy": "2024-10-30T17:27:26.866326Z",
+     "iopub.status.idle": "2024-10-30T17:27:26.870321Z",
+     "shell.execute_reply": "2024-10-30T17:27:26.869858Z"
     }
    },
    "outputs": [
@@ -231,16 +231,16 @@
      "data": {
       "text/plain": [
        "FermionOperator({\n",
-       "    (cre_a(3), des_b(3), des_a(3), des_a(0)): 0+0.25j,\n",
-       "    (cre_b(1), cre_a(4), des_b(5), des_b(3), des_a(3)): -1+1j,\n",
-       "    (cre_b(2), cre_a(0), des_a(3)): 2,\n",
        "    (cre_b(2), cre_a(3), des_a(0)): -1,\n",
+       "    (cre_a(3), des_b(3), des_a(3), des_a(0)): 0+0.25j,\n",
        "    (cre_b(2)): -5,\n",
-       "    (des_b(3), des_a(3)): 0+1.25j,\n",
        "    (cre_b(2), cre_b(1), cre_a(4), des_b(5)): 4+4j,\n",
-       "    (cre_a(3), des_a(0)): 0+3j,\n",
+       "    (cre_b(1), cre_a(4), des_b(5), des_b(3), des_a(3)): -1+1j,\n",
+       "    (cre_b(2), cre_a(0), des_a(3)): 2,\n",
        "    (cre_b(1), cre_a(4), des_b(5)): -12+12j,\n",
-       "    (cre_a(0), des_a(3)): 0-6j\n",
+       "    (des_b(3), des_a(3)): 0+1.25j,\n",
+       "    (cre_a(0), des_a(3)): 0-6j,\n",
+       "    (cre_a(3), des_a(0)): 0+3j\n",
        "})"
       ]
      },
@@ -265,10 +265,10 @@
    "execution_count": 6,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:32.436030Z",
-     "iopub.status.busy": "2024-10-10T17:21:32.435844Z",
-     "iopub.status.idle": "2024-10-10T17:21:32.438868Z",
-     "shell.execute_reply": "2024-10-10T17:21:32.438410Z"
+     "iopub.execute_input": "2024-10-30T17:27:26.872053Z",
+     "iopub.status.busy": "2024-10-30T17:27:26.871866Z",
+     "iopub.status.idle": "2024-10-30T17:27:26.875188Z",
+     "shell.execute_reply": "2024-10-30T17:27:26.874630Z"
     }
    },
    "outputs": [
@@ -298,10 +298,10 @@
    "execution_count": 7,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:32.440768Z",
-     "iopub.status.busy": "2024-10-10T17:21:32.440413Z",
-     "iopub.status.idle": "2024-10-10T17:21:32.444300Z",
-     "shell.execute_reply": "2024-10-10T17:21:32.443803Z"
+     "iopub.execute_input": "2024-10-30T17:27:26.877127Z",
+     "iopub.status.busy": "2024-10-30T17:27:26.876916Z",
+     "iopub.status.idle": "2024-10-30T17:27:26.880703Z",
+     "shell.execute_reply": "2024-10-30T17:27:26.880242Z"
     }
    },
    "outputs": [
@@ -341,21 +341,21 @@
    "execution_count": 8,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:32.446100Z",
-     "iopub.status.busy": "2024-10-10T17:21:32.445912Z",
-     "iopub.status.idle": "2024-10-10T17:21:32.451783Z",
-     "shell.execute_reply": "2024-10-10T17:21:32.451208Z"
+     "iopub.execute_input": "2024-10-30T17:27:26.882731Z",
+     "iopub.status.busy": "2024-10-30T17:27:26.882374Z",
+     "iopub.status.idle": "2024-10-30T17:27:26.888475Z",
+     "shell.execute_reply": "2024-10-30T17:27:26.887882Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "array([ 0.        +0.j      ,  0.        +0.j      ,\n",
-       "        0.        +0.j      ,  0.        +0.j      ,\n",
-       "       -0.06944034+0.086307j,  0.        +0.j      ,\n",
-       "        0.        +0.j      ,  0.        +0.j      ,\n",
-       "        0.        +0.j      ])"
+       "array([ 0.        +0.j        ,  0.        +0.j        ,\n",
+       "        0.        +0.j        ,  0.        +0.j        ,\n",
+       "       -0.15212504+0.07716715j,  0.        +0.j        ,\n",
+       "        0.        +0.j        ,  0.        +0.j        ,\n",
+       "        0.        +0.j        ])"
       ]
      },
      "execution_count": 8,
@@ -380,10 +380,10 @@
    "execution_count": 9,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:32.453763Z",
-     "iopub.status.busy": "2024-10-10T17:21:32.453548Z",
-     "iopub.status.idle": "2024-10-10T17:21:32.464893Z",
-     "shell.execute_reply": "2024-10-10T17:21:32.464411Z"
+     "iopub.execute_input": "2024-10-30T17:27:26.890274Z",
+     "iopub.status.busy": "2024-10-30T17:27:26.890084Z",
+     "iopub.status.idle": "2024-10-30T17:27:26.900982Z",
+     "shell.execute_reply": "2024-10-30T17:27:26.900414Z"
     }
    },
    "outputs": [
diff --git a/how-to-guides/index.html b/how-to-guides/index.html
index 7bc9b8fa2..80751fdb1 100644
--- a/how-to-guides/index.html
+++ b/how-to-guides/index.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="How to simulate the local unitary cluster Jastrow (LUCJ) ansatz" href="lucj.html" /><link rel="prev" title="Qubit gate decompositions of fermionic gates" href="../explanations/qiskit-gate-decompositions.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>How-to guides - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>How-to guides - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -159,7 +159,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -183,7 +183,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -336,7 +336,7 @@ <h1>How-to guides<a class="headerlink" href="#how-to-guides" title="Link to this
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/how-to-guides/lucj.html b/how-to-guides/lucj.html
index 0a2c76595..7f76f89c4 100644
--- a/how-to-guides/lucj.html
+++ b/how-to-guides/lucj.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="How to simulate entanglement forging" href="entanglement-forging.html" /><link rel="prev" title="How-to guides" href="index.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>How to simulate the local unitary cluster Jastrow (LUCJ) ansatz - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>How to simulate the local unitary cluster Jastrow (LUCJ) ansatz - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -160,7 +160,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -184,7 +184,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -331,9 +331,9 @@ <h1>How to simulate the local unitary cluster Jastrow (LUCJ) ansatz<a class="hea
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 converged SCF energy = -77.8266321248744
-Parsing /tmp/tmpk6ithy5m
+Parsing /tmp/tmptvm74xlu
 converged SCF energy = -77.8266321248744
-CASCI E = -77.8742165643862  E(CI) = -4.02122442107772  S^2 = 0.0000000
+CASCI E = -77.8742165643862  E(CI) = -4.02122442107773  S^2 = 0.0000000
 norb = 4
 nelec = (2, 2)
 </pre></div></div>
@@ -343,7 +343,7 @@ <h1>How to simulate the local unitary cluster Jastrow (LUCJ) ansatz<a class="hea
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-Overwritten attributes  get_hcore get_ovlp  of &lt;class &#39;pyscf.scf.hf.RHF&#39;&gt;
+Overwritten attributes  get_ovlp get_hcore  of &lt;class &#39;pyscf.scf.hf.RHF&#39;&gt;
 /home/runner/work/ffsim/ffsim/.tox/docs/lib/python3.12/site-packages/pyscf/gto/mole.py:1294: UserWarning: Function mol.dumps drops attribute energy_nuc because it is not JSON-serializable
   warnings.warn(msg)
 /home/runner/work/ffsim/ffsim/.tox/docs/lib/python3.12/site-packages/pyscf/gto/mole.py:1294: UserWarning: Function mol.dumps drops attribute intor_symmetric because it is not JSON-serializable
@@ -388,8 +388,8 @@ <h2>General UCJ ansatz<a class="headerlink" href="#General-UCJ-ansatz" title="Li
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-E(CCSD) = -77.87421536374029  E_corr = -0.04758323886585568
-Energy at initialization: -77.87160024816285
+E(CCSD) = -77.87421536374029  E_corr = -0.04758323886584753
+Energy at initialization: -77.87160024816274
 </pre></div></div>
 </div>
 <div class="nboutput nblast docutils container">
@@ -435,10 +435,10 @@ <h2>General UCJ ansatz<a class="headerlink" href="#General-UCJ-ansatz" title="Li
   message: STOP: TOTAL NO. of ITERATIONS REACHED LIMIT
   success: False
    status: 1
-      fun: -77.87387394279139
-        x: [-1.153e+00 -5.246e-04 ...  2.524e-04  1.287e-01]
+      fun: -77.87387391422578
+        x: [-1.152e+00 -4.460e-04 ...  1.090e-04  1.286e-01]
       nit: 10
-      jac: [ 2.558e-05  3.126e-05 ...  1.990e-05  1.563e-05]
+      jac: [ 1.421e-05 -7.105e-06 ...  4.263e-06  1.705e-05]
      nfev: 949
      njev: 13
  hess_inv: &lt;72x72 LbfgsInvHessProduct with dtype=float64&gt;
@@ -486,10 +486,10 @@ <h2>LUCJ ansatz<a class="headerlink" href="#LUCJ-ansatz" title="Link to this hea
   message: CONVERGENCE: REL_REDUCTION_OF_F_&lt;=_FACTR*EPSMCH
   success: True
    status: 0
-      fun: -77.87363426711082
-        x: [-1.152e+00 -5.221e-05 ...  3.520e-02  2.561e-01]
+      fun: -77.87363426535352
+        x: [-1.152e+00 -3.913e-05 ...  3.519e-02  2.561e-01]
       nit: 5
-      jac: [ 4.405e-05  1.990e-05 ...  1.421e-06 -4.263e-06]
+      jac: [-2.700e-05  0.000e+00 ...  0.000e+00 -4.263e-06]
      nfev: 329
      njev: 7
  hess_inv: &lt;46x46 LbfgsInvHessProduct with dtype=float64&gt;
@@ -567,29 +567,29 @@ <h2>Optimize with the linear method<a class="headerlink" href="#Optimize-with-th
 Number of parameters: 46
  message: Convergence: Relative reduction of objective function &lt;= ftol.
  success: True
-     fun: -77.87363431320702
-       x: [-1.152e+00  3.624e-04 ...  3.488e-02  2.558e-01]
+     fun: -77.87363433826606
+       x: [-1.151e+00 -4.937e-04 ...  3.455e-02  2.562e-01]
      nit: 3
-     jac: [ 1.529e-06  3.657e-06 ... -1.537e-07 -6.623e-07]
-    nfev: 559
+     jac: [ 5.087e-07  2.242e-08 ... -5.690e-08  1.230e-07]
+    nfev: 568
     njev: 4
-  nlinop: 375
+  nlinop: 384
 
 Iteration 1
-    Energy: -77.87363199406526
-    Norm of gradient: 0.0010966013623508449
-    Regularization hyperparameter: 0.0019345284203860285
-    Variation hyperparameter: 0.9994348455232611
+    Energy: -77.87363069599299
+    Norm of gradient: 0.0012186049723606237
+    Regularization hyperparameter: 0.0010963985209662588
+    Variation hyperparameter: 0.9936417698594683
 Iteration 2
-    Energy: -77.87363429661693
-    Norm of gradient: 5.813579097194513e-05
-    Regularization hyperparameter: 0.0019345282363449037
-    Variation hyperparameter: 0.9994348455194204
+    Energy: -77.8736342817356
+    Norm of gradient: 7.743704662632361e-05
+    Regularization hyperparameter: 0.0043114907894774524
+    Variation hyperparameter: 0.9923307413892999
 Iteration 3
-    Energy: -77.87363431320702
-    Norm of gradient: 1.3773990245482654e-05
-    Regularization hyperparameter: 0.013134424201630223
-    Variation hyperparameter: 0.9994145851204197
+    Energy: -77.87363433826606
+    Norm of gradient: 1.1816193567350311e-05
+    Regularization hyperparameter: 0.003169753739017794
+    Variation hyperparameter: 0.9923426063078371
 </pre></div></div>
 </div>
 </section>
@@ -665,7 +665,7 @@ <h2>Optimize with the linear method<a class="headerlink" href="#Optimize-with-th
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/how-to-guides/lucj.ipynb b/how-to-guides/lucj.ipynb
index 7e6b1619f..03399ab16 100644
--- a/how-to-guides/lucj.ipynb
+++ b/how-to-guides/lucj.ipynb
@@ -16,10 +16,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:34.169724Z",
-     "iopub.status.busy": "2024-10-10T17:21:34.169540Z",
-     "iopub.status.idle": "2024-10-10T17:21:35.154219Z",
-     "shell.execute_reply": "2024-10-10T17:21:35.153561Z"
+     "iopub.execute_input": "2024-10-30T17:27:28.828546Z",
+     "iopub.status.busy": "2024-10-30T17:27:28.828095Z",
+     "iopub.status.idle": "2024-10-30T17:27:29.851176Z",
+     "shell.execute_reply": "2024-10-30T17:27:29.850524Z"
     }
    },
    "outputs": [
@@ -34,7 +34,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Parsing /tmp/tmpk6ithy5m\n",
+      "Parsing /tmp/tmptvm74xlu\n",
       "converged SCF energy = -77.8266321248744\n"
      ]
     },
@@ -42,7 +42,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "CASCI E = -77.8742165643862  E(CI) = -4.02122442107772  S^2 = 0.0000000\n"
+      "CASCI E = -77.8742165643862  E(CI) = -4.02122442107773  S^2 = 0.0000000\n"
      ]
     },
     {
@@ -57,7 +57,7 @@
      "name": "stderr",
      "output_type": "stream",
      "text": [
-      "Overwritten attributes  get_hcore get_ovlp  of <class 'pyscf.scf.hf.RHF'>\n",
+      "Overwritten attributes  get_ovlp get_hcore  of <class 'pyscf.scf.hf.RHF'>\n",
       "/home/runner/work/ffsim/ffsim/.tox/docs/lib/python3.12/site-packages/pyscf/gto/mole.py:1294: UserWarning: Function mol.dumps drops attribute energy_nuc because it is not JSON-serializable\n",
       "  warnings.warn(msg)\n",
       "/home/runner/work/ffsim/ffsim/.tox/docs/lib/python3.12/site-packages/pyscf/gto/mole.py:1294: UserWarning: Function mol.dumps drops attribute intor_symmetric because it is not JSON-serializable\n",
@@ -123,10 +123,10 @@
    "execution_count": 2,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:35.157196Z",
-     "iopub.status.busy": "2024-10-10T17:21:35.156542Z",
-     "iopub.status.idle": "2024-10-10T17:21:35.228394Z",
-     "shell.execute_reply": "2024-10-10T17:21:35.227836Z"
+     "iopub.execute_input": "2024-10-30T17:27:29.854348Z",
+     "iopub.status.busy": "2024-10-30T17:27:29.853810Z",
+     "iopub.status.idle": "2024-10-30T17:27:29.931938Z",
+     "shell.execute_reply": "2024-10-30T17:27:29.931310Z"
     }
    },
    "outputs": [
@@ -134,14 +134,14 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "E(CCSD) = -77.87421536374029  E_corr = -0.04758323886585568\n"
+      "E(CCSD) = -77.87421536374029  E_corr = -0.04758323886584753\n"
      ]
     },
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Energy at initialization: -77.87160024816285\n"
+      "Energy at initialization: -77.87160024816274\n"
      ]
     },
     {
@@ -189,10 +189,10 @@
    "execution_count": 3,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:21:35.230943Z",
-     "iopub.status.busy": "2024-10-10T17:21:35.230721Z",
-     "iopub.status.idle": "2024-10-10T17:23:20.436643Z",
-     "shell.execute_reply": "2024-10-10T17:23:20.436053Z"
+     "iopub.execute_input": "2024-10-30T17:27:29.934971Z",
+     "iopub.status.busy": "2024-10-30T17:27:29.934555Z",
+     "iopub.status.idle": "2024-10-30T17:29:15.163148Z",
+     "shell.execute_reply": "2024-10-30T17:29:15.162577Z"
     }
    },
    "outputs": [
@@ -204,10 +204,10 @@
       "  message: STOP: TOTAL NO. of ITERATIONS REACHED LIMIT\n",
       "  success: False\n",
       "   status: 1\n",
-      "      fun: -77.87387394279139\n",
-      "        x: [-1.153e+00 -5.246e-04 ...  2.524e-04  1.287e-01]\n",
+      "      fun: -77.87387391422578\n",
+      "        x: [-1.152e+00 -4.460e-04 ...  1.090e-04  1.286e-01]\n",
       "      nit: 10\n",
-      "      jac: [ 2.558e-05  3.126e-05 ...  1.990e-05  1.563e-05]\n",
+      "      jac: [ 1.421e-05 -7.105e-06 ...  4.263e-06  1.705e-05]\n",
       "     nfev: 949\n",
       "     njev: 13\n",
       " hess_inv: <72x72 LbfgsInvHessProduct with dtype=float64>\n"
@@ -251,10 +251,10 @@
    "execution_count": 4,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:23:20.439256Z",
-     "iopub.status.busy": "2024-10-10T17:23:20.438868Z",
-     "iopub.status.idle": "2024-10-10T17:23:55.278873Z",
-     "shell.execute_reply": "2024-10-10T17:23:55.278241Z"
+     "iopub.execute_input": "2024-10-30T17:29:15.166044Z",
+     "iopub.status.busy": "2024-10-30T17:29:15.165703Z",
+     "iopub.status.idle": "2024-10-30T17:29:51.503695Z",
+     "shell.execute_reply": "2024-10-30T17:29:51.503127Z"
     }
    },
    "outputs": [
@@ -266,10 +266,10 @@
       "  message: CONVERGENCE: REL_REDUCTION_OF_F_<=_FACTR*EPSMCH\n",
       "  success: True\n",
       "   status: 0\n",
-      "      fun: -77.87363426711082\n",
-      "        x: [-1.152e+00 -5.221e-05 ...  3.520e-02  2.561e-01]\n",
+      "      fun: -77.87363426535352\n",
+      "        x: [-1.152e+00 -3.913e-05 ...  3.519e-02  2.561e-01]\n",
       "      nit: 5\n",
-      "      jac: [ 4.405e-05  1.990e-05 ...  1.421e-06 -4.263e-06]\n",
+      "      jac: [-2.700e-05  0.000e+00 ...  0.000e+00 -4.263e-06]\n",
       "     nfev: 329\n",
       "     njev: 7\n",
       " hess_inv: <46x46 LbfgsInvHessProduct with dtype=float64>\n"
@@ -314,10 +314,10 @@
    "execution_count": 5,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:23:55.281548Z",
-     "iopub.status.busy": "2024-10-10T17:23:55.281323Z",
-     "iopub.status.idle": "2024-10-10T17:24:17.538470Z",
-     "shell.execute_reply": "2024-10-10T17:24:17.537902Z"
+     "iopub.execute_input": "2024-10-30T17:29:51.507188Z",
+     "iopub.status.busy": "2024-10-30T17:29:51.506397Z",
+     "iopub.status.idle": "2024-10-30T17:30:14.767738Z",
+     "shell.execute_reply": "2024-10-30T17:30:14.767155Z"
     }
    },
    "outputs": [
@@ -328,29 +328,29 @@
       "Number of parameters: 46\n",
       " message: Convergence: Relative reduction of objective function <= ftol.\n",
       " success: True\n",
-      "     fun: -77.87363431320702\n",
-      "       x: [-1.152e+00  3.624e-04 ...  3.488e-02  2.558e-01]\n",
+      "     fun: -77.87363433826606\n",
+      "       x: [-1.151e+00 -4.937e-04 ...  3.455e-02  2.562e-01]\n",
       "     nit: 3\n",
-      "     jac: [ 1.529e-06  3.657e-06 ... -1.537e-07 -6.623e-07]\n",
-      "    nfev: 559\n",
+      "     jac: [ 5.087e-07  2.242e-08 ... -5.690e-08  1.230e-07]\n",
+      "    nfev: 568\n",
       "    njev: 4\n",
-      "  nlinop: 375\n",
+      "  nlinop: 384\n",
       "\n",
       "Iteration 1\n",
-      "    Energy: -77.87363199406526\n",
-      "    Norm of gradient: 0.0010966013623508449\n",
-      "    Regularization hyperparameter: 0.0019345284203860285\n",
-      "    Variation hyperparameter: 0.9994348455232611\n",
+      "    Energy: -77.87363069599299\n",
+      "    Norm of gradient: 0.0012186049723606237\n",
+      "    Regularization hyperparameter: 0.0010963985209662588\n",
+      "    Variation hyperparameter: 0.9936417698594683\n",
       "Iteration 2\n",
-      "    Energy: -77.87363429661693\n",
-      "    Norm of gradient: 5.813579097194513e-05\n",
-      "    Regularization hyperparameter: 0.0019345282363449037\n",
-      "    Variation hyperparameter: 0.9994348455194204\n",
+      "    Energy: -77.8736342817356\n",
+      "    Norm of gradient: 7.743704662632361e-05\n",
+      "    Regularization hyperparameter: 0.0043114907894774524\n",
+      "    Variation hyperparameter: 0.9923307413892999\n",
       "Iteration 3\n",
-      "    Energy: -77.87363431320702\n",
-      "    Norm of gradient: 1.3773990245482654e-05\n",
-      "    Regularization hyperparameter: 0.013134424201630223\n",
-      "    Variation hyperparameter: 0.9994145851204197\n"
+      "    Energy: -77.87363433826606\n",
+      "    Norm of gradient: 1.1816193567350311e-05\n",
+      "    Regularization hyperparameter: 0.003169753739017794\n",
+      "    Variation hyperparameter: 0.9923426063078371\n"
      ]
     }
    ],
diff --git a/how-to-guides/qiskit-circuits.html b/how-to-guides/qiskit-circuits.html
index 2e53f3a2d..ffd7fb7ca 100644
--- a/how-to-guides/qiskit-circuits.html
+++ b/how-to-guides/qiskit-circuits.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="How to use ffsim’s Qiskit Sampler primitive" href="qiskit-sampler.html" /><link rel="prev" title="How to use the FermionOperator class" href="fermion-operator.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>How to build and transpile Qiskit quantum circuits - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>How to build and transpile Qiskit quantum circuits - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -160,7 +160,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -184,7 +184,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -391,7 +391,7 @@ <h4>Prepare Hartree-Fock state<a class="headerlink" href="#Prepare-Hartree-Fock-
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-&lt;qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc37cd0&gt;
+&lt;qiskit.circuit.instructionset.InstructionSet at 0x7f6ca5943490&gt;
 </pre></div></div>
 </div>
 </section>
@@ -420,7 +420,7 @@ <h4>Prepare Slater determinant<a class="headerlink" href="#Prepare-Slater-determ
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-&lt;qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc36560&gt;
+&lt;qiskit.circuit.instructionset.InstructionSet at 0x7f6ca5941ea0&gt;
 </pre></div></div>
 </div>
 </section>
@@ -447,7 +447,7 @@ <h4>Orbital rotation<a class="headerlink" href="#Orbital-rotation" title="Link t
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-&lt;qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc35f30&gt;
+&lt;qiskit.circuit.instructionset.InstructionSet at 0x7f6ca5862aa0&gt;
 </pre></div></div>
 </div>
 </section>
@@ -469,7 +469,7 @@ <h4>Number operator sum evolution<a class="headerlink" href="#Number-operator-su
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-&lt;qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc36230&gt;
+&lt;qiskit.circuit.instructionset.InstructionSet at 0x7f6ca5940880&gt;
 </pre></div></div>
 </div>
 </section>
@@ -494,7 +494,7 @@ <h4>Diagonal Coulomb evolution<a class="headerlink" href="#Diagonal-Coulomb-evol
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-&lt;qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc36980&gt;
+&lt;qiskit.circuit.instructionset.InstructionSet at 0x7f6ca5941e40&gt;
 </pre></div></div>
 </div>
 </section>
@@ -517,7 +517,7 @@ <h4>Spin-balanced unitary cluster Jastrow (UCJ) operator<a class="headerlink" hr
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-&lt;qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc374c0&gt;
+&lt;qiskit.circuit.instructionset.InstructionSet at 0x7f6ca5943cd0&gt;
 </pre></div></div>
 </div>
 </section>
@@ -540,7 +540,7 @@ <h4>Spin-unbalanced unitary cluster Jastrow (UCJ) operator<a class="headerlink"
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-&lt;qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc36770&gt;
+&lt;qiskit.circuit.instructionset.InstructionSet at 0x7f6ca59419f0&gt;
 </pre></div></div>
 </div>
 </section>
@@ -567,7 +567,7 @@ <h4>Trotter simulation of double-factorized Hamiltonian<a class="headerlink" hre
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-&lt;qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc37100&gt;
+&lt;qiskit.circuit.instructionset.InstructionSet at 0x7f6ca51ad390&gt;
 </pre></div></div>
 </div>
 </section>
@@ -660,7 +660,7 @@ <h4>Trotter simulation of double-factorized Hamiltonian<a class="headerlink" hre
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/how-to-guides/qiskit-circuits.ipynb b/how-to-guides/qiskit-circuits.ipynb
index 25a3f7e46..af5800ae3 100644
--- a/how-to-guides/qiskit-circuits.ipynb
+++ b/how-to-guides/qiskit-circuits.ipynb
@@ -16,10 +16,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:19.152011Z",
-     "iopub.status.busy": "2024-10-10T17:24:19.151803Z",
-     "iopub.status.idle": "2024-10-10T17:24:19.856823Z",
-     "shell.execute_reply": "2024-10-10T17:24:19.856281Z"
+     "iopub.execute_input": "2024-10-30T17:30:16.531601Z",
+     "iopub.status.busy": "2024-10-30T17:30:16.531142Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.239849Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.239311Z"
     }
    },
    "outputs": [],
@@ -54,10 +54,10 @@
    "execution_count": 2,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:19.859167Z",
-     "iopub.status.busy": "2024-10-10T17:24:19.858867Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.437039Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.436447Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.242358Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.241853Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.823455Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.822798Z"
     }
    },
    "outputs": [
@@ -103,10 +103,10 @@
    "execution_count": 3,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:20.439573Z",
-     "iopub.status.busy": "2024-10-10T17:24:20.438877Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.498274Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.497674Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.825867Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.825368Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.886715Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.886157Z"
     }
    },
    "outputs": [
@@ -160,17 +160,17 @@
    "execution_count": 4,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:20.500276Z",
-     "iopub.status.busy": "2024-10-10T17:24:20.499917Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.504080Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.503453Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.888807Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.888583Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.893057Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.892426Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "<qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc37cd0>"
+       "<qiskit.circuit.instructionset.InstructionSet at 0x7f6ca5943490>"
       ]
      },
      "execution_count": 4,
@@ -195,17 +195,17 @@
    "execution_count": 5,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:20.506162Z",
-     "iopub.status.busy": "2024-10-10T17:24:20.505797Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.510487Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.510017Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.895198Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.894693Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.899975Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.899488Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "<qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc36560>"
+       "<qiskit.circuit.instructionset.InstructionSet at 0x7f6ca5941ea0>"
       ]
      },
      "execution_count": 5,
@@ -242,17 +242,17 @@
    "execution_count": 6,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:20.512512Z",
-     "iopub.status.busy": "2024-10-10T17:24:20.512033Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.516570Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.515979Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.902445Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.901929Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.906990Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.906379Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "<qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc35f30>"
+       "<qiskit.circuit.instructionset.InstructionSet at 0x7f6ca5862aa0>"
       ]
      },
      "execution_count": 6,
@@ -279,17 +279,17 @@
    "execution_count": 7,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:20.518584Z",
-     "iopub.status.busy": "2024-10-10T17:24:20.518392Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.522744Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.522132Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.909022Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.908646Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.913457Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.912840Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "<qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc36230>"
+       "<qiskit.circuit.instructionset.InstructionSet at 0x7f6ca5940880>"
       ]
      },
      "execution_count": 7,
@@ -315,17 +315,17 @@
    "execution_count": 8,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:20.524666Z",
-     "iopub.status.busy": "2024-10-10T17:24:20.524461Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.528840Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.528251Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.915552Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.915193Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.920001Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.919516Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "<qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc36980>"
+       "<qiskit.circuit.instructionset.InstructionSet at 0x7f6ca5941e40>"
       ]
      },
      "execution_count": 8,
@@ -354,17 +354,17 @@
    "execution_count": 9,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:20.545298Z",
-     "iopub.status.busy": "2024-10-10T17:24:20.544691Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.549873Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.549273Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.922125Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.921746Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.927139Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.926531Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "<qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc374c0>"
+       "<qiskit.circuit.instructionset.InstructionSet at 0x7f6ca5943cd0>"
       ]
      },
      "execution_count": 9,
@@ -391,17 +391,17 @@
    "execution_count": 10,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:20.552139Z",
-     "iopub.status.busy": "2024-10-10T17:24:20.551619Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.557049Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.556583Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.929554Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.929078Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.934909Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.934307Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "<qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc36770>"
+       "<qiskit.circuit.instructionset.InstructionSet at 0x7f6ca59419f0>"
       ]
      },
      "execution_count": 10,
@@ -428,17 +428,17 @@
    "execution_count": 11,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:20.558936Z",
-     "iopub.status.busy": "2024-10-10T17:24:20.558597Z",
-     "iopub.status.idle": "2024-10-10T17:24:20.564330Z",
-     "shell.execute_reply": "2024-10-10T17:24:20.563849Z"
+     "iopub.execute_input": "2024-10-30T17:30:17.936884Z",
+     "iopub.status.busy": "2024-10-30T17:30:17.936689Z",
+     "iopub.status.idle": "2024-10-30T17:30:17.942864Z",
+     "shell.execute_reply": "2024-10-30T17:30:17.942371Z"
     }
    },
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "<qiskit.circuit.instructionset.InstructionSet at 0x7fe05fc37100>"
+       "<qiskit.circuit.instructionset.InstructionSet at 0x7f6ca51ad390>"
       ]
      },
      "execution_count": 11,
diff --git a/how-to-guides/qiskit-sampler.html b/how-to-guides/qiskit-sampler.html
index 0beed6521..6fefecbb9 100644
--- a/how-to-guides/qiskit-sampler.html
+++ b/how-to-guides/qiskit-sampler.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="API reference" href="../api/index.html" /><link rel="prev" title="How to build and transpile Qiskit quantum circuits" href="qiskit-circuits.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>How to use ffsim’s Qiskit Sampler primitive - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>How to use ffsim’s Qiskit Sampler primitive - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -160,7 +160,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -184,7 +184,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -456,10 +456,10 @@ <h3>Sampling from an LUCJ circuit for a closed-shell molecule<a class="headerlin
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-converged SCF energy = -108.835236570774
+converged SCF energy = -108.835236570775
 norb = 14
 nelec = (3, 3)
-E(CCSD) = -108.9630419334854  E_corr = -0.1278053627110059
+E(CCSD) = -108.9630419334855  E_corr = -0.1278053627110058
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -477,13 +477,13 @@ <h3>Sampling from an LUCJ circuit for a closed-shell molecule<a class="headerlin
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 {&#39;0000000000011100000000000111&#39;: 9924,
- &#39;0000000000110100000000001101&#39;: 15,
+ &#39;0000000000110100000000001101&#39;: 16,
  &#39;0000000001110000000000000111&#39;: 10,
  &#39;0000000000011100000000011100&#39;: 10,
- &#39;0000000001011000000000010110&#39;: 9,
+ &#39;0000000001011000000000010110&#39;: 10,
  &#39;0001000001010000000000000111&#39;: 5,
  &#39;0000000001011000100000000110&#39;: 4,
- &#39;0100000000100100000000000111&#39;: 3,
+ &#39;0100000001001000000000000111&#39;: 3,
  &#39;0000000000011100100000001100&#39;: 3,
  &#39;0010000000011000000000010110&#39;: 3}
 </pre></div></div>
@@ -555,13 +555,13 @@ <h3>Sampling from an LUCJ circuit for an open-shell molecule<a class="headerlink
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 SCF not converged.
-SCF energy = -75.3484557064305
+SCF energy = -75.3484557089003
 norb = 11
 nelec = (5, 4)
 
 WARN: RCCSD method does not support ROHF method. ROHF object is converted to UHF object and UCCSD method is called.
 
-E(UCCSD) = -75.45619739137106  E_corr = -0.1077416849405244
+E(UCCSD) = -75.45619739093132  E_corr = -0.1077416820310391
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -667,7 +667,7 @@ <h3>Sampling from an LUCJ circuit for an open-shell molecule<a class="headerlink
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/how-to-guides/qiskit-sampler.ipynb b/how-to-guides/qiskit-sampler.ipynb
index 032b2b5f9..27224ed5e 100644
--- a/how-to-guides/qiskit-sampler.ipynb
+++ b/how-to-guides/qiskit-sampler.ipynb
@@ -18,10 +18,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:22.630450Z",
-     "iopub.status.busy": "2024-10-10T17:24:22.630004Z",
-     "iopub.status.idle": "2024-10-10T17:24:23.324194Z",
-     "shell.execute_reply": "2024-10-10T17:24:23.323531Z"
+     "iopub.execute_input": "2024-10-30T17:30:19.829756Z",
+     "iopub.status.busy": "2024-10-30T17:30:19.829293Z",
+     "iopub.status.idle": "2024-10-30T17:30:20.552031Z",
+     "shell.execute_reply": "2024-10-30T17:30:20.551488Z"
     }
    },
    "outputs": [],
@@ -71,10 +71,10 @@
    "execution_count": 2,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:23.326723Z",
-     "iopub.status.busy": "2024-10-10T17:24:23.326254Z",
-     "iopub.status.idle": "2024-10-10T17:24:23.390846Z",
-     "shell.execute_reply": "2024-10-10T17:24:23.390322Z"
+     "iopub.execute_input": "2024-10-30T17:30:20.554582Z",
+     "iopub.status.busy": "2024-10-30T17:30:20.554114Z",
+     "iopub.status.idle": "2024-10-30T17:30:20.618334Z",
+     "shell.execute_reply": "2024-10-30T17:30:20.617682Z"
     }
    },
    "outputs": [
@@ -154,10 +154,10 @@
    "execution_count": 3,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:23.393053Z",
-     "iopub.status.busy": "2024-10-10T17:24:23.392687Z",
-     "iopub.status.idle": "2024-10-10T17:24:23.713939Z",
-     "shell.execute_reply": "2024-10-10T17:24:23.713375Z"
+     "iopub.execute_input": "2024-10-30T17:30:20.620461Z",
+     "iopub.status.busy": "2024-10-30T17:30:20.620247Z",
+     "iopub.status.idle": "2024-10-30T17:30:20.911145Z",
+     "shell.execute_reply": "2024-10-30T17:30:20.910562Z"
     }
    },
    "outputs": [
@@ -165,7 +165,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "converged SCF energy = -108.835236570774\n"
+      "converged SCF energy = -108.835236570775\n"
      ]
     },
     {
@@ -174,7 +174,7 @@
      "text": [
       "norb = 14\n",
       "nelec = (3, 3)\n",
-      "E(CCSD) = -108.9630419334854  E_corr = -0.1278053627110059\n"
+      "E(CCSD) = -108.9630419334855  E_corr = -0.1278053627110058\n"
      ]
     },
     {
@@ -188,13 +188,13 @@
      "data": {
       "text/plain": [
        "{'0000000000011100000000000111': 9924,\n",
-       " '0000000000110100000000001101': 15,\n",
+       " '0000000000110100000000001101': 16,\n",
        " '0000000001110000000000000111': 10,\n",
        " '0000000000011100000000011100': 10,\n",
-       " '0000000001011000000000010110': 9,\n",
+       " '0000000001011000000000010110': 10,\n",
        " '0001000001010000000000000111': 5,\n",
        " '0000000001011000100000000110': 4,\n",
-       " '0100000000100100000000000111': 3,\n",
+       " '0100000001001000000000000111': 3,\n",
        " '0000000000011100100000001100': 3,\n",
        " '0010000000011000000000010110': 3}"
       ]
@@ -276,10 +276,10 @@
    "execution_count": 4,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:23.716230Z",
-     "iopub.status.busy": "2024-10-10T17:24:23.715814Z",
-     "iopub.status.idle": "2024-10-10T17:24:24.273119Z",
-     "shell.execute_reply": "2024-10-10T17:24:24.272595Z"
+     "iopub.execute_input": "2024-10-30T17:30:20.913309Z",
+     "iopub.status.busy": "2024-10-30T17:30:20.912896Z",
+     "iopub.status.idle": "2024-10-30T17:30:21.460858Z",
+     "shell.execute_reply": "2024-10-30T17:30:21.460340Z"
     }
    },
    "outputs": [
@@ -294,7 +294,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "SCF energy = -75.3484557064305\n"
+      "SCF energy = -75.3484557089003\n"
      ]
     },
     {
@@ -312,14 +312,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "E(UCCSD) = -75.45619739137106  E_corr = -0.1077416849405244"
-     ]
-    },
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "\n"
+      "E(UCCSD) = -75.45619739093132  E_corr = -0.1077416820310391\n"
      ]
     },
     {
diff --git a/index.html b/index.html
index 3e20e6522..bc7756d6a 100644
--- a/index.html
+++ b/index.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Installation" href="install.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -159,7 +159,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="#"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="#"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -183,7 +183,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="#">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -439,7 +439,7 @@ <h2>Contents<a class="headerlink" href="#contents" title="Link to this heading">
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="_static/documentation_options.js?v=a72e4630"></script>
     <script src="_static/doctools.js?v=9bcbadda"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/install.html b/install.html
index 7e56aef12..6c429972b 100644
--- a/install.html
+++ b/install.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Tutorials" href="tutorials/index.html" /><link rel="prev" title="ffsim" href="index.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>Installation - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>Installation - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -159,7 +159,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -183,7 +183,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -411,7 +411,7 @@ <h2>Use within Docker<a class="headerlink" href="#use-within-docker" title="Link
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="_static/documentation_options.js?v=a72e4630"></script>
     <script src="_static/doctools.js?v=9bcbadda"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/objects.inv b/objects.inv
index 90a28ea8f..41d6bf9dd 100644
Binary files a/objects.inv and b/objects.inv differ
diff --git a/py-modindex.html b/py-modindex.html
index f013745fc..4d4c045a6 100644
--- a/py-modindex.html
+++ b/py-modindex.html
@@ -4,7 +4,7 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 --><title>Python Module Index - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 --><title>Python Module Index - ffsim 0.0.48</title>
 <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -157,7 +157,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -181,7 +181,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -350,7 +350,7 @@ <h1>Python Module Index</h1>
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="_static/documentation_options.js?v=a72e4630"></script>
     <script src="_static/doctools.js?v=9bcbadda"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/search.html b/search.html
index 20d5641aa..62578bbdc 100644
--- a/search.html
+++ b/search.html
@@ -5,9 +5,9 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="#" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
 <meta name="robots" content="noindex" />
-<title>Search - ffsim 0.0.47</title><link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=354aac6f" />
+<title>Search - ffsim 0.0.48</title><link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=302659d7" />
@@ -159,7 +159,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -183,7 +183,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -307,7 +307,7 @@
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="_static/documentation_options.js?v=a72e4630"></script>
     <script src="_static/doctools.js?v=9bcbadda"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/searchindex.js b/searchindex.js
index 93062e2bd..59b3d41ec 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles": {"API reference": [[7, null]], "Application to the double-factorized Hamiltonian": [[8, "Application-to-the-double-factorized-Hamiltonian"]], "Application to time evolution via Trotter-Suzuki formulas": [[8, "Application-to-time-evolution-via-Trotter-Suzuki-formulas"]], "Brief background on Trotter-Suzuki formulas": [[8, "Brief-background-on-Trotter-Suzuki-formulas"]], "Build a molecule": [[15, "Build-a-molecule"]], "Build the Hamiltonian": [[23, "Build-the-Hamiltonian"]], "Choose reference occupations": [[15, "Choose-reference-occupations"]], "Circuit transpilation": [[19, "Circuit-transpilation"]], "Citing ffsim": [[21, "citing-ffsim"]], "Code example": [[21, "code-example"]], "Compute energy": [[15, "Compute-energy"]], "Contents": [[21, "contents"]], "Criteria for circuits that FfsimSampler can sample": [[20, "Criteria-for-circuits-that-FfsimSampler-can-sample"]], "Data representation": [[9, "Data-representation"]], "Diagonal Coulomb evolution": [[13, "Diagonal-Coulomb-evolution"], [19, "Diagonal-Coulomb-evolution"]], "Double-factorized representation": [[8, "Double-factorized-representation"]], "Double-factorized representation of the molecular Hamiltonian": [[8, null]], "Example of using FfsimSampler": [[20, "Example-of-using-FfsimSampler"]], "Explanations": [[10, null]], "Gates": [[14, "Gates"]], "General UCJ ansatz": [[18, "General-UCJ-ansatz"]], "Hamiltonians": [[9, null]], "Hartree-Fock and Slater determinant preparation": [[13, "Hartree-Fock-and-Slater-determinant-preparation"]], "How to build and transpile Qiskit quantum circuits": [[19, null]], "How to simulate entanglement forging": [[15, null]], "How to simulate the local unitary cluster Jastrow (LUCJ) ansatz": [[18, null]], "How to use ffsim\u2019s Qiskit Sampler primitive": [[20, null]], "How to use the FermionOperator class": [[16, null]], "How-to guides": [[17, null]], "Implement Trotter simulation": [[23, "Implement-Trotter-simulation"]], "Implementing Trotter simulation of the double-factorized Hamiltonian": [[23, null]], "Initialize ansatz operator": [[15, "Initialize-ansatz-operator"]], "Install from source": [[22, "install-from-source"]], "Installation": [[21, "installation"], [22, null]], "LUCJ ansatz": [[18, "LUCJ-ansatz"]], "Locality in the UCJ operator": [[13, "Locality-in-the-UCJ-operator"]], "Merging orbital rotations": [[13, "Merging-orbital-rotations"]], "More examples": [[20, "More-examples"]], "Number operator sum evolution": [[13, "Number-operator-sum-evolution"], [19, "Number-operator-sum-evolution"]], "Operator action via SciPy LinearOperators": [[9, "Operator-action-via-SciPy-LinearOperators"]], "Optimize energy": [[15, "Optimize-energy"]], "Optimize with the linear method": [[18, "Optimize-with-the-linear-method"]], "Orbital rotation": [[13, "Orbital-rotation"], [19, "Orbital-rotation"]], "Orbital rotations": [[12, "Orbital-rotations"]], "Orbital rotations and quadratic Hamiltonians": [[12, null]], "Overview of gates": [[19, "Overview-of-gates"]], "Pip install": [[22, "pip-install"]], "Prepare Hartree-Fock state": [[19, "Prepare-Hartree-Fock-state"]], "Prepare Slater determinant": [[19, "Prepare-Slater-determinant"]], "Qubit gate decompositions of fermionic gates": [[13, null]], "Sampling from an LUCJ circuit for a closed-shell molecule": [[20, "Sampling-from-an-LUCJ-circuit-for-a-closed-shell-molecule"]], "Sampling from an LUCJ circuit for an open-shell molecule": [[20, "Sampling-from-an-LUCJ-circuit-for-an-open-shell-molecule"]], "Spin-balanced and spin-unbalanced ansatzes": [[11, "Spin-balanced-and-spin-unbalanced-ansatzes"]], "Spin-balanced unitary cluster Jastrow (UCJ) operator": [[19, "Spin-balanced-unitary-cluster-Jastrow-(UCJ)-operator"]], "Spin-unbalanced unitary cluster Jastrow (UCJ) operator": [[19, "Spin-unbalanced-unitary-cluster-Jastrow-(UCJ)-operator"]], "State preparation gates": [[19, "State-preparation-gates"]], "State vectors": [[14, "State-vectors"]], "State vectors and gates": [[14, null]], "The general unitary cluster Jastrow (UCJ) ansatz": [[11, "The-general-unitary-cluster-Jastrow-(UCJ)-ansatz"]], "The local UCJ (LUCJ) ansatz": [[11, "The-local-UCJ-(LUCJ)-ansatz"]], "The local unitary cluster Jastrow (LUCJ) ansatz": [[11, null]], "Time evolution by a quadratic Hamiltonian": [[12, "Time-evolution-by-a-quadratic-Hamiltonian"]], "Treating spinless fermions": [[14, "Treating-spinless-fermions"]], "Trotter simulation of double-factorized Hamiltonian": [[13, "Trotter-simulation-of-double-factorized-Hamiltonian"], [19, "Trotter-simulation-of-double-factorized-Hamiltonian"]], "Tutorials": [[24, null]], "Unitary cluster Jastrow (UCJ) operator": [[13, "Unitary-cluster-Jastrow-(UCJ)-operator"]], "Unitary transformation gates": [[19, "Unitary-transformation-gates"]], "Use within Docker": [[22, "use-within-docker"]], "ffsim": [[0, null], [21, null]], "ffsim.contract": [[1, null]], "ffsim.linalg": [[2, null]], "ffsim.optimize": [[3, null]], "ffsim.qiskit": [[4, null]], "ffsim.random": [[5, null]], "ffsim.testing": [[6, null]]}, "docnames": ["api/ffsim", "api/ffsim.contract", "api/ffsim.linalg", "api/ffsim.optimize", "api/ffsim.qiskit", "api/ffsim.random", "api/ffsim.testing", "api/index", "explanations/double-factorized", "explanations/hamiltonians", "explanations/index", "explanations/lucj", "explanations/orbital-rotation", "explanations/qiskit-gate-decompositions", "explanations/state-vectors-and-gates", "how-to-guides/entanglement-forging", "how-to-guides/fermion-operator", "how-to-guides/index", "how-to-guides/lucj", "how-to-guides/qiskit-circuits", "how-to-guides/qiskit-sampler", "index", "install", "tutorials/double-factorized-trotter", "tutorials/index"], "envversion": {"nbsphinx": 4, "sphinx": 64, "sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.viewcode": 1}, "filenames": ["api/ffsim.rst", "api/ffsim.contract.rst", "api/ffsim.linalg.rst", "api/ffsim.optimize.rst", "api/ffsim.qiskit.rst", "api/ffsim.random.rst", "api/ffsim.testing.rst", "api/index.md", "explanations/double-factorized.ipynb", "explanations/hamiltonians.ipynb", "explanations/index.md", "explanations/lucj.ipynb", "explanations/orbital-rotation.ipynb", "explanations/qiskit-gate-decompositions.ipynb", "explanations/state-vectors-and-gates.ipynb", "how-to-guides/entanglement-forging.ipynb", "how-to-guides/fermion-operator.ipynb", "how-to-guides/index.md", "how-to-guides/lucj.ipynb", "how-to-guides/qiskit-circuits.ipynb", "how-to-guides/qiskit-sampler.ipynb", "index.md", "install.md", "tutorials/double-factorized-trotter.ipynb", "tutorials/index.md"], "indexentries": {"__init__() (ffsim.qiskit.diagcoulombevolutionjw method)": [[4, "ffsim.qiskit.DiagCoulombEvolutionJW.__init__", false]], "__init__() (ffsim.qiskit.diagcoulombevolutionspinlessjw method)": [[4, "ffsim.qiskit.DiagCoulombEvolutionSpinlessJW.__init__", false]], "__init__() (ffsim.qiskit.dropnegligible method)": [[4, "ffsim.qiskit.DropNegligible.__init__", false]], "__init__() (ffsim.qiskit.ffsimsampler method)": [[4, "ffsim.qiskit.FfsimSampler.__init__", false]], "__init__() (ffsim.qiskit.givensansatzoperatorjw method)": [[4, "ffsim.qiskit.GivensAnsatzOperatorJW.__init__", false]], "__init__() (ffsim.qiskit.givensansatzoperatorspinlessjw method)": [[4, "ffsim.qiskit.GivensAnsatzOperatorSpinlessJW.__init__", false]], "__init__() (ffsim.qiskit.givensansatzopjw method)": [[4, "ffsim.qiskit.GivensAnsatzOpJW.__init__", false]], "__init__() (ffsim.qiskit.givensansatzopspinlessjw method)": [[4, "ffsim.qiskit.GivensAnsatzOpSpinlessJW.__init__", false]], "__init__() (ffsim.qiskit.numnumansatzopspinbalancedjw method)": [[4, "ffsim.qiskit.NumNumAnsatzOpSpinBalancedJW.__init__", false]], "__init__() (ffsim.qiskit.numopsumevolutionjw method)": [[4, "ffsim.qiskit.NumOpSumEvolutionJW.__init__", false]], "__init__() (ffsim.qiskit.numopsumevolutionspinlessjw method)": [[4, "ffsim.qiskit.NumOpSumEvolutionSpinlessJW.__init__", false]], "__init__() (ffsim.qiskit.orbitalrotationjw method)": [[4, "ffsim.qiskit.OrbitalRotationJW.__init__", false]], "__init__() (ffsim.qiskit.orbitalrotationspinlessjw method)": [[4, "ffsim.qiskit.OrbitalRotationSpinlessJW.__init__", false]], "__init__() (ffsim.qiskit.preparehartreefockjw method)": [[4, "ffsim.qiskit.PrepareHartreeFockJW.__init__", false]], "__init__() (ffsim.qiskit.preparehartreefockspinlessjw method)": [[4, "ffsim.qiskit.PrepareHartreeFockSpinlessJW.__init__", false]], "__init__() (ffsim.qiskit.prepareslaterdeterminantjw method)": [[4, "ffsim.qiskit.PrepareSlaterDeterminantJW.__init__", false]], "__init__() (ffsim.qiskit.prepareslaterdeterminantspinlessjw method)": [[4, "ffsim.qiskit.PrepareSlaterDeterminantSpinlessJW.__init__", false]], "__init__() (ffsim.qiskit.simulatetrotterdiagcoulombsplitopjw method)": [[4, "ffsim.qiskit.SimulateTrotterDiagCoulombSplitOpJW.__init__", false]], "__init__() (ffsim.qiskit.simulatetrotterdoublefactorizedjw method)": [[4, "ffsim.qiskit.SimulateTrotterDoubleFactorizedJW.__init__", false]], "__init__() (ffsim.qiskit.ucjoperatorjw method)": [[4, "ffsim.qiskit.UCJOperatorJW.__init__", false]], "__init__() (ffsim.qiskit.ucjopspinbalancedjw method)": [[4, "ffsim.qiskit.UCJOpSpinBalancedJW.__init__", false]], "__init__() (ffsim.qiskit.ucjopspinlessjw method)": [[4, "ffsim.qiskit.UCJOpSpinlessJW.__init__", false]], "__init__() (ffsim.qiskit.ucjopspinunbalancedjw method)": [[4, "ffsim.qiskit.UCJOpSpinUnbalancedJW.__init__", false]], "__init_subclass__() (ffsim.qiskit.givensansatzoperatorjw method)": [[4, "ffsim.qiskit.GivensAnsatzOperatorJW.__init_subclass__", false]], "__init_subclass__() (ffsim.qiskit.givensansatzoperatorspinlessjw method)": [[4, "ffsim.qiskit.GivensAnsatzOperatorSpinlessJW.__init_subclass__", false]], "__init_subclass__() (ffsim.qiskit.ucjoperatorjw method)": [[4, "ffsim.qiskit.UCJOperatorJW.__init_subclass__", false]], "__new__() (ffsim.qiskit.givensansatzoperatorjw static method)": [[4, "ffsim.qiskit.GivensAnsatzOperatorJW.__new__", false]], "__new__() (ffsim.qiskit.givensansatzoperatorspinlessjw static method)": [[4, "ffsim.qiskit.GivensAnsatzOperatorSpinlessJW.__new__", false]], "__new__() (ffsim.qiskit.ucjoperatorjw static method)": [[4, "ffsim.qiskit.UCJOperatorJW.__new__", false]], "action (ffsim.fermionaction attribute)": [[0, "ffsim.FermionAction.action", false]], "active_space (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.active_space", false]], "addresses_to_strings() (in module ffsim)": [[0, "ffsim.addresses_to_strings", false]], "alpha (ffsim.spin attribute)": [[0, "ffsim.Spin.ALPHA", false]], "alpha_and_beta (ffsim.spin attribute)": [[0, "ffsim.Spin.ALPHA_AND_BETA", false]], "apply_diag_coulomb_evolution() (in module ffsim)": [[0, "ffsim.apply_diag_coulomb_evolution", false]], "apply_fsim_gate() (in module ffsim)": [[0, "ffsim.apply_fsim_gate", false]], "apply_fswap_gate() (in module ffsim)": [[0, "ffsim.apply_fswap_gate", false]], "apply_givens_rotation() (in module ffsim)": [[0, "ffsim.apply_givens_rotation", false]], "apply_hop_gate() (in module ffsim)": [[0, "ffsim.apply_hop_gate", false]], "apply_matrix_to_slices() (in module ffsim.linalg)": [[2, "ffsim.linalg.apply_matrix_to_slices", false]], "apply_num_interaction() (in module ffsim)": [[0, "ffsim.apply_num_interaction", false]], "apply_num_num_interaction() (in module ffsim)": [[0, "ffsim.apply_num_num_interaction", false]], "apply_num_op_prod_interaction() (in module ffsim)": [[0, "ffsim.apply_num_op_prod_interaction", false]], "apply_num_op_sum_evolution() (in module ffsim)": [[0, "ffsim.apply_num_op_sum_evolution", false]], "apply_on_site_interaction() (in module ffsim)": [[0, "ffsim.apply_on_site_interaction", false]], "apply_orbital_rotation() (in module ffsim)": [[0, "ffsim.apply_orbital_rotation", false]], "apply_tunneling_interaction() (in module ffsim)": [[0, "ffsim.apply_tunneling_interaction", false]], "apply_unitary() (in module ffsim)": [[0, "ffsim.apply_unitary", false]], "approx_eq() (in module ffsim)": [[0, "ffsim.approx_eq", false]], "assert_allclose_up_to_global_phase() (in module ffsim.testing)": [[6, "ffsim.testing.assert_allclose_up_to_global_phase", false]], "atom (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.atom", false]], "basis (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.basis", false]], "beta (ffsim.spin attribute)": [[0, "ffsim.Spin.BETA", false]], "bit_array (ffsim.bitstringtype attribute)": [[0, "ffsim.BitstringType.BIT_ARRAY", false]], "bitstringtype (class in ffsim)": [[0, "ffsim.BitstringType", false]], "c (ffsim.linalg.givensrotation attribute)": [[2, "ffsim.linalg.GivensRotation.c", false]], "ccsd_energy (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.ccsd_energy", false]], "ccsd_t1 (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.ccsd_t1", false]], "ccsd_t2 (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.ccsd_t2", false]], "cisd_energy (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.cisd_energy", false]], "cisd_vec (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.cisd_vec", false]], "coeffs (ffsim.productstatesum attribute)": [[0, "ffsim.ProductStateSum.coeffs", false]], "conserves_particle_number() (ffsim.fermionoperator method)": [[0, "ffsim.FermionOperator.conserves_particle_number", false]], "conserves_spin_z() (ffsim.fermionoperator method)": [[0, "ffsim.FermionOperator.conserves_spin_z", false]], "constant (ffsim.diagonalcoulombhamiltonian attribute)": [[0, "ffsim.DiagonalCoulombHamiltonian.constant", false]], "constant (ffsim.doublefactorizedhamiltonian attribute)": [[0, "ffsim.DoubleFactorizedHamiltonian.constant", false]], "constant (ffsim.molecularhamiltonian attribute)": [[0, "ffsim.MolecularHamiltonian.constant", false]], "constant (ffsim.singlefactorizedhamiltonian attribute)": [[0, "ffsim.SingleFactorizedHamiltonian.constant", false]], "contract_diag_coulomb() (in module ffsim.contract)": [[1, "ffsim.contract.contract_diag_coulomb", false]], "contract_num_op_sum() (in module ffsim.contract)": [[1, "ffsim.contract.contract_num_op_sum", false]], "contract_one_body() (in module ffsim.contract)": [[1, "ffsim.contract.contract_one_body", false]], "core_energy (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.core_energy", false]], "cre() (in module ffsim)": [[0, "ffsim.cre", false]], "cre_a() (in module ffsim)": [[0, "ffsim.cre_a", false]], "cre_b() (in module ffsim)": [[0, "ffsim.cre_b", false]], "des() (in module ffsim)": [[0, "ffsim.des", false]], "des_a() (in module ffsim)": [[0, "ffsim.des_a", false]], "des_b() (in module ffsim)": [[0, "ffsim.des_b", false]], "diag() (in module ffsim)": [[0, "ffsim.diag", false]], "diag_coulomb_linop() (in module ffsim.contract)": [[1, "ffsim.contract.diag_coulomb_linop", false]], "diag_coulomb_mats (ffsim.diagonalcoulombhamiltonian attribute)": [[0, "ffsim.DiagonalCoulombHamiltonian.diag_coulomb_mats", false]], "diag_coulomb_mats (ffsim.doublefactorizedhamiltonian attribute)": [[0, "ffsim.DoubleFactorizedHamiltonian.diag_coulomb_mats", false]], "diag_coulomb_mats (ffsim.ucjopspinbalanced attribute)": [[0, "ffsim.UCJOpSpinBalanced.diag_coulomb_mats", false]], "diag_coulomb_mats (ffsim.ucjopspinless attribute)": [[0, "ffsim.UCJOpSpinless.diag_coulomb_mats", false]], "diag_coulomb_mats (ffsim.ucjopspinunbalanced attribute)": [[0, "ffsim.UCJOpSpinUnbalanced.diag_coulomb_mats", false]], "diag_coulomb_mats_alpha_alpha (ffsim.realucjoperator attribute)": [[0, "ffsim.RealUCJOperator.diag_coulomb_mats_alpha_alpha", false]], "diag_coulomb_mats_alpha_alpha (ffsim.ucjoperator attribute)": [[0, "ffsim.UCJOperator.diag_coulomb_mats_alpha_alpha", false]], "diag_coulomb_mats_alpha_beta (ffsim.realucjoperator attribute)": [[0, "ffsim.RealUCJOperator.diag_coulomb_mats_alpha_beta", false]], "diag_coulomb_mats_alpha_beta (ffsim.ucjoperator attribute)": [[0, "ffsim.UCJOperator.diag_coulomb_mats_alpha_beta", false]], "diagcoulombevolutionjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.DiagCoulombEvolutionJW", false]], "diagcoulombevolutionspinlessjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.DiagCoulombEvolutionSpinlessJW", false]], "diagonalcoulombhamiltonian (class in ffsim)": [[0, "ffsim.DiagonalCoulombHamiltonian", false]], "dim() (in module ffsim)": [[0, "ffsim.dim", false]], "dims() (in module ffsim)": [[0, "ffsim.dims", false]], "dipole_integrals (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.dipole_integrals", false]], "double_factorized() (in module ffsim.linalg)": [[2, "ffsim.linalg.double_factorized", false]], "double_factorized_t2() (in module ffsim.linalg)": [[2, "ffsim.linalg.double_factorized_t2", false]], "double_factorized_t2_alpha_beta() (in module ffsim.linalg)": [[2, "ffsim.linalg.double_factorized_t2_alpha_beta", false]], "doublefactorizedhamiltonian (class in ffsim)": [[0, "ffsim.DoubleFactorizedHamiltonian", false]], "dropnegligible (class in ffsim.qiskit)": [[4, "ffsim.qiskit.DropNegligible", false]], "expectation_one_body_power() (in module ffsim)": [[0, "ffsim.expectation_one_body_power", false]], "expectation_one_body_product() (in module ffsim)": [[0, "ffsim.expectation_one_body_product", false]], "expectation_product_state() (ffsim.singlefactorizedhamiltonian method)": [[0, "ffsim.SingleFactorizedHamiltonian.expectation_product_state", false]], "expm_multiply_taylor() (in module ffsim.linalg)": [[2, "ffsim.linalg.expm_multiply_taylor", false]], "fci_energy (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.fci_energy", false]], "fci_vec (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.fci_vec", false]], "fermi_hubbard_1d() (in module ffsim)": [[0, "ffsim.fermi_hubbard_1d", false]], "fermi_hubbard_2d() (in module ffsim)": [[0, "ffsim.fermi_hubbard_2d", false]], "fermion_operator() (in module ffsim)": [[0, "ffsim.fermion_operator", false]], "fermionaction (class in ffsim)": [[0, "ffsim.FermionAction", false]], "fermionoperator (class in ffsim)": [[0, "ffsim.FermionOperator", false]], "ffsim": [[0, "module-ffsim", false]], "ffsim.contract": [[1, "module-ffsim.contract", false]], "ffsim.linalg": [[2, "module-ffsim.linalg", false]], "ffsim.optimize": [[3, "module-ffsim.optimize", false]], "ffsim.qiskit": [[4, "module-ffsim.qiskit", false]], "ffsim.random": [[5, "module-ffsim.random", false]], "ffsim.testing": [[6, "module-ffsim.testing", false]], "ffsim_vec_to_qiskit_vec() (in module ffsim.qiskit)": [[4, "ffsim.qiskit.ffsim_vec_to_qiskit_vec", false]], "ffsimsampler (class in ffsim.qiskit)": [[4, "ffsim.qiskit.FfsimSampler", false]], "final_orbital_rotation (ffsim.hopgateansatzoperator attribute)": [[0, "ffsim.HopGateAnsatzOperator.final_orbital_rotation", false]], "final_orbital_rotation (ffsim.realucjoperator attribute)": [[0, "ffsim.RealUCJOperator.final_orbital_rotation", false]], "final_orbital_rotation (ffsim.ucjoperator attribute)": [[0, "ffsim.UCJOperator.final_orbital_rotation", false]], "final_orbital_rotation (ffsim.ucjopspinbalanced attribute)": [[0, "ffsim.UCJOpSpinBalanced.final_orbital_rotation", false]], "final_orbital_rotation (ffsim.ucjopspinless attribute)": [[0, "ffsim.UCJOpSpinless.final_orbital_rotation", false]], "final_orbital_rotation (ffsim.ucjopspinunbalanced attribute)": [[0, "ffsim.UCJOpSpinUnbalanced.final_orbital_rotation", false]], "final_state_vector() (in module ffsim.qiskit)": [[4, "ffsim.qiskit.final_state_vector", false]], "from_diag_coulomb_mats() (ffsim.numnumansatzopspinbalanced static method)": [[0, "ffsim.NumNumAnsatzOpSpinBalanced.from_diag_coulomb_mats", false]], "from_fcidump() (ffsim.moleculardata static method)": [[0, "ffsim.MolecularData.from_fcidump", false]], "from_fcidump() (ffsim.molecularhamiltonian static method)": [[0, "ffsim.MolecularHamiltonian.from_fcidump", false]], "from_fermion_operator() (ffsim.diagonalcoulombhamiltonian static method)": [[0, "ffsim.DiagonalCoulombHamiltonian.from_fermion_operator", false]], "from_json() (ffsim.moleculardata static method)": [[0, "ffsim.MolecularData.from_json", false]], "from_mole() (ffsim.moleculardata static method)": [[0, "ffsim.MolecularData.from_mole", false]], "from_molecular_hamiltonian() (ffsim.doublefactorizedhamiltonian static method)": [[0, "ffsim.DoubleFactorizedHamiltonian.from_molecular_hamiltonian", false]], "from_molecular_hamiltonian() (ffsim.singlefactorizedhamiltonian static method)": [[0, "ffsim.SingleFactorizedHamiltonian.from_molecular_hamiltonian", false]], "from_orbital_rotation() (ffsim.givensansatzop static method)": [[0, "ffsim.GivensAnsatzOp.from_orbital_rotation", false]], "from_parameters() (ffsim.givensansatzop static method)": [[0, "ffsim.GivensAnsatzOp.from_parameters", false]], "from_parameters() (ffsim.givensansatzoperator static method)": [[0, "ffsim.GivensAnsatzOperator.from_parameters", false]], "from_parameters() (ffsim.hopgateansatzoperator static method)": [[0, "ffsim.HopGateAnsatzOperator.from_parameters", false]], "from_parameters() (ffsim.numnumansatzopspinbalanced static method)": [[0, "ffsim.NumNumAnsatzOpSpinBalanced.from_parameters", false]], "from_parameters() (ffsim.realucjoperator static method)": [[0, "ffsim.RealUCJOperator.from_parameters", false]], "from_parameters() (ffsim.ucjoperator static method)": [[0, "ffsim.UCJOperator.from_parameters", false]], "from_parameters() (ffsim.ucjopspinbalanced static method)": [[0, "ffsim.UCJOpSpinBalanced.from_parameters", false]], "from_parameters() (ffsim.ucjopspinless static method)": [[0, "ffsim.UCJOpSpinless.from_parameters", false]], "from_parameters() (ffsim.ucjopspinunbalanced static method)": [[0, "ffsim.UCJOpSpinUnbalanced.from_parameters", false]], "from_scf() (ffsim.moleculardata static method)": [[0, "ffsim.MolecularData.from_scf", false]], "from_t_amplitudes() (ffsim.realucjoperator static method)": [[0, "ffsim.RealUCJOperator.from_t_amplitudes", false]], "from_t_amplitudes() (ffsim.ucjoperator static method)": [[0, "ffsim.UCJOperator.from_t_amplitudes", false]], "from_t_amplitudes() (ffsim.ucjopspinbalanced static method)": [[0, "ffsim.UCJOpSpinBalanced.from_t_amplitudes", false]], "from_t_amplitudes() (ffsim.ucjopspinless static method)": [[0, "ffsim.UCJOpSpinless.from_t_amplitudes", false]], "from_t_amplitudes() (ffsim.ucjopspinunbalanced static method)": [[0, "ffsim.UCJOpSpinUnbalanced.from_t_amplitudes", false]], "generate_norb_nelec() (in module ffsim.testing)": [[6, "ffsim.testing.generate_norb_nelec", false]], "generate_norb_nelec_spin() (in module ffsim.testing)": [[6, "ffsim.testing.generate_norb_nelec_spin", false]], "generate_norb_nocc() (in module ffsim.testing)": [[6, "ffsim.testing.generate_norb_nocc", false]], "generate_norb_spin() (in module ffsim.testing)": [[6, "ffsim.testing.generate_norb_spin", false]], "givens_decomposition() (in module ffsim.linalg)": [[2, "ffsim.linalg.givens_decomposition", false]], "givensansatzop (class in ffsim)": [[0, "ffsim.GivensAnsatzOp", false]], "givensansatzoperator (class in ffsim)": [[0, "ffsim.GivensAnsatzOperator", false]], "givensansatzoperatorjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.GivensAnsatzOperatorJW", false]], "givensansatzoperatorspinlessjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.GivensAnsatzOperatorSpinlessJW", false]], "givensansatzopjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.GivensAnsatzOpJW", false]], "givensansatzopspinlessjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.GivensAnsatzOpSpinlessJW", false]], "givensrotation (class in ffsim.linalg)": [[2, "ffsim.linalg.GivensRotation", false]], "hamiltonian (ffsim.moleculardata property)": [[0, "ffsim.MolecularData.hamiltonian", false]], "hartree_fock_state() (in module ffsim)": [[0, "ffsim.hartree_fock_state", false]], "hf_energy (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.hf_energy", false]], "hf_mo_coeff (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.hf_mo_coeff", false]], "hf_mo_occ (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.hf_mo_occ", false]], "hopgateansatzoperator (class in ffsim)": [[0, "ffsim.HopGateAnsatzOperator", false]], "i (ffsim.linalg.givensrotation attribute)": [[2, "ffsim.linalg.GivensRotation.i", false]], "indices_to_strings() (in module ffsim)": [[0, "ffsim.indices_to_strings", false]], "init_cache() (in module ffsim)": [[0, "ffsim.init_cache", false]], "int (ffsim.bitstringtype attribute)": [[0, "ffsim.BitstringType.INT", false]], "interaction_pairs (ffsim.givensansatzop attribute)": [[0, "ffsim.GivensAnsatzOp.interaction_pairs", false]], "interaction_pairs (ffsim.givensansatzoperator attribute)": [[0, "ffsim.GivensAnsatzOperator.interaction_pairs", false]], "interaction_pairs (ffsim.hopgateansatzoperator attribute)": [[0, "ffsim.HopGateAnsatzOperator.interaction_pairs", false]], "interaction_pairs (ffsim.numnumansatzopspinbalanced attribute)": [[0, "ffsim.NumNumAnsatzOpSpinBalanced.interaction_pairs", false]], "inverse() (ffsim.qiskit.diagcoulombevolutionjw method)": [[4, "ffsim.qiskit.DiagCoulombEvolutionJW.inverse", false]], "inverse() (ffsim.qiskit.diagcoulombevolutionspinlessjw method)": [[4, "ffsim.qiskit.DiagCoulombEvolutionSpinlessJW.inverse", false]], "inverse() (ffsim.qiskit.numopsumevolutionjw method)": [[4, "ffsim.qiskit.NumOpSumEvolutionJW.inverse", false]], "inverse() (ffsim.qiskit.numopsumevolutionspinlessjw method)": [[4, "ffsim.qiskit.NumOpSumEvolutionSpinlessJW.inverse", false]], "inverse() (ffsim.qiskit.orbitalrotationjw method)": [[4, "ffsim.qiskit.OrbitalRotationJW.inverse", false]], "inverse() (ffsim.qiskit.orbitalrotationspinlessjw method)": [[4, "ffsim.qiskit.OrbitalRotationSpinlessJW.inverse", false]], "is_antihermitian() (in module ffsim.linalg)": [[2, "ffsim.linalg.is_antihermitian", false]], "is_hermitian() (in module ffsim.linalg)": [[2, "ffsim.linalg.is_hermitian", false]], "is_orthogonal() (in module ffsim.linalg)": [[2, "ffsim.linalg.is_orthogonal", false]], "is_real_symmetric() (in module ffsim.linalg)": [[2, "ffsim.linalg.is_real_symmetric", false]], "is_special_orthogonal() (in module ffsim.linalg)": [[2, "ffsim.linalg.is_special_orthogonal", false]], "is_unitary() (in module ffsim.linalg)": [[2, "ffsim.linalg.is_unitary", false]], "j (ffsim.linalg.givensrotation attribute)": [[2, "ffsim.linalg.GivensRotation.j", false]], "jordan_wigner() (in module ffsim.qiskit)": [[4, "ffsim.qiskit.jordan_wigner", false]], "linear_operator() (in module ffsim)": [[0, "ffsim.linear_operator", false]], "lup() (in module ffsim.linalg)": [[2, "ffsim.linalg.lup", false]], "many_body_order() (ffsim.fermionoperator method)": [[0, "ffsim.FermionOperator.many_body_order", false]], "match_global_phase() (in module ffsim.linalg)": [[2, "ffsim.linalg.match_global_phase", false]], "mergeorbitalrotations (class in ffsim.qiskit)": [[4, "ffsim.qiskit.MergeOrbitalRotations", false]], "minimize_linear_method() (in module ffsim.optimize)": [[3, "ffsim.optimize.minimize_linear_method", false]], "mo_coeff (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.mo_coeff", false]], "mo_occ (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.mo_occ", false]], "modified_cholesky() (in module ffsim.linalg)": [[2, "ffsim.linalg.modified_cholesky", false]], "module": [[0, "module-ffsim", false], [1, "module-ffsim.contract", false], [2, "module-ffsim.linalg", false], [3, "module-ffsim.optimize", false], [4, "module-ffsim.qiskit", false], [5, "module-ffsim.random", false], [6, "module-ffsim.testing", false]], "mole (ffsim.moleculardata property)": [[0, "ffsim.MolecularData.mole", false]], "moleculardata (class in ffsim)": [[0, "ffsim.MolecularData", false]], "molecularhamiltonian (class in ffsim)": [[0, "ffsim.MolecularHamiltonian", false]], "mp2_energy (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.mp2_energy", false]], "mp2_t2 (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.mp2_t2", false]], "multireference_state() (in module ffsim)": [[0, "ffsim.multireference_state", false]], "multireference_state_prod() (in module ffsim)": [[0, "ffsim.multireference_state_prod", false]], "n_params() (ffsim.givensansatzop static method)": [[0, "ffsim.GivensAnsatzOp.n_params", false]], "n_params() (ffsim.numnumansatzopspinbalanced static method)": [[0, "ffsim.NumNumAnsatzOpSpinBalanced.n_params", false]], "n_params() (ffsim.realucjoperator static method)": [[0, "ffsim.RealUCJOperator.n_params", false]], "n_params() (ffsim.ucjoperator static method)": [[0, "ffsim.UCJOperator.n_params", false]], "n_params() (ffsim.ucjopspinbalanced static method)": [[0, "ffsim.UCJOpSpinBalanced.n_params", false]], "n_params() (ffsim.ucjopspinless static method)": [[0, "ffsim.UCJOpSpinless.n_params", false]], "n_params() (ffsim.ucjopspinunbalanced static method)": [[0, "ffsim.UCJOpSpinUnbalanced.n_params", false]], "n_reps (ffsim.realucjoperator property)": [[0, "ffsim.RealUCJOperator.n_reps", false]], "n_reps (ffsim.ucjoperator property)": [[0, "ffsim.UCJOperator.n_reps", false]], "n_reps (ffsim.ucjopspinbalanced property)": [[0, "ffsim.UCJOpSpinBalanced.n_reps", false]], "n_reps (ffsim.ucjopspinless property)": [[0, "ffsim.UCJOpSpinless.n_reps", false]], "n_reps (ffsim.ucjopspinunbalanced property)": [[0, "ffsim.UCJOpSpinUnbalanced.n_reps", false]], "nelec (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.nelec", false]], "nelec (ffsim.statevector attribute)": [[0, "ffsim.StateVector.nelec", false]], "norb (ffsim.diagonalcoulombhamiltonian property)": [[0, "ffsim.DiagonalCoulombHamiltonian.norb", false]], "norb (ffsim.doublefactorizedhamiltonian property)": [[0, "ffsim.DoubleFactorizedHamiltonian.norb", false]], "norb (ffsim.givensansatzop attribute)": [[0, "ffsim.GivensAnsatzOp.norb", false]], "norb (ffsim.givensansatzoperator attribute)": [[0, "ffsim.GivensAnsatzOperator.norb", false]], "norb (ffsim.hopgateansatzoperator attribute)": [[0, "ffsim.HopGateAnsatzOperator.norb", false]], "norb (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.norb", false]], "norb (ffsim.molecularhamiltonian property)": [[0, "ffsim.MolecularHamiltonian.norb", false]], "norb (ffsim.numnumansatzopspinbalanced attribute)": [[0, "ffsim.NumNumAnsatzOpSpinBalanced.norb", false]], "norb (ffsim.realucjoperator property)": [[0, "ffsim.RealUCJOperator.norb", false]], "norb (ffsim.singlefactorizedhamiltonian property)": [[0, "ffsim.SingleFactorizedHamiltonian.norb", false]], "norb (ffsim.statevector attribute)": [[0, "ffsim.StateVector.norb", false]], "norb (ffsim.ucjoperator property)": [[0, "ffsim.UCJOperator.norb", false]], "norb (ffsim.ucjopspinbalanced property)": [[0, "ffsim.UCJOpSpinBalanced.norb", false]], "norb (ffsim.ucjopspinless property)": [[0, "ffsim.UCJOpSpinless.norb", false]], "norb (ffsim.ucjopspinunbalanced property)": [[0, "ffsim.UCJOpSpinUnbalanced.norb", false]], "normal_ordered() (ffsim.fermionoperator method)": [[0, "ffsim.FermionOperator.normal_ordered", false]], "num_op_sum_linop() (in module ffsim.contract)": [[1, "ffsim.contract.num_op_sum_linop", false]], "number_operator() (in module ffsim)": [[0, "ffsim.number_operator", false]], "numnumansatzopspinbalanced (class in ffsim)": [[0, "ffsim.NumNumAnsatzOpSpinBalanced", false]], "numnumansatzopspinbalancedjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.NumNumAnsatzOpSpinBalancedJW", false]], "numopsumevolutionjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.NumOpSumEvolutionJW", false]], "numopsumevolutionspinlessjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.NumOpSumEvolutionSpinlessJW", false]], "one_body_integrals (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.one_body_integrals", false]], "one_body_linop() (in module ffsim.contract)": [[1, "ffsim.contract.one_body_linop", false]], "one_body_squares (ffsim.singlefactorizedhamiltonian attribute)": [[0, "ffsim.SingleFactorizedHamiltonian.one_body_squares", false]], "one_body_tensor (ffsim.diagonalcoulombhamiltonian attribute)": [[0, "ffsim.DiagonalCoulombHamiltonian.one_body_tensor", false]], "one_body_tensor (ffsim.doublefactorizedhamiltonian attribute)": [[0, "ffsim.DoubleFactorizedHamiltonian.one_body_tensor", false]], "one_body_tensor (ffsim.molecularhamiltonian attribute)": [[0, "ffsim.MolecularHamiltonian.one_body_tensor", false]], "one_body_tensor (ffsim.singlefactorizedhamiltonian attribute)": [[0, "ffsim.SingleFactorizedHamiltonian.one_body_tensor", false]], "one_hot() (in module ffsim)": [[0, "ffsim.one_hot", false]], "one_hot() (in module ffsim.linalg)": [[2, "ffsim.linalg.one_hot", false]], "orb (ffsim.fermionaction attribute)": [[0, "ffsim.FermionAction.orb", false]], "orbital_rotations (ffsim.doublefactorizedhamiltonian attribute)": [[0, "ffsim.DoubleFactorizedHamiltonian.orbital_rotations", false]], "orbital_rotations (ffsim.realucjoperator attribute)": [[0, "ffsim.RealUCJOperator.orbital_rotations", false]], "orbital_rotations (ffsim.ucjoperator attribute)": [[0, "ffsim.UCJOperator.orbital_rotations", false]], "orbital_rotations (ffsim.ucjopspinbalanced attribute)": [[0, "ffsim.UCJOpSpinBalanced.orbital_rotations", false]], "orbital_rotations (ffsim.ucjopspinless attribute)": [[0, "ffsim.UCJOpSpinless.orbital_rotations", false]], "orbital_rotations (ffsim.ucjopspinunbalanced attribute)": [[0, "ffsim.UCJOpSpinUnbalanced.orbital_rotations", false]], "orbital_symmetries (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.orbital_symmetries", false]], "orbitalrotationjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.OrbitalRotationJW", false]], "orbitalrotationspinlessjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.OrbitalRotationSpinlessJW", false]], "phase_angles (ffsim.givensansatzop attribute)": [[0, "ffsim.GivensAnsatzOp.phase_angles", false]], "phis (ffsim.givensansatzop attribute)": [[0, "ffsim.GivensAnsatzOp.phis", false]], "pre_init (in module ffsim.qiskit)": [[4, "ffsim.qiskit.PRE_INIT", false]], "pre_init_passes() (in module ffsim.qiskit)": [[4, "ffsim.qiskit.pre_init_passes", false]], "preparehartreefockjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.PrepareHartreeFockJW", false]], "preparehartreefockspinlessjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.PrepareHartreeFockSpinlessJW", false]], "prepareslaterdeterminantjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.PrepareSlaterDeterminantJW", false]], "prepareslaterdeterminantspinlessjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.PrepareSlaterDeterminantSpinlessJW", false]], "productstatesum (class in ffsim)": [[0, "ffsim.ProductStateSum", false]], "qiskit_vec_to_ffsim_vec() (in module ffsim.qiskit)": [[4, "ffsim.qiskit.qiskit_vec_to_ffsim_vec", false]], "random_antihermitian() (in module ffsim.random)": [[5, "ffsim.random.random_antihermitian", false]], "random_diagonal_coulomb_hamiltonian() (in module ffsim.random)": [[5, "ffsim.random.random_diagonal_coulomb_hamiltonian", false]], "random_double_factorized_hamiltonian() (in module ffsim.random)": [[5, "ffsim.random.random_double_factorized_hamiltonian", false]], "random_fermion_hamiltonian() (in module ffsim.random)": [[5, "ffsim.random.random_fermion_hamiltonian", false]], "random_fermion_operator() (in module ffsim.random)": [[5, "ffsim.random.random_fermion_operator", false]], "random_hermitian() (in module ffsim.random)": [[5, "ffsim.random.random_hermitian", false]], "random_molecular_hamiltonian() (in module ffsim.random)": [[5, "ffsim.random.random_molecular_hamiltonian", false]], "random_nelec() (in module ffsim.testing)": [[6, "ffsim.testing.random_nelec", false]], "random_occupied_orbitals() (in module ffsim.testing)": [[6, "ffsim.testing.random_occupied_orbitals", false]], "random_orthogonal() (in module ffsim.random)": [[5, "ffsim.random.random_orthogonal", false]], "random_real_symmetric_matrix() (in module ffsim.random)": [[5, "ffsim.random.random_real_symmetric_matrix", false]], "random_special_orthogonal() (in module ffsim.random)": [[5, "ffsim.random.random_special_orthogonal", false]], "random_state_vector() (in module ffsim.random)": [[5, "ffsim.random.random_state_vector", false]], "random_statevector() (in module ffsim.random)": [[5, "ffsim.random.random_statevector", false]], "random_t2_amplitudes() (in module ffsim.random)": [[5, "ffsim.random.random_t2_amplitudes", false]], "random_two_body_tensor() (in module ffsim.random)": [[5, "ffsim.random.random_two_body_tensor", false]], "random_ucj_op_spin_balanced() (in module ffsim.random)": [[5, "ffsim.random.random_ucj_op_spin_balanced", false]], "random_ucj_op_spin_unbalanced() (in module ffsim.random)": [[5, "ffsim.random.random_ucj_op_spin_unbalanced", false]], "random_ucj_op_spinless() (in module ffsim.random)": [[5, "ffsim.random.random_ucj_op_spinless", false]], "random_ucj_operator() (in module ffsim.random)": [[5, "ffsim.random.random_ucj_operator", false]], "random_unitary() (in module ffsim.random)": [[5, "ffsim.random.random_unitary", false]], "rdm() (in module ffsim)": [[0, "ffsim.rdm", false]], "rdms() (in module ffsim)": [[0, "ffsim.rdms", false]], "realucjoperator (class in ffsim)": [[0, "ffsim.RealUCJOperator", false]], "reduced_matrix() (in module ffsim.linalg)": [[2, "ffsim.linalg.reduced_matrix", false]], "reduced_matrix_product_states() (ffsim.singlefactorizedhamiltonian method)": [[0, "ffsim.SingleFactorizedHamiltonian.reduced_matrix_product_states", false]], "rotated() (ffsim.molecularhamiltonian method)": [[0, "ffsim.MolecularHamiltonian.rotated", false]], "run() (ffsim.qiskit.dropnegligible method)": [[4, "ffsim.qiskit.DropNegligible.run", false]], "run() (ffsim.qiskit.ffsimsampler method)": [[4, "ffsim.qiskit.FfsimSampler.run", false]], "run() (ffsim.qiskit.mergeorbitalrotations method)": [[4, "ffsim.qiskit.MergeOrbitalRotations.run", false]], "run_ccsd() (ffsim.moleculardata method)": [[0, "ffsim.MolecularData.run_ccsd", false]], "run_cisd() (ffsim.moleculardata method)": [[0, "ffsim.MolecularData.run_cisd", false]], "run_fci() (ffsim.moleculardata method)": [[0, "ffsim.MolecularData.run_fci", false]], "run_mp2() (ffsim.moleculardata method)": [[0, "ffsim.MolecularData.run_mp2", false]], "run_sci() (ffsim.moleculardata method)": [[0, "ffsim.MolecularData.run_sci", false]], "s (ffsim.linalg.givensrotation attribute)": [[2, "ffsim.linalg.GivensRotation.s", false]], "sample_slater_determinant() (in module ffsim)": [[0, "ffsim.sample_slater_determinant", false]], "sample_state_vector() (in module ffsim)": [[0, "ffsim.sample_state_vector", false]], "scf (ffsim.moleculardata property)": [[0, "ffsim.MolecularData.scf", false]], "sci_energy (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.sci_energy", false]], "sci_vec (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.sci_vec", false]], "simulate_qdrift_double_factorized() (in module ffsim)": [[0, "ffsim.simulate_qdrift_double_factorized", false]], "simulate_trotter_diag_coulomb_split_op() (in module ffsim)": [[0, "ffsim.simulate_trotter_diag_coulomb_split_op", false]], "simulate_trotter_double_factorized() (in module ffsim)": [[0, "ffsim.simulate_trotter_double_factorized", false]], "simulatetrotterdiagcoulombsplitopjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.SimulateTrotterDiagCoulombSplitOpJW", false]], "simulatetrotterdoublefactorizedjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.SimulateTrotterDoubleFactorizedJW", false]], "singlefactorizedhamiltonian (class in ffsim)": [[0, "ffsim.SingleFactorizedHamiltonian", false]], "slater_determinant() (in module ffsim)": [[0, "ffsim.slater_determinant", false]], "slater_determinant_rdm() (in module ffsim)": [[0, "ffsim.slater_determinant_rdm", false]], "slater_determinant_rdms() (in module ffsim)": [[0, "ffsim.slater_determinant_rdms", false]], "spin (class in ffsim)": [[0, "ffsim.Spin", false]], "spin (ffsim.fermionaction attribute)": [[0, "ffsim.FermionAction.spin", false]], "spin (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.spin", false]], "spin_square() (in module ffsim)": [[0, "ffsim.spin_square", false]], "states (ffsim.productstatesum attribute)": [[0, "ffsim.ProductStateSum.states", false]], "statevector (class in ffsim)": [[0, "ffsim.StateVector", false]], "string (ffsim.bitstringtype attribute)": [[0, "ffsim.BitstringType.STRING", false]], "strings_to_addresses() (in module ffsim)": [[0, "ffsim.strings_to_addresses", false]], "strings_to_indices() (in module ffsim)": [[0, "ffsim.strings_to_indices", false]], "supportsapplyunitary (class in ffsim)": [[0, "ffsim.SupportsApplyUnitary", false]], "supportsapproximateequality (class in ffsim)": [[0, "ffsim.SupportsApproximateEquality", false]], "supportsdiagonal (class in ffsim)": [[0, "ffsim.SupportsDiagonal", false]], "supportsfermionoperator (class in ffsim)": [[0, "ffsim.SupportsFermionOperator", false]], "supportslinearoperator (class in ffsim)": [[0, "ffsim.SupportsLinearOperator", false]], "supportstrace (class in ffsim)": [[0, "ffsim.SupportsTrace", false]], "symmetry (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.symmetry", false]], "thetas (ffsim.givensansatzop attribute)": [[0, "ffsim.GivensAnsatzOp.thetas", false]], "thetas (ffsim.givensansatzoperator attribute)": [[0, "ffsim.GivensAnsatzOperator.thetas", false]], "thetas (ffsim.hopgateansatzoperator attribute)": [[0, "ffsim.HopGateAnsatzOperator.thetas", false]], "thetas (ffsim.numnumansatzopspinbalanced attribute)": [[0, "ffsim.NumNumAnsatzOpSpinBalanced.thetas", false]], "to_diag_coulomb_mats() (ffsim.numnumansatzopspinbalanced method)": [[0, "ffsim.NumNumAnsatzOpSpinBalanced.to_diag_coulomb_mats", false]], "to_fcidump() (ffsim.moleculardata method)": [[0, "ffsim.MolecularData.to_fcidump", false]], "to_json() (ffsim.moleculardata method)": [[0, "ffsim.MolecularData.to_json", false]], "to_molecular_hamiltonian() (ffsim.doublefactorizedhamiltonian method)": [[0, "ffsim.DoubleFactorizedHamiltonian.to_molecular_hamiltonian", false]], "to_number_representation() (ffsim.doublefactorizedhamiltonian method)": [[0, "ffsim.DoubleFactorizedHamiltonian.to_number_representation", false]], "to_orbital_rotation() (ffsim.givensansatzop method)": [[0, "ffsim.GivensAnsatzOp.to_orbital_rotation", false]], "to_parameters() (ffsim.givensansatzop method)": [[0, "ffsim.GivensAnsatzOp.to_parameters", false]], "to_parameters() (ffsim.givensansatzoperator method)": [[0, "ffsim.GivensAnsatzOperator.to_parameters", false]], "to_parameters() (ffsim.hopgateansatzoperator method)": [[0, "ffsim.HopGateAnsatzOperator.to_parameters", false]], "to_parameters() (ffsim.numnumansatzopspinbalanced method)": [[0, "ffsim.NumNumAnsatzOpSpinBalanced.to_parameters", false]], "to_parameters() (ffsim.realucjoperator method)": [[0, "ffsim.RealUCJOperator.to_parameters", false]], "to_parameters() (ffsim.ucjoperator method)": [[0, "ffsim.UCJOperator.to_parameters", false]], "to_parameters() (ffsim.ucjopspinbalanced method)": [[0, "ffsim.UCJOpSpinBalanced.to_parameters", false]], "to_parameters() (ffsim.ucjopspinless method)": [[0, "ffsim.UCJOpSpinless.to_parameters", false]], "to_parameters() (ffsim.ucjopspinunbalanced method)": [[0, "ffsim.UCJOpSpinUnbalanced.to_parameters", false]], "to_t_amplitudes() (ffsim.realucjoperator method)": [[0, "ffsim.RealUCJOperator.to_t_amplitudes", false]], "to_t_amplitudes() (ffsim.ucjoperator method)": [[0, "ffsim.UCJOperator.to_t_amplitudes", false]], "to_z_representation() (ffsim.doublefactorizedhamiltonian method)": [[0, "ffsim.DoubleFactorizedHamiltonian.to_z_representation", false]], "trace() (in module ffsim)": [[0, "ffsim.trace", false]], "two_body_integrals (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.two_body_integrals", false]], "two_body_tensor (ffsim.molecularhamiltonian attribute)": [[0, "ffsim.MolecularHamiltonian.two_body_tensor", false]], "ucjoperator (class in ffsim)": [[0, "ffsim.UCJOperator", false]], "ucjoperatorjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.UCJOperatorJW", false]], "ucjopspinbalanced (class in ffsim)": [[0, "ffsim.UCJOpSpinBalanced", false]], "ucjopspinbalancedjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.UCJOpSpinBalancedJW", false]], "ucjopspinless (class in ffsim)": [[0, "ffsim.UCJOpSpinless", false]], "ucjopspinlessjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.UCJOpSpinlessJW", false]], "ucjopspinunbalanced (class in ffsim)": [[0, "ffsim.UCJOpSpinUnbalanced", false]], "ucjopspinunbalancedjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.UCJOpSpinUnbalancedJW", false]], "vec (ffsim.statevector attribute)": [[0, "ffsim.StateVector.vec", false]], "z_representation (ffsim.doublefactorizedhamiltonian attribute)": [[0, "ffsim.DoubleFactorizedHamiltonian.z_representation", false]]}, "objects": {"": [[0, 0, 0, "-", "ffsim"]], "ffsim": [[0, 1, 1, "", "BitstringType"], [0, 1, 1, "", "DiagonalCoulombHamiltonian"], [0, 1, 1, "", "DoubleFactorizedHamiltonian"], [0, 1, 1, "", "FermionAction"], [0, 1, 1, "", "FermionOperator"], [0, 1, 1, "", "GivensAnsatzOp"], [0, 1, 1, "", "GivensAnsatzOperator"], [0, 1, 1, "", "HopGateAnsatzOperator"], [0, 1, 1, "", "MolecularData"], [0, 1, 1, "", "MolecularHamiltonian"], [0, 1, 1, "", "NumNumAnsatzOpSpinBalanced"], [0, 1, 1, "", "ProductStateSum"], [0, 1, 1, "", "RealUCJOperator"], [0, 1, 1, "", "SingleFactorizedHamiltonian"], [0, 1, 1, "", "Spin"], [0, 1, 1, "", "StateVector"], [0, 1, 1, "", "SupportsApplyUnitary"], [0, 1, 1, "", "SupportsApproximateEquality"], [0, 1, 1, "", "SupportsDiagonal"], [0, 1, 1, "", "SupportsFermionOperator"], [0, 1, 1, "", "SupportsLinearOperator"], [0, 1, 1, "", "SupportsTrace"], [0, 1, 1, "", "UCJOpSpinBalanced"], [0, 1, 1, "", "UCJOpSpinUnbalanced"], [0, 1, 1, "", "UCJOpSpinless"], [0, 1, 1, "", "UCJOperator"], [0, 5, 1, "", "addresses_to_strings"], [0, 5, 1, "", "apply_diag_coulomb_evolution"], [0, 5, 1, "", "apply_fsim_gate"], [0, 5, 1, "", "apply_fswap_gate"], [0, 5, 1, "", "apply_givens_rotation"], [0, 5, 1, "", "apply_hop_gate"], [0, 5, 1, "", "apply_num_interaction"], [0, 5, 1, "", "apply_num_num_interaction"], [0, 5, 1, "", "apply_num_op_prod_interaction"], [0, 5, 1, "", "apply_num_op_sum_evolution"], [0, 5, 1, "", "apply_on_site_interaction"], [0, 5, 1, "", "apply_orbital_rotation"], [0, 5, 1, "", "apply_tunneling_interaction"], [0, 5, 1, "", "apply_unitary"], [0, 5, 1, "", "approx_eq"], [1, 0, 0, "-", "contract"], [0, 5, 1, "", "cre"], [0, 5, 1, "", "cre_a"], [0, 5, 1, "", "cre_b"], [0, 5, 1, "", "des"], [0, 5, 1, "", "des_a"], [0, 5, 1, "", "des_b"], [0, 5, 1, "", "diag"], [0, 5, 1, "", "dim"], [0, 5, 1, "", "dims"], [0, 5, 1, "", "expectation_one_body_power"], [0, 5, 1, "", "expectation_one_body_product"], [0, 5, 1, "", "fermi_hubbard_1d"], [0, 5, 1, "", "fermi_hubbard_2d"], [0, 5, 1, "", "fermion_operator"], [0, 5, 1, "", "hartree_fock_state"], [0, 5, 1, "", "indices_to_strings"], [0, 5, 1, "", "init_cache"], [2, 0, 0, "-", "linalg"], [0, 5, 1, "", "linear_operator"], [0, 5, 1, "", "multireference_state"], [0, 5, 1, "", "multireference_state_prod"], [0, 5, 1, "", "number_operator"], [0, 5, 1, "", "one_hot"], [3, 0, 0, "-", "optimize"], [4, 0, 0, "-", "qiskit"], [5, 0, 0, "-", "random"], [0, 5, 1, "", "rdm"], [0, 5, 1, "", "rdms"], [0, 5, 1, "", "sample_slater_determinant"], [0, 5, 1, "", "sample_state_vector"], [0, 5, 1, "", "simulate_qdrift_double_factorized"], [0, 5, 1, "", "simulate_trotter_diag_coulomb_split_op"], [0, 5, 1, "", "simulate_trotter_double_factorized"], [0, 5, 1, "", "slater_determinant"], [0, 5, 1, "", "slater_determinant_rdm"], [0, 5, 1, "", "slater_determinant_rdms"], [0, 5, 1, "", "spin_square"], [0, 5, 1, "", "strings_to_addresses"], [0, 5, 1, "", "strings_to_indices"], [6, 0, 0, "-", "testing"], [0, 5, 1, "", "trace"]], "ffsim.BitstringType": [[0, 2, 1, "", "BIT_ARRAY"], [0, 2, 1, "", "INT"], [0, 2, 1, "", "STRING"]], "ffsim.DiagonalCoulombHamiltonian": [[0, 2, 1, "", "constant"], [0, 2, 1, "", "diag_coulomb_mats"], [0, 3, 1, "", "from_fermion_operator"], [0, 4, 1, "", "norb"], [0, 2, 1, "", "one_body_tensor"]], "ffsim.DoubleFactorizedHamiltonian": [[0, 2, 1, "", "constant"], [0, 2, 1, "", "diag_coulomb_mats"], [0, 3, 1, "", "from_molecular_hamiltonian"], [0, 4, 1, "", "norb"], [0, 2, 1, "", "one_body_tensor"], [0, 2, 1, "", "orbital_rotations"], [0, 3, 1, "", "to_molecular_hamiltonian"], [0, 3, 1, "", "to_number_representation"], [0, 3, 1, "", "to_z_representation"], [0, 2, 1, "", "z_representation"]], "ffsim.FermionAction": [[0, 2, 1, "", "action"], [0, 2, 1, "", "orb"], [0, 2, 1, "", "spin"]], "ffsim.FermionOperator": [[0, 3, 1, "", "conserves_particle_number"], [0, 3, 1, "", "conserves_spin_z"], [0, 3, 1, "", "many_body_order"], [0, 3, 1, "", "normal_ordered"]], "ffsim.GivensAnsatzOp": [[0, 3, 1, "", "from_orbital_rotation"], [0, 3, 1, "", "from_parameters"], [0, 2, 1, "", "interaction_pairs"], [0, 3, 1, "", "n_params"], [0, 2, 1, "", "norb"], [0, 2, 1, "", "phase_angles"], [0, 2, 1, "", "phis"], [0, 2, 1, "", "thetas"], [0, 3, 1, "", "to_orbital_rotation"], [0, 3, 1, "", "to_parameters"]], "ffsim.GivensAnsatzOperator": [[0, 3, 1, "", "from_parameters"], [0, 2, 1, "", "interaction_pairs"], [0, 2, 1, "", "norb"], [0, 2, 1, "", "thetas"], [0, 3, 1, "", "to_parameters"]], "ffsim.HopGateAnsatzOperator": [[0, 2, 1, "", "final_orbital_rotation"], [0, 3, 1, "", "from_parameters"], [0, 2, 1, "", "interaction_pairs"], [0, 2, 1, "", "norb"], [0, 2, 1, "", "thetas"], [0, 3, 1, "", "to_parameters"]], "ffsim.MolecularData": [[0, 2, 1, "", "active_space"], [0, 2, 1, "", "atom"], [0, 2, 1, "", "basis"], [0, 2, 1, "", "ccsd_energy"], [0, 2, 1, "", "ccsd_t1"], [0, 2, 1, "", "ccsd_t2"], [0, 2, 1, "", "cisd_energy"], [0, 2, 1, "", "cisd_vec"], [0, 2, 1, "", "core_energy"], [0, 2, 1, "", "dipole_integrals"], [0, 2, 1, "", "fci_energy"], [0, 2, 1, "", "fci_vec"], [0, 3, 1, "", "from_fcidump"], [0, 3, 1, "", "from_json"], [0, 3, 1, "", "from_mole"], [0, 3, 1, "", "from_scf"], [0, 4, 1, "", "hamiltonian"], [0, 2, 1, "", "hf_energy"], [0, 2, 1, "", "hf_mo_coeff"], [0, 2, 1, "", "hf_mo_occ"], [0, 2, 1, "", "mo_coeff"], [0, 2, 1, "", "mo_occ"], [0, 4, 1, "", "mole"], [0, 2, 1, "", "mp2_energy"], [0, 2, 1, "", "mp2_t2"], [0, 2, 1, "", "nelec"], [0, 2, 1, "", "norb"], [0, 2, 1, "", "one_body_integrals"], [0, 2, 1, "", "orbital_symmetries"], [0, 3, 1, "", "run_ccsd"], [0, 3, 1, "", "run_cisd"], [0, 3, 1, "", "run_fci"], [0, 3, 1, "", "run_mp2"], [0, 3, 1, "", "run_sci"], [0, 4, 1, "", "scf"], [0, 2, 1, "", "sci_energy"], [0, 2, 1, "", "sci_vec"], [0, 2, 1, "", "spin"], [0, 2, 1, "", "symmetry"], [0, 3, 1, "", "to_fcidump"], [0, 3, 1, "", "to_json"], [0, 2, 1, "", "two_body_integrals"]], "ffsim.MolecularHamiltonian": [[0, 2, 1, "", "constant"], [0, 3, 1, "", "from_fcidump"], [0, 4, 1, "", "norb"], [0, 2, 1, "", "one_body_tensor"], [0, 3, 1, "", "rotated"], [0, 2, 1, "", "two_body_tensor"]], "ffsim.NumNumAnsatzOpSpinBalanced": [[0, 3, 1, "", "from_diag_coulomb_mats"], [0, 3, 1, "", "from_parameters"], [0, 2, 1, "", "interaction_pairs"], [0, 3, 1, "", "n_params"], [0, 2, 1, "", "norb"], [0, 2, 1, "", "thetas"], [0, 3, 1, "", "to_diag_coulomb_mats"], [0, 3, 1, "", "to_parameters"]], "ffsim.ProductStateSum": [[0, 2, 1, "", "coeffs"], [0, 2, 1, "", "states"]], "ffsim.RealUCJOperator": [[0, 2, 1, "", "diag_coulomb_mats_alpha_alpha"], [0, 2, 1, "", "diag_coulomb_mats_alpha_beta"], [0, 2, 1, "", "final_orbital_rotation"], [0, 3, 1, "", "from_parameters"], [0, 3, 1, "", "from_t_amplitudes"], [0, 3, 1, "", "n_params"], [0, 4, 1, "", "n_reps"], [0, 4, 1, "", "norb"], [0, 2, 1, "", "orbital_rotations"], [0, 3, 1, "", "to_parameters"], [0, 3, 1, "", "to_t_amplitudes"]], "ffsim.SingleFactorizedHamiltonian": [[0, 2, 1, "", "constant"], [0, 3, 1, "", "expectation_product_state"], [0, 3, 1, "", "from_molecular_hamiltonian"], [0, 4, 1, "", "norb"], [0, 2, 1, "", "one_body_squares"], [0, 2, 1, "", "one_body_tensor"], [0, 3, 1, "", "reduced_matrix_product_states"]], "ffsim.Spin": [[0, 2, 1, "", "ALPHA"], [0, 2, 1, "", "ALPHA_AND_BETA"], [0, 2, 1, "", "BETA"]], "ffsim.StateVector": [[0, 2, 1, "", "nelec"], [0, 2, 1, "", "norb"], [0, 2, 1, "", "vec"]], "ffsim.UCJOpSpinBalanced": [[0, 2, 1, "", "diag_coulomb_mats"], [0, 2, 1, "", "final_orbital_rotation"], [0, 3, 1, "", "from_parameters"], [0, 3, 1, "", "from_t_amplitudes"], [0, 3, 1, "", "n_params"], [0, 4, 1, "", "n_reps"], [0, 4, 1, "", "norb"], [0, 2, 1, "", "orbital_rotations"], [0, 3, 1, "", "to_parameters"]], "ffsim.UCJOpSpinUnbalanced": [[0, 2, 1, "", "diag_coulomb_mats"], [0, 2, 1, "", "final_orbital_rotation"], [0, 3, 1, "", "from_parameters"], [0, 3, 1, "", "from_t_amplitudes"], [0, 3, 1, "", "n_params"], [0, 4, 1, "", "n_reps"], [0, 4, 1, "", "norb"], [0, 2, 1, "", "orbital_rotations"], [0, 3, 1, "", "to_parameters"]], "ffsim.UCJOpSpinless": [[0, 2, 1, "", "diag_coulomb_mats"], [0, 2, 1, "", "final_orbital_rotation"], [0, 3, 1, "", "from_parameters"], [0, 3, 1, "", "from_t_amplitudes"], [0, 3, 1, "", "n_params"], [0, 4, 1, "", "n_reps"], [0, 4, 1, "", "norb"], [0, 2, 1, "", "orbital_rotations"], [0, 3, 1, "", "to_parameters"]], "ffsim.UCJOperator": [[0, 2, 1, "", "diag_coulomb_mats_alpha_alpha"], [0, 2, 1, "", "diag_coulomb_mats_alpha_beta"], [0, 2, 1, "", "final_orbital_rotation"], [0, 3, 1, "", "from_parameters"], [0, 3, 1, "", "from_t_amplitudes"], [0, 3, 1, "", "n_params"], [0, 4, 1, "", "n_reps"], [0, 4, 1, "", "norb"], [0, 2, 1, "", "orbital_rotations"], [0, 3, 1, "", "to_parameters"], [0, 3, 1, "", "to_t_amplitudes"]], "ffsim.contract": [[1, 5, 1, "", "contract_diag_coulomb"], [1, 5, 1, "", "contract_num_op_sum"], [1, 5, 1, "", "contract_one_body"], [1, 5, 1, "", "diag_coulomb_linop"], [1, 5, 1, "", "num_op_sum_linop"], [1, 5, 1, "", "one_body_linop"]], "ffsim.linalg": [[2, 1, 1, "", "GivensRotation"], [2, 5, 1, "", "apply_matrix_to_slices"], [2, 5, 1, "", "double_factorized"], [2, 5, 1, "", "double_factorized_t2"], [2, 5, 1, "", "double_factorized_t2_alpha_beta"], [2, 5, 1, "", "expm_multiply_taylor"], [2, 5, 1, "", "givens_decomposition"], [2, 5, 1, "", "is_antihermitian"], [2, 5, 1, "", "is_hermitian"], [2, 5, 1, "", "is_orthogonal"], [2, 5, 1, "", "is_real_symmetric"], [2, 5, 1, "", "is_special_orthogonal"], [2, 5, 1, "", "is_unitary"], [2, 5, 1, "", "lup"], [2, 5, 1, "", "match_global_phase"], [2, 5, 1, "", "modified_cholesky"], [2, 5, 1, "", "one_hot"], [2, 5, 1, "", "reduced_matrix"]], "ffsim.linalg.GivensRotation": [[2, 2, 1, "", "c"], [2, 2, 1, "", "i"], [2, 2, 1, "", "j"], [2, 2, 1, "", "s"]], "ffsim.optimize": [[3, 5, 1, "", "minimize_linear_method"]], "ffsim.qiskit": [[4, 1, 1, "", "DiagCoulombEvolutionJW"], [4, 1, 1, "", "DiagCoulombEvolutionSpinlessJW"], [4, 1, 1, "", "DropNegligible"], [4, 1, 1, "", "FfsimSampler"], [4, 1, 1, "", "GivensAnsatzOpJW"], [4, 1, 1, "", "GivensAnsatzOpSpinlessJW"], [4, 1, 1, "", "GivensAnsatzOperatorJW"], [4, 1, 1, "", "GivensAnsatzOperatorSpinlessJW"], [4, 1, 1, "", "MergeOrbitalRotations"], [4, 1, 1, "", "NumNumAnsatzOpSpinBalancedJW"], [4, 1, 1, "", "NumOpSumEvolutionJW"], [4, 1, 1, "", "NumOpSumEvolutionSpinlessJW"], [4, 1, 1, "", "OrbitalRotationJW"], [4, 1, 1, "", "OrbitalRotationSpinlessJW"], [4, 6, 1, "", "PRE_INIT"], [4, 1, 1, "", "PrepareHartreeFockJW"], [4, 1, 1, "", "PrepareHartreeFockSpinlessJW"], [4, 1, 1, "", "PrepareSlaterDeterminantJW"], [4, 1, 1, "", "PrepareSlaterDeterminantSpinlessJW"], [4, 1, 1, "", "SimulateTrotterDiagCoulombSplitOpJW"], [4, 1, 1, "", "SimulateTrotterDoubleFactorizedJW"], [4, 1, 1, "", "UCJOpSpinBalancedJW"], [4, 1, 1, "", "UCJOpSpinUnbalancedJW"], [4, 1, 1, "", "UCJOpSpinlessJW"], [4, 1, 1, "", "UCJOperatorJW"], [4, 5, 1, "", "ffsim_vec_to_qiskit_vec"], [4, 5, 1, "", "final_state_vector"], [4, 5, 1, "", "jordan_wigner"], [4, 5, 1, "", "pre_init_passes"], [4, 5, 1, "", "qiskit_vec_to_ffsim_vec"]], "ffsim.qiskit.DiagCoulombEvolutionJW": [[4, 3, 1, "", "__init__"], [4, 3, 1, "", "inverse"]], "ffsim.qiskit.DiagCoulombEvolutionSpinlessJW": [[4, 3, 1, "", "__init__"], [4, 3, 1, "", "inverse"]], "ffsim.qiskit.DropNegligible": [[4, 3, 1, "", "__init__"], [4, 3, 1, "", "run"]], "ffsim.qiskit.FfsimSampler": [[4, 3, 1, "", "__init__"], [4, 3, 1, "", "run"]], "ffsim.qiskit.GivensAnsatzOpJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.GivensAnsatzOpSpinlessJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.GivensAnsatzOperatorJW": [[4, 3, 1, "", "__init__"], [4, 3, 1, "", "__init_subclass__"], [4, 3, 1, "", "__new__"]], "ffsim.qiskit.GivensAnsatzOperatorSpinlessJW": [[4, 3, 1, "", "__init__"], [4, 3, 1, "", "__init_subclass__"], [4, 3, 1, "", "__new__"]], "ffsim.qiskit.MergeOrbitalRotations": [[4, 3, 1, "", "run"]], "ffsim.qiskit.NumNumAnsatzOpSpinBalancedJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.NumOpSumEvolutionJW": [[4, 3, 1, "", "__init__"], [4, 3, 1, "", "inverse"]], "ffsim.qiskit.NumOpSumEvolutionSpinlessJW": [[4, 3, 1, "", "__init__"], [4, 3, 1, "", "inverse"]], "ffsim.qiskit.OrbitalRotationJW": [[4, 3, 1, "", "__init__"], [4, 3, 1, "", "inverse"]], "ffsim.qiskit.OrbitalRotationSpinlessJW": [[4, 3, 1, "", "__init__"], [4, 3, 1, "", "inverse"]], "ffsim.qiskit.PrepareHartreeFockJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.PrepareHartreeFockSpinlessJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.PrepareSlaterDeterminantJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.PrepareSlaterDeterminantSpinlessJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.SimulateTrotterDiagCoulombSplitOpJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.SimulateTrotterDoubleFactorizedJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.UCJOpSpinBalancedJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.UCJOpSpinUnbalancedJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.UCJOpSpinlessJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.UCJOperatorJW": [[4, 3, 1, "", "__init__"], [4, 3, 1, "", "__init_subclass__"], [4, 3, 1, "", "__new__"]], "ffsim.random": [[5, 5, 1, "", "random_antihermitian"], [5, 5, 1, "", "random_diagonal_coulomb_hamiltonian"], [5, 5, 1, "", "random_double_factorized_hamiltonian"], [5, 5, 1, "", "random_fermion_hamiltonian"], [5, 5, 1, "", "random_fermion_operator"], [5, 5, 1, "", "random_hermitian"], [5, 5, 1, "", "random_molecular_hamiltonian"], [5, 5, 1, "", "random_orthogonal"], [5, 5, 1, "", "random_real_symmetric_matrix"], [5, 5, 1, "", "random_special_orthogonal"], [5, 5, 1, "", "random_state_vector"], [5, 5, 1, "", "random_statevector"], [5, 5, 1, "", "random_t2_amplitudes"], [5, 5, 1, "", "random_two_body_tensor"], [5, 5, 1, "", "random_ucj_op_spin_balanced"], [5, 5, 1, "", "random_ucj_op_spin_unbalanced"], [5, 5, 1, "", "random_ucj_op_spinless"], [5, 5, 1, "", "random_ucj_operator"], [5, 5, 1, "", "random_unitary"]], "ffsim.testing": [[6, 5, 1, "", "assert_allclose_up_to_global_phase"], [6, 5, 1, "", "generate_norb_nelec"], [6, 5, 1, "", "generate_norb_nelec_spin"], [6, 5, 1, "", "generate_norb_nocc"], [6, 5, 1, "", "generate_norb_spin"], [6, 5, 1, "", "random_nelec"], [6, 5, 1, "", "random_occupied_orbitals"]]}, "objnames": {"0": ["py", "module", "Python module"], "1": ["py", "class", "Python class"], "2": ["py", "attribute", "Python attribute"], "3": ["py", "method", "Python method"], "4": ["py", "property", "Python property"], "5": ["py", "function", "Python function"], "6": ["py", "data", "Python data"]}, "objtypes": {"0": "py:module", "1": "py:class", "2": "py:attribute", "3": "py:method", "4": "py:property", "5": "py:function", "6": "py:data"}, "terms": {"": [0, 2, 4, 8, 9, 13, 14, 15, 16, 17, 18, 19, 21, 22, 23], "0": [0, 2, 3, 4, 6, 8, 9, 11, 13, 14, 15, 16, 18, 19, 20, 21, 23], "00": 18, "000": 20, "0000000": [15, 18], "0000000000011100000000000111": 20, "0000000000011100000000011100": 20, "0000000000011100100000001100": 20, "0000000000110100000000001101": 20, "0000000001011000000000010110": 20, "0000000001011000100000000110": 20, "0000000001110000000000000111": 20, "0000000111100000011111": 20, "0000000111100110000111": 20, "0000010101100001011011": 20, "0000010110100001011011": 20, "0000100101100000111011": 20, "0000100110100000111011": 20, "0000111100001111": 20, "0000111100011011": 20, "0000111100011101": 20, "0000111100101011": 20, "0001": 3, "0001000001010000000000000111": 20, "0001110100001111": 20, "0010000000011000000000010110": 20, "0010011100101101": 20, "0010101100001111": 20, "0010101100101101": 20, "001011": [0, 14], "0010110100100111": 20, "0010110100101011": 20, "0010966013623508449": 18, "001101": [0, 14], "001110": [0, 14], "0019345282363449037": 18, "0019345284203860285": 18, "005e": 15, "01": [15, 18], "0100000000100100000000000111": 20, "0100000110100100001111": 20, "010011": [0, 14], "0101": 0, "0101000001100000011111": 20, "010101": [0, 14], "010110": [0, 14], "0110": 0, "013134424201630223": 18, "02": [15, 18], "02122442107772": 18, "02242": 2, "02459434j": 14, "02625": 2, "02998708j": 14, "03": 15, "03101213j": 14, "03525116j": 14, "03668541730983599": 23, "04": [15, 18], "04758323886585568": 18, "05": [0, 2, 3, 4, 18], "05395": 4, "06": 18, "0609050": 5, "0625": [0, 16], "06273307": 14, "06551571": 14, "06677383j": 14, "06844774j": 14, "06944034": 16, "07": [6, 18], "08": [0, 2, 3, 4], "086307j": 16, "08957": 2, "09723851": 14, "0b001011": 0, "0b010101": 0, "0b010110": 0, "0b100101": 0, "0b100110": 0, "0j": 16, "0x7fe05fc35f30": 19, "0x7fe05fc36230": 19, "0x7fe05fc36560": 19, "0x7fe05fc36770": 19, "0x7fe05fc36980": 19, "0x7fe05fc37100": 19, "0x7fe05fc374c0": 19, "0x7fe05fc37cd0": 19, "1": [0, 2, 3, 4, 5, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23], "10": [13, 18, 19, 20, 23], "100": 15, "1000": 3, "1000000101100000111011": 20, "100011": [0, 14], "100101": [0, 14], "100110": [0, 14], "101": 20, "1024": 4, "104": [15, 21], "1077416849405244": 20, "108": [20, 23], "108e": 15, "10_000": 20, "11": [0, 13, 19, 20, 23], "1102529j": 14, "11157654": 14, "112": 15, "12": [2, 13, 15, 16, 18, 23], "1207": 0, "12204343": 14, "1234": [9, 13, 14, 15, 19, 21], "12345": 20, "125": [0, 16], "126e": 18, "1278053627110059": 20, "1294": [15, 18], "12j": 16, "13": [0, 13, 18, 23], "13113848": 14, "133": 20, "13327423j": 14, "13957088j": 14, "14": [13, 20], "15": [13, 15, 20], "152e": 18, "153e": 18, "1561685j": 14, "15624569": 14, "15828306": 14, "15x15": 15, "16": 13, "17": 13, "1711": [2, 4], "17181289596": 21, "17276745j": 14, "174e": 15, "17558331": 14, "18": 13, "180": 15, "18007105": 14, "1808": 2, "18j": 16, "19": 0, "1e": [0, 2, 3, 4, 6, 15, 23], "1j": [0, 9, 16, 23], "2": [0, 1, 2, 4, 5, 8, 9, 11, 13, 14, 15, 16, 18, 19, 20, 23], "20835741": 14, "20881506": 14, "21": 0, "210": 20, "2104": 2, "2190712273": 9, "21928194": 14, "21984743e": 16, "221e": 18, "22392824": 14, "23": 15, "23550198": 14, "23611476": 14, "24": [13, 19], "246e": 18, "25": [0, 16], "25j": [0, 16], "26": 23, "26121865": 14, "263e": 18, "287e": 18, "29821173j": 14, "2d": 0, "2j": [0, 2, 16], "2n": 14, "3": [0, 2, 9, 11, 13, 14, 15, 16, 18, 19, 20, 23], "30052742j": 14, "31980058j": 14, "31g": [20, 21], "32": [13, 19], "329": 18, "33731417j": 14, "339": 18, "3484557064305": 20, "35": [0, 23], "36730125j": 14, "3714141": 14, "375": 18, "3773990245482654e": 18, "38435478j": 14, "39": [13, 14, 15, 16, 18, 19, 20], "39075171": 14, "3j": 16, "4": [0, 2, 8, 9, 13, 14, 15, 16, 18, 19, 20, 21, 23], "405e": 18, "417e": 15, "421e": 18, "435e": 15, "4390672": 14, "45619739137106": 20, "46": 18, "464957764796": 23, "46x46": 18, "47": 20, "478": 15, "48": [13, 20], "488e": 18, "49094286j": 14, "4j": 16, "5": [0, 3, 9, 13, 14, 15, 16, 18, 19, 20, 23], "51253171j": 14, "520e": 18, "524e": 18, "529e": 18, "537e": 18, "55717072551563": 9, "558e": 18, "559": 18, "56": [13, 19, 20], "561e": 18, "5626": 18, "563e": 18, "57": 20, "58888": 22, "5j": [0, 16], "6": [0, 9, 13, 14, 15, 16, 18, 19, 20, 21, 23], "603e": 15, "6083": 0, "623e": 18, "624e": 18, "6332495815006": 15, "64": 14, "65": 20, "657e": 18, "66": 20, "67794403659725": 15, "6787887956297": 15, "6787887956314": 15, "68381563541598": 15, "6g": [0, 15, 18, 23], "6j": 16, "7": [0, 9, 13, 14, 15, 16, 18, 19, 23], "70": 20, "72": 18, "7288249991515": 15, "72x72": 18, "73105542j": 14, "748e": 15, "75": [15, 20], "77": 18, "8": [0, 13, 15, 16, 19, 20, 23], "813579097194513e": 18, "8266321248744": 18, "835236570774": 20, "87160024816285": 18, "87363199406526": 18, "87363426711082": 18, "87363429661693": 18, "87363431320702": 18, "87387394279139": 18, "87421536374029": 18, "8742165643862": 18, "9": [13, 14, 16, 19, 20, 23], "9289": 18, "9402435386975859": 23, "949": 18, "958": 15, "9630419334854": 20, "99": 9, "990e": 18, "9924": 20, "998521286151879": 23, "9985212861519277": 23, "9991": 20, "9994145851204197": 18, "9994348455194204": 18, "9994348455232611": 18, "9996731164191628": 23, "A": [0, 1, 2, 3, 4, 5, 6, 8, 12, 13, 14, 16, 22, 23], "AND": 15, "As": [0, 11, 13, 14, 18, 19, 23], "By": 21, "For": [0, 3, 4, 8, 9, 11, 14, 15, 16, 22, 23], "If": [0, 1, 2, 3, 4, 5, 6, 13, 16], "In": [0, 8, 9, 11, 13, 14, 15, 16, 18, 19, 20, 23], "It": [0, 2, 3, 4, 13, 14, 16, 18, 20, 22], "Its": [3, 4], "NO": [15, 18], "No": 2, "Of": 11, "On": [14, 22], "One": [0, 23], "Such": 16, "That": [0, 3, 12, 16], "The": [0, 1, 2, 3, 4, 5, 6, 8, 9, 10, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23], "Their": 19, "Then": [0, 13], "There": 13, "These": [0, 11, 16, 19], "To": [0, 8, 9, 11, 14, 18, 23], "With": [11, 14, 23], "_": [0, 1, 2, 4, 8, 11, 12, 15, 23], "_1": 12, "_2": 12, "__init__": 4, "__init_subclass__": 4, "__new__": 4, "_factr": 18, "_i": [0, 4], "_k": [0, 8, 11], "_nestedsequ": 4, "_supportsarrai": 4, "a_": [0, 4, 8, 9, 12, 16], "a_j": 1, "a_p": 0, "a_q": 0, "ab": [0, 23], "abil": 8, "abl": 22, "about": 21, "abov": [13, 16], "absenc": [0, 1, 4], "absolut": [0, 2, 4, 6], "acceler": 22, "accept": [12, 18], "access": [0, 9, 22], "accommod": 4, "accomod": 8, "accur": 8, "achiev": [2, 23], "across": 22, "act": [0, 2, 4, 9, 13, 15, 16], "action": [0, 1, 12, 16, 22, 23], "activ": [0, 15, 18, 20, 23], "active_spac": [0, 15, 18, 20, 21, 23], "actual": [6, 11], "ad": [0, 13, 18], "add": [13, 18], "addit": [0, 8, 16, 23], "addition": 2, "address": [0, 13], "addresses_to_str": [0, 7, 14], "adjac": 13, "advantag": 18, "after": [3, 18], "al": 2, "algebra": [2, 9, 16], "algorithm": [0, 2, 3, 18, 21], "alia": [0, 2], "align": [0, 11, 12], "all": [0, 1, 2, 3, 4, 6, 11, 13, 16, 20, 22], "alloc": 0, "allow": [0, 2, 11, 13, 18, 22, 23], "along": 0, "alpha": [0, 1, 2, 4, 6, 9, 11, 13, 14, 15, 16, 19, 20], "alpha_alpha_indic": 0, "alpha_and_beta": 0, "alpha_beta_indic": 0, "alpha_i": 0, "alpha_j": 0, "alreadi": [0, 4, 12], "also": [0, 2, 3, 9, 12, 14, 16, 18, 23], "altern": [0, 8], "alwai": [0, 2, 5, 12, 14, 23], "amen": 13, "amplitud": [0, 2, 5, 18, 20], "an": [0, 1, 2, 4, 5, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 21, 23], "angl": 0, "ani": [0, 3, 4, 11, 12, 19, 20], "annihil": [0, 16], "anoth": [2, 6], "ansatz": [0, 3, 4, 5, 10, 13, 17, 19, 20, 21], "ansatz_oper": 0, "ansatz_st": 18, "anti": [2, 5], "anticommut": 12, "ao": 0, "ap": 2, "api": [14, 21], "appear": [0, 2, 13, 16, 20], "append": [0, 6, 13, 18, 19, 20], "appli": [0, 1, 2, 3, 4, 9, 11, 12, 13, 14, 18, 19, 20, 21, 23], "applic": 12, "apply_": 14, "apply_diag_coulomb_evolut": [0, 7, 8, 23], "apply_fsim_g": [0, 7], "apply_fswap_g": [0, 7], "apply_givens_rot": [0, 7], "apply_hop_g": [0, 7], "apply_matrix_to_slic": [2, 7], "apply_num_interact": [0, 7], "apply_num_num_interact": [0, 7], "apply_num_op_prod_interact": [0, 7], "apply_num_op_sum_evolut": [0, 7, 12, 23], "apply_on_site_interact": [0, 7, 14], "apply_orbital_rot": [0, 7, 12, 14, 21], "apply_quad_ham_evolut": 12, "apply_tunneling_interact": [0, 7, 14], "apply_unitari": [0, 7, 18], "appropri": [0, 11], "approx": 8, "approx_eq": [0, 7], "approxim": [0, 2, 3, 8, 18, 23], "apt": 22, "ar": [0, 1, 2, 4, 5, 6, 8, 9, 11, 12, 13, 14, 16, 19, 20, 22], "arbitrari": [4, 20], "arch": 22, "arg": [0, 4], "argument": [0, 2, 3, 8, 9, 12, 14, 23], "aris": 8, "arithmet": 16, "around": 23, "arrai": [0, 1, 2, 4, 6, 9, 11, 14, 16], "arxiv": [0, 2, 4, 5], "ascend": 20, "assembl": 2, "assert": 14, "assert_allclose_up_to_global_phas": [6, 7], "assertionerror": 6, "associ": [0, 3, 14, 16, 18], "assum": [0, 4, 14], "asterisk": 0, "asymmetr": 8, "atol": [0, 2, 4, 6], "atom": [0, 15, 18, 20, 21, 23], "attempt": 2, "attribut": [0, 3, 9, 15, 18, 20], "author": 21, "auto": 0, "avail": [9, 19, 22], "avoid": [0, 9, 16], "awar": 16, "ax": [0, 2], "axi": [0, 2], "b": [0, 2, 3, 6, 12, 15, 18], "back": 4, "backend": [13, 19], "backflow": 3, "background": 23, "balanc": [0, 4, 5, 18, 20], "barrier": 20, "base": [0, 2, 4], "basepass": 4, "basesamplerv2": 4, "basi": [0, 2, 4, 12, 15, 18, 20, 21, 23], "basic": [9, 13], "basis_g": [13, 19], "bear": 23, "becaus": [0, 2, 8, 9, 13, 15, 16, 18], "been": [0, 8], "befor": [0, 13, 16, 22, 23], "begin": [0, 2, 11, 12, 14, 20, 23], "behavior": [2, 4, 5, 19], "being": [2, 16, 18], "below": [0, 18, 23], "benchmark": 0, "beta": [0, 1, 2, 4, 6, 9, 11, 13, 14, 15, 16, 19, 20], "beta_i": 0, "beta_j": 0, "better": 8, "between": [0, 1, 2, 3, 11, 13], "bfg": [0, 2, 3, 15, 18], "bibtex": 21, "bit": [0, 13, 14], "bit_arrai": 0, "bitstr": [0, 14, 20], "bitstring_typ": [0, 14], "bitstringtyp": [0, 7, 14], "bla": 22, "bloc": 20, "block": 2, "block_diag": [0, 2], "bmod": 0, "bodi": [0, 1, 2, 5, 8, 9, 18, 23], "bond": 15, "bond_angle_deg": 15, "bond_dist": 18, "bool": [0, 1, 2, 3, 4, 5, 6], "both": [0, 1, 2, 4, 11, 15], "bound": [0, 2], "boundari": 0, "box": 13, "bq": 2, "bracket": 0, "braket": 0, "branch": 21, "brickwork": 15, "browser": 22, "buffer": 4, "build": [13, 17, 18, 20, 21, 22], "built": [19, 20, 23], "byte": [0, 4], "bz2": 0, "c": [2, 18], "c2v": 15, "cach": 0, "calcul": [0, 14, 18], "call": [0, 3, 4, 8, 9, 12, 14, 16, 18, 20, 23], "callabl": [3, 18], "callback": [0, 2, 3, 18], "can": [0, 1, 2, 4, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 21, 22, 23], "cannot": 20, "canon": 0, "casci": [15, 18], "case": [0, 6, 13, 15], "categori": 21, "caus": 0, "cc": [18, 20], "ccsd": [0, 18, 20], "ccsd_energi": 0, "ccsd_t1": 0, "ccsd_t2": 0, "cd": 22, "cdot": 2, "cell": [9, 13, 14, 18, 19, 20, 23], "certain": [2, 13], "challeng": 11, "character": 0, "check": [2, 4, 6], "chemcor": 23, "chemic": 0, "chemical_potenti": 0, "chemistri": 21, "choic": [0, 6, 13, 14], "choleski": [0, 2], "choos": [2, 14], "chosen": 0, "ci": [15, 18], "circuit": [0, 4, 8, 13, 14, 17, 21], "circul": 0, "cisd": 0, "cisd_energi": 0, "cisd_vec": 0, "class": [0, 2, 4, 5, 9, 11, 15, 17, 18, 20, 21, 23], "clement": 2, "clone": 22, "close": [11, 18], "cluster": [0, 4, 5, 10, 17, 21], "co": [0, 15], "code": [4, 9, 13, 14, 16, 18, 19, 20, 23], "coeff": [0, 1, 4, 13, 19], "coeffici": [0, 1, 2, 4, 12, 16], "collect": [0, 2, 4, 18], "column": [0, 2, 12, 14], "com": [21, 22], "comb": 4, "combin": [0, 1, 4, 12, 13, 16], "command": 22, "commonli": [8, 20], "commun": [21, 22], "commut": [0, 8], "compact": [8, 23], "compar": [0, 6, 23], "compil": 22, "complet": 0, "complex": [0, 1, 2, 4, 5, 9], "compon": [0, 16, 21], "compos": [4, 22], "compress": [0, 2], "compris": [0, 16], "comput": [0, 2, 4, 9, 12, 18, 21, 23], "concaten": [0, 14], "concret": 9, "condit": 0, "configur": [0, 4, 13, 14, 22], "conflict": 6, "conj": [2, 12, 20], "conjug": 2, "connect": [0, 11, 13], "consecut": [4, 20], "conserv": [0, 5, 16, 21], "conserves_particle_numb": [0, 16], "conserves_spin_z": [0, 16], "consid": [11, 12, 13], "consist": [0, 9, 13], "constant": [0, 5, 8, 9, 11, 13, 19], "constrain": 2, "constraint": [11, 18], "construct": [0, 1, 3, 4, 13, 14, 15, 16, 18, 19, 20, 23], "contain": [0, 2, 3, 13, 16, 20, 21, 22], "contract": [2, 7, 21], "contract_diag_coulomb": [1, 7], "contract_num_op_sum": [1, 7], "contract_one_bodi": [1, 7], "contrast": 14, "control": [3, 13], "conveni": 14, "convent": 0, "converg": [3, 15, 18, 20, 23], "convers": [11, 18], "convert": [0, 1, 4, 14, 16, 18, 20, 21, 23], "coordin": 0, "coov": 20, "copi": [0, 16], "core": 0, "core_energi": 0, "correl": 3, "correspond": [0, 2, 3, 4, 8, 12, 13, 14, 18], "cost": 0, "coulomb": [0, 1, 2, 4, 5, 8, 11, 23], "count": [0, 13, 20], "count_op": [13, 19], "cours": 11, "cp": [13, 19], "cphaseg": 13, "cre": [0, 7], "cre_a": [0, 7, 16], "cre_b": [0, 7, 16], "creat": [0, 4, 13, 14, 16, 19, 20, 21, 23], "creation": [0, 4, 12, 16], "criteria": 16, "current": [0, 2, 18], "d": [2, 22], "d2h": 18, "dag": 4, "dagcircuit": 4, "dagger": [0, 1, 2, 8, 11, 12, 16], "dagger_": [0, 4, 8, 9, 12], "dagger_i": 1, "dagger_p": 0, "dagger_q": 0, "data": [0, 5, 13, 15, 16, 18, 20, 21, 23], "daunt": 8, "de": [0, 7], "decompos": [2, 4, 8, 13, 19], "decomposit": [0, 2, 4, 8, 10, 19, 21, 23], "decreas": [0, 18], "def": [2, 12, 15, 18, 23], "default": [0, 2, 3, 4, 5, 8, 9, 23], "default_rng": [0, 4, 5, 6, 9, 13, 15, 19, 20], "default_shot": [4, 20], "defaultdict": 18, "defin": [0, 2, 13, 15, 18, 20, 23], "definit": [0, 2, 3, 14], "demonstr": [14, 18, 20], "denot": [0, 1, 2, 4, 12], "dens": 15, "densiti": 0, "depend": [0, 2, 3, 22, 23], "depolar": 4, "deprec": [0, 4, 5], "depth": 11, "deriv": 8, "des_a": [0, 7, 16], "des_b": [0, 7, 16], "descend": [0, 16], "describ": [0, 1, 2, 8, 11, 12, 13, 16, 23], "descript": [0, 4], "design": [0, 2, 12], "desir": [0, 2, 5, 6], "destroi": [0, 16], "detail": [13, 19], "determin": [0, 2, 4, 14], "determinant": 0, "dev": 22, "devel": 22, "develop": [4, 21], "devic": [13, 19], "df_hamiltonian": [13, 19, 23], "df_hamiltonian_alt": 23, "diag": [0, 7], "diag_coulomb_indic": [0, 2], "diag_coulomb_jw": 13, "diag_coulomb_linop": [1, 7], "diag_coulomb_mat": [0, 2, 13, 19, 20, 23], "diag_coulomb_mats_alpha_alpha": 0, "diag_coulomb_mats_alpha_beta": 0, "diagcoulombevolutionjw": [4, 7, 13, 19, 20], "diagcoulombevolutionspinlessjw": [4, 7], "diagon": [0, 1, 2, 4, 5, 8, 11, 23], "diagonal_coulomb_mat": 2, "diagonalcoulombhamiltonian": [0, 4, 5, 7], "dict": [0, 2, 3, 15, 18], "dictionari": [0, 16], "did": 0, "differ": [0, 1, 2, 3, 9, 11, 13, 18, 22, 23], "dim": [0, 5, 7, 14, 16], "dim_a": [0, 14], "dim_b": [0, 14], "dimens": [0, 2, 5, 14], "dimension": [0, 2, 4, 14], "dipol": 0, "dipole_integr": 0, "direct": [0, 23], "directli": [0, 13, 18, 22, 23], "directori": 22, "discuss": [8, 12, 13], "disjoint": 2, "disk": 0, "displai": [13, 16, 20], "distinguish": 14, "distribut": [4, 5], "divid": 8, "divis": [0, 16], "dnf": 22, "do": [8, 13, 16], "doc": [15, 18, 21], "docker": 21, "dockerfil": 22, "docstr": 0, "document": [0, 2], "doe": [0, 4, 16, 18, 20], "don": 11, "dooh": [20, 21, 23], "dot": 0, "doubl": [0, 2, 4, 5, 10, 21, 24], "double_factor": [0, 2, 7], "double_factorized_t2": [2, 7], "double_factorized_t2_alpha_beta": [2, 7], "doublefactorizedhamiltonian": [0, 4, 5, 7, 23], "down": 14, "draw": [13, 19], "drop": [4, 15, 18], "dropneglig": [4, 7], "dtype": [0, 2, 4, 5, 9, 15, 18], "due": 20, "dump": [15, 18], "duplic": 0, "dure": 4, "e": [0, 2, 4, 8, 9, 11, 15, 16, 18, 20], "e_corr": [18, 20], "each": [0, 2, 3, 4, 8, 11, 14, 16, 18, 22, 23], "edg": 0, "effect": [0, 4, 13], "effici": [8, 13, 16], "eig": [9, 16], "eigendecomposit": 12, "eigenvalu": [0, 2, 3, 9], "eigenvector": [0, 2], "eigh": [12, 23], "eigsh": 9, "einsum": 23, "either": [0, 1, 2, 4, 6, 11], "electon": 4, "electron": [0, 1, 4, 5, 9, 13, 14, 15, 19, 20, 23], "element": [0, 1, 2, 4, 20, 23], "ell": 2, "els": [0, 5, 14], "elsewher": 0, "enabl": 2, "encount": 20, "end": [0, 2, 11, 12, 20, 23], "energi": [0, 3, 9, 12, 18, 20, 21, 23], "energy_nuc": [15, 18], "enforc": 0, "enough": 4, "ensur": 9, "entangl": [0, 17, 21], "entir": [2, 8], "entri": [0, 2, 4, 11, 14, 23], "enum": 0, "enumer": [0, 18], "environ": 22, "epsilon": 3, "epsmch": 18, "equal": [0, 2, 6, 13], "equal_nan": 6, "equilibrium": 15, "equival": [0, 4], "err_msg": 6, "error": [0, 2, 4, 6, 23], "especi": 16, "estim": 9, "et": 2, "etc": 0, "ethen": 18, "evalu": [3, 15], "even": 13, "everi": 12, "everywher": 14, "evolut": [0, 4, 9, 23], "evolv": [0, 23], "evolved_vec": 9, "evolved_vec_2": 9, "exact": [2, 8, 9, 23], "exact_st": 23, "exampl": [0, 4, 9, 11, 13, 14, 15, 16, 18, 19, 22], "exce": [2, 15, 23], "except": [0, 2, 3], "excit": 13, "exist": [2, 4], "exp": [0, 2, 4, 6], "expand": 0, "expanded_diag_coulomb_mat": 2, "expanded_orbital_rot": 2, "expans": [2, 3], "expect": [0, 3], "expectation_one_body_pow": [0, 7], "expectation_one_body_product": [0, 7], "expectation_product_st": 0, "expens": [0, 2], "explain": [9, 11, 13, 14, 18, 23], "explan": [0, 19, 21], "explicit": 0, "explicitli": 0, "exploit": 21, "expm": 2, "expm_multipli": [9, 23], "expm_multiply_taylor": [2, 7], "exponenti": [8, 9, 23], "expos": [4, 13], "express": [11, 14, 23], "extend": 4, "extra": 8, "extract": 20, "f": [3, 14, 15, 18, 20, 23], "facilit": 11, "fact": 15, "factor": [0, 2, 4, 5, 10, 21, 24], "failur": 6, "fake_provid": [13, 19], "fals": [0, 1, 2, 4, 5, 15, 16, 18], "far": 16, "fast": 0, "faster": [18, 21], "fault": 11, "fci": [0, 14, 15, 18], "fci_energi": 0, "fci_vec": 0, "fcidump": 0, "fcivec": 0, "fedora": 22, "feenberg": 3, "fermi": 0, "fermi_hubbard_1d": [0, 7], "fermi_hubbard_2d": [0, 7], "fermion": [0, 4, 5, 6, 8, 10, 11, 12, 16, 19, 20, 21], "fermion_oper": [0, 7], "fermionact": [0, 7], "fermionoper": [0, 4, 5, 7, 17, 21], "few": [14, 22], "fewer": [13, 19, 23], "ffsim": [7, 8, 9, 11, 12, 13, 14, 15, 16, 17, 18, 19, 22, 23], "ffsim_vec_to_qiskit_vec": [4, 7], "ffsimsampl": [4, 7], "fidel": 23, "field": [0, 2], "fifth": 13, "file": [0, 22], "filter": 0, "final": [0, 3, 4, 5, 13, 19, 23], "final_orbital_rot": 0, "final_st": [18, 23], "final_state_vector": [4, 7], "finish": 23, "finit": 3, "first": [0, 2, 4, 8, 13, 14, 18, 20, 23], "fix": 14, "flag": 0, "float": [0, 2, 3, 4, 5, 6, 9, 12, 23], "float64": [9, 15, 18], "fock": [0, 4, 11, 14, 18, 21, 23], "focu": 9, "follow": [0, 2, 3, 4, 9, 11, 12, 13, 14, 16, 18, 19, 20, 21, 22, 23], "foot": 0, "forg": [0, 17, 21], "form": [0, 1, 2, 4, 8, 9, 11, 12, 16, 20, 23], "format": [0, 4], "formula": [0, 23], "fourth": [8, 13], "frac": [0, 2], "frac12": [0, 8, 9, 11], "frac18": 0, "framework": 22, "from": [0, 2, 4, 5, 6, 8, 11, 12, 13, 14, 15, 16, 18, 19, 21, 23], "from_diag_coulomb_mat": 0, "from_fcidump": 0, "from_fermion_oper": 0, "from_json": 0, "from_mol": 0, "from_molecular_hamiltonian": [0, 23], "from_orbital_rot": 0, "from_paramet": [0, 13, 18], "from_scf": [0, 15, 18, 20, 21, 23], "from_t_amplitud": [0, 18, 20], "frozen": [18, 20], "fsim": 0, "fswap": 0, "ftol": [3, 18], "full": [0, 2, 13, 14, 15], "fulli": 9, "fun": [3, 15, 18], "function": [0, 1, 2, 3, 5, 8, 9, 12, 14, 15, 16, 18, 19, 23], "fundament": 12, "further": [13, 14], "furthermor": [0, 2], "g": [0, 4, 15], "g_": 2, "g_1": 2, "g_i": 3, "g_k": 2, "g_l": 2, "gate": [0, 4, 10, 11, 15, 20, 21], "gener": [0, 3, 4, 5, 6, 8, 13, 14, 15, 19, 20, 21], "generate_norb_nelec": [6, 7], "generate_norb_nelec_spin": [6, 7], "generate_norb_nocc": [6, 7], "generate_norb_spin": [6, 7], "generate_preset_pass_manag": [13, 19], "genericbackendv2": [13, 19], "get": [0, 14, 15, 18, 20, 21, 23], "get_count": 20, "get_hcor": [15, 18], "get_ovlp": [15, 18], "git": 22, "github": [21, 22], "give": [0, 2, 8, 14, 19], "given": [0, 2, 4, 6, 8, 12], "givens_ansatz_op": 4, "givens_ansatz_oper": 4, "givens_decomposit": [2, 7], "givensansatzop": [0, 4, 7], "givensansatzoper": [0, 4, 7], "givensansatzoperatorjw": [4, 7], "givensansatzoperatorspinlessjw": [4, 7], "givensansatzopjw": [4, 7], "givensansatzopspinlessjw": [4, 7], "givensrot": [2, 7], "global": [4, 6], "global_depolar": 4, "go": [0, 13, 16], "good": 16, "gradient": [2, 3, 18], "greater": 3, "ground": [9, 18], "gt": [15, 18, 19, 20], "gto": [15, 18, 20, 21, 23], "gtol": 3, "guarante": [4, 19], "guess": [3, 18], "guid": [11, 15, 18, 19, 20, 21], "gzip": 0, "h": [0, 8, 9, 15, 18, 20, 23], "h1_x": 15, "h2_x": 15, "h2_y": 15, "h_": [0, 2, 8, 9], "h_0": [8, 23], "h_k": [8, 23], "ha": [0, 1, 2, 4, 8, 11, 12, 13, 14, 18], "haar": 5, "ham": 14, "hamiltonian": [0, 3, 4, 5, 10, 15, 18, 20, 21, 24], "hand": 14, "handl": [20, 23], "happen": 13, "hardwar": 13, "hartre": [0, 4, 11, 14, 18, 21, 23], "hartree_fock": 0, "hartree_fock_jw": 13, "hartree_fock_st": [0, 7, 9, 14, 18, 21, 23], "hasattr": 18, "hash": 16, "have": [0, 2, 8, 9, 11, 12, 13, 14, 16, 18, 20, 22], "height": 5, "helper": 16, "here": [0, 2, 8, 12, 13, 15, 23], "hermitian": [0, 2, 5, 12], "hess_inv": [15, 18], "hf": [15, 18], "hf_energi": 0, "hf_mo_coeff": 0, "hf_mo_occ": 0, "high": 13, "higher": [0, 8, 23], "ho": 20, "hold": [0, 3], "home": [15, 18, 22], "hop": [0, 15], "hopgateansatzoper": [0, 7, 15], "hot": [0, 2], "how": [0, 8, 9, 11, 12, 13, 14, 21, 23], "howev": [8, 13, 21], "http": [0, 21, 22], "hubbard": 0, "hydroxyl": 20, "hyperparamet": [3, 18], "i": [0, 1, 2, 3, 4, 5, 6, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23], "idea": 11, "ident": 0, "ignor": [0, 2, 8], "ij": [0, 1, 2, 4, 8, 11, 12], "ijab": 2, "ik": 12, "imag": 22, "implement": [0, 1, 3, 4, 8, 9, 11, 12, 13, 15, 18, 20, 21, 22, 24], "import": [0, 9, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23], "impos": [11, 18], "improv": [3, 23], "includ": [0, 2, 4, 5, 8, 9, 12, 13, 14, 15, 18, 19, 21, 22], "incorpor": 0, "increas": [0, 14, 23], "increment": 3, "incur": 3, "independ": [0, 1, 4, 15], "index": [0, 2, 11, 14, 16], "indic": [0, 1, 2, 4, 11, 14, 16], "indices_to_str": [0, 7], "individu": [8, 14, 16], "info": 18, "inform": [0, 9, 16, 18, 21, 23], "init_cach": [0, 7], "initi": [0, 3, 4, 5, 6, 9, 11, 13, 18, 19, 20, 23], "initial_st": 23, "initiali": 15, "input": [0, 1, 3, 4, 5, 6, 18, 20], "insert": 13, "instanc": [5, 9, 23], "instead": [0, 2, 4, 5, 18, 23], "instruct": [21, 22], "instructionset": 19, "int": [0, 1, 2, 3, 4, 5, 6, 12, 15, 23], "int32": 0, "integ": [0, 2, 4, 6, 14], "integr": [0, 4], "interact": [0, 1, 2, 4, 11, 13, 18, 20], "interaction_pair": [0, 13, 15, 18, 20], "interfac": [18, 22], "interferomet": 2, "intermedi": 18, "intermediate_result": [3, 18], "intern": 16, "interpret": [0, 11], "intor_symmetr": [15, 18], "introduc": [11, 12, 23], "invers": 4, "involv": [0, 12, 13], "ip": 2, "ipykernel_4237": 9, "is_antihermitian": [2, 7], "is_hermitian": [2, 7], "is_orthogon": [2, 7], "is_real_symmetr": [2, 7], "is_special_orthogon": [2, 7], "is_unitari": [2, 7], "isclos": 0, "isn": 4, "issu": [9, 13], "item": 20, "iter": [0, 3, 4, 6, 18], "itertool": 2, "its": [0, 2, 4, 9, 13, 14, 15, 16, 23], "itself": [0, 14, 16], "j": [0, 1, 2, 4, 8, 11, 12, 14, 15, 16], "jac": [3, 15, 18], "jastrow": [0, 3, 4, 5, 10, 17, 21], "ji": [0, 4, 11, 12], "jk": 12, "job": [4, 20], "jordan": [0, 4], "jordan_wign": [4, 7], "jq": 2, "json": [0, 15, 18], "jupyt": 22, "just": [0, 14, 18, 22, 23], "jwt": 4, "k": [0, 2, 3, 8, 9, 11, 16, 20, 23], "kappa": 0, "kappa_": 0, "keep": [0, 2], "kei": 20, "kij": 23, "know": 15, "known": [0, 8], "kpi": 23, "kqi": 23, "krj": 23, "kron": 0, "ksj": 23, "kwarg": [0, 4], "l": [0, 2, 3, 8, 11, 15, 18, 23], "label": [4, 14], "ladder": [8, 11], "lambda": [0, 4, 20], "lambda_i": [0, 1, 4, 12], "lambda_k": 12, "langl": 0, "larger": [0, 2, 3, 16], "last": [0, 2, 3, 4], "later": [19, 23], "lattic": [0, 11, 13, 18, 20], "layer": [0, 2, 13, 20], "lbfgsinvhessproduct": [15, 18], "ldot": [0, 2, 8, 11, 23], "lead": 0, "least": 2, "left": [0, 4, 12, 14, 16], "len": [15, 18, 23], "length": [0, 4, 5, 14, 15], "leq": [0, 2], "less": [2, 11], "let": [0, 13, 14, 16, 18, 19, 20, 23], "level": 23, "lexicograph": [0, 16], "lib": [15, 18], "libopenbla": 22, "librari": [0, 21], "like": [4, 11, 18, 22], "limit": [0, 2, 11, 13, 15, 18], "linalg": [0, 7, 9, 12, 16, 18, 21, 23], "lindep": 3, "line": [0, 11, 13, 18], "linear": [0, 1, 2, 3, 4, 9, 12, 13, 16], "linear_oper": [0, 7, 9, 16, 18, 21, 23], "linearli": 8, "linearoper": [0, 1, 3, 16, 18, 21, 23], "linop": [9, 16, 21, 23], "linux": 22, "list": [0, 2, 4, 6, 11, 14, 15, 18, 20, 23], "ll": [9, 12, 13, 15, 18, 20, 23], "lm": 16, "load": 0, "local": [10, 17, 21], "localhost": 22, "log": [0, 4], "logarithm": 11, "logic": [12, 15], "longer": 11, "longest": 0, "lookup": 0, "losslessli": 0, "low": [0, 8, 23], "lower": [0, 2], "lowest": [0, 13, 14], "lt": [15, 18, 19, 20], "lu": 2, "lucj": [10, 13, 17, 21], "lup": [2, 7], "lvert": [0, 4, 11, 14], "lzma": 0, "m": [0, 1, 2, 12], "m_": [0, 1, 2], "maco": 22, "made": 23, "magnitud": 0, "mai": [0, 2, 3, 4, 11, 22, 23], "main": [18, 22], "maintain": 8, "make": [11, 13], "manag": [4, 13, 19, 22], "mani": [0, 9, 12, 14, 21], "manual": 23, "many_body_ord": 0, "map": [0, 4, 12, 13, 16], "mapsto": [0, 4, 12], "mat": [0, 1, 2, 4, 12, 14], "mat_aa": 2, "mat_ab": 2, "mat_alpha_beta": 1, "mat_bb": 2, "match": [0, 2], "match_global_phas": [2, 7], "math": [5, 15], "mathbf": [0, 8, 11, 12], "mathcal": [0, 1, 4, 8, 11, 12], "matric": [0, 1, 2, 4, 11, 12, 23], "matrix": [0, 1, 2, 3, 4, 5, 8, 9, 11, 12, 14, 16], "max": [3, 23], "max_error": 23, "max_term_length": 5, "max_vec": [0, 2, 23], "maxfun": 15, "maximum": [0, 2, 3, 5, 23], "maxit": [3, 18], "mcscf": [15, 18], "mea": 20, "meant": [4, 19], "measur": [5, 8, 20], "measure_al": 20, "mention": 8, "merg": [4, 19], "mergeorbitalrot": [4, 7, 13], "messag": [6, 15, 18], "method": [0, 2, 3, 4, 11, 15, 16, 20, 21], "mid": 20, "might": 2, "mind": 23, "minim": [0, 2, 3, 13, 15, 18], "minimize_linear_method": [3, 7, 18], "minimizz": 15, "minimum": 4, "mk": 2, "mkap": 2, "mkbq": 2, "mkip": 2, "mkjq": 2, "mkpq": 2, "mo_coeff": 0, "mo_occ": 0, "mode": 12, "model": 0, "modifi": [0, 2], "modified_choleski": [2, 7], "modul": [0, 14, 15, 19, 20], "mol": [15, 18, 20, 21, 23], "mol_data": [15, 18, 20, 21, 23], "mol_hamiltonian": [9, 15, 18, 20, 23], "mole": [0, 15, 18, 20, 21, 23], "molecul": [0, 18, 21, 23], "molecular": [0, 5, 9, 10, 14, 15, 18, 20, 21, 23], "moleculardata": [0, 7, 15, 18, 20, 21, 23], "molecularhamiltonian": [0, 5, 7, 9, 23], "more": [0, 2, 3, 4, 8, 9, 11, 13, 14, 19, 23], "most": [0, 2, 16, 20], "motiv": 13, "mp2": 0, "mp2_energi": 0, "mp2_t2": 0, "mpl": [13, 19], "msg": [15, 18], "mu": 0, "much": [0, 2, 8, 13, 21], "multipl": [0, 9, 16, 23], "multipli": [0, 16], "multiport": 2, "multirefer": 0, "multireference_st": [0, 7], "multireference_state_prod": [0, 7, 15], "must": [0, 2, 3, 4, 16, 20], "n": [0, 2, 3, 8, 9, 11, 12, 14, 20, 21, 23], "n2": [20, 21, 23], "n_": [0, 1, 4, 8, 11, 12, 14], "n_alpha": [4, 6, 20], "n_beta": [4, 6, 20], "n_frozen": [20, 23], "n_i": 4, "n_j": 4, "n_layer": 15, "n_p": 0, "n_param": [0, 13], "n_qubit": 4, "n_rep": [0, 5, 13, 18, 19, 20], "n_sampl": 0, "n_step": [0, 4, 13, 19, 23], "n_term": 5, "n_vec": 2, "n_x": 0, "n_y": 0, "name": [0, 9, 13, 14, 19, 22], "namedtupl": [0, 2], "nan": 6, "nao_nr": [15, 18, 20, 21, 23], "nativ": 21, "navig": 22, "ndarrai": [0, 1, 2, 3, 4, 5, 6, 12, 18, 23], "nearest": 0, "nearest_neighbor_interact": 0, "need": [0, 4, 9, 11, 13, 20, 22, 23], "neg": [0, 4], "neglig": 4, "neighbor": [0, 13], "nelec": [0, 1, 4, 6, 9, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23], "nelectron": 18, "neq": 0, "nest": 2, "network": 11, "new": [0, 4, 12, 16], "newli": 0, "next": [13, 15, 23], "nfev": [3, 15, 18], "nit": [15, 18], "nitrogen": [20, 23], "njev": [15, 18], "nlinop": [3, 18], "nn": 0, "nocc": [0, 5, 6], "nocc_a": 2, "nocc_b": 2, "noisi": [4, 11], "non": [4, 11], "none": [0, 1, 2, 3, 4, 5, 6], "nonzero": [0, 2, 11], "norb": [0, 1, 2, 4, 5, 6, 9, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23], "norb_i": 0, "norb_rang": 6, "norb_x": 0, "norm": [0, 18], "normal": [0, 15, 16], "normal_ord": [0, 16], "note": [0, 2, 3, 13, 14, 16, 19, 21], "notebook": 22, "noth": 4, "notic": 18, "notimplementederror": 4, "now": [9, 13, 15, 18, 20, 23], "np": [0, 2, 4, 5, 6, 9, 12, 13, 15, 18, 19, 20, 21, 23], "num_num_ansatz_op": 4, "num_op_sum_linop": [1, 7], "number": [0, 1, 2, 3, 4, 5, 6, 8, 9, 12, 14, 15, 16, 18, 21, 23], "number_oper": [0, 7], "numer": [0, 2, 4, 16], "numnumansatzopspinbalanc": [0, 4, 7], "numnumansatzopspinbalancedjw": [4, 7], "numopsumevolutionjw": [4, 7, 13, 19], "numopsumevolutionspinlessjw": [4, 7], "numpi": [0, 1, 2, 4, 6, 9, 11, 12, 13, 14, 15, 18, 19, 20, 21, 23], "o": [0, 15, 20], "o_1": 0, "o_2": 0, "o_k": 0, "obj": 0, "object": [0, 2, 3, 4, 5, 9, 16, 18, 20], "obtain": [0, 8, 9, 12, 13, 18, 23], "occ_a": 6, "occ_b": 6, "occup": [0, 6, 8, 12, 14], "occupi": [0, 4, 5, 6, 13, 14], "occupied_orbit": [0, 4, 13, 19, 20], "often": [8, 11, 18], "onc": [12, 13, 22], "one": [0, 1, 2, 4, 5, 8, 9, 13, 14, 18, 20, 22, 23], "one_body_basis_chang": 23, "one_body_energi": 23, "one_body_integr": 0, "one_body_linop": [1, 7], "one_body_squar": 0, "one_body_tensor": [0, 9, 23], "one_hot": [0, 2, 7], "one_rdm": 0, "ones": 9, "onli": [0, 2, 4, 8, 11, 12, 13, 20, 22], "onsit": 0, "onto": [13, 16], "op": [0, 4, 16], "op1": [0, 16], "op2": [0, 16], "op3": 16, "op4": 16, "opaqu": 13, "open": [0, 11], "openbla": 22, "oper": [0, 1, 2, 3, 4, 5, 8, 11, 12, 16, 18, 22, 23], "oppos": 13, "opposit": [18, 20], "optim": [0, 2, 4, 7, 11, 13, 19, 21], "optimization_level": [13, 19], "optimize_kwarg": 3, "optimize_regular": 3, "optimize_vari": 3, "optimizeresult": [3, 18], "option": [0, 1, 2, 3, 4, 9, 15, 18, 22], "orb": [0, 16], "orbit": [0, 1, 2, 4, 5, 6, 8, 9, 10, 11, 14, 15, 16, 18, 20, 21, 23], "orbital_rot": [0, 1, 2, 4, 12, 13, 14, 19, 20, 21, 23], "orbital_rotation_a": 2, "orbital_rotation_b": 2, "orbital_symmetri": 0, "orbitalrotationjw": [4, 7, 13, 19, 20], "orbitalrotationspinlessjw": [4, 7], "order": [0, 1, 2, 4, 8, 9, 13, 14, 16, 19, 20, 23], "ordereddict": [13, 19], "org": 0, "origin": [0, 2, 11, 13, 23], "orthogon": [2, 5], "other": [0, 4, 11, 14, 18, 19, 20], "otherwis": 0, "our": [15, 18, 20, 23], "out": [2, 23], "output": [0, 3, 4, 13, 18, 20], "over": 0, "overrid": [0, 2], "overridden": 4, "overwritten": [0, 15, 18], "own": 4, "p": [0, 2, 8, 9, 11, 13, 18, 19, 20], "packag": [15, 18, 22], "pacman": 22, "pad": 0, "page": [8, 9, 11, 12, 13, 14], "pair": [0, 1, 2, 4, 6, 11, 13, 14], "pairs_aa": [13, 18, 20], "pairs_ab": [13, 18, 20], "pairs_bb": 20, "paper": 11, "parallel": [2, 11, 13], "param": 0, "paramet": [0, 1, 2, 3, 4, 5, 6, 11, 15, 18], "parameter_valu": 4, "params_to_vec": [3, 18], "pars": [15, 18], "part": [0, 5, 8, 12, 14, 15], "particl": [0, 5, 6, 12, 16, 21], "pass": [0, 1, 2, 4, 9, 12, 13, 14, 15, 16, 18, 19], "pass_manag": [13, 19], "passmanag": [4, 13], "path": 0, "pathlik": 0, "pattern": [13, 15], "pauli": 0, "per": 23, "perform": [0, 2, 3, 8, 9, 12, 13, 20, 23], "period": 0, "periodic_i": 0, "periodic_x": 0, "permut": 2, "persist": 22, "ph": 5, "phase": [0, 2, 4, 6, 13], "phase_angl": 0, "phaseg": 13, "phi": [0, 2, 6], "phi_0": 11, "pi": [0, 15], "piec": [9, 16], "pip": 21, "pipelin": 13, "pivot": 2, "pk": 2, "place": [0, 2, 11, 13, 16, 22], "plain": 14, "pmatrix": [0, 2], "point": 0, "polar": 0, "posit": [2, 3, 14], "possibl": [0, 2, 6, 20, 21], "possibli": [0, 18], "potenti": 0, "power": 0, "pq": [0, 2, 8, 9], "pqr": [0, 2, 8, 9, 23], "practic": 8, "pre": [11, 19], "pre_init": [4, 7, 13, 19], "pre_init_pass": [4, 7, 19], "precis": 6, "prepar": [0, 4, 20], "preparehartreefockjw": [4, 7, 13, 19, 20], "preparehartreefockspinlessjw": [4, 7, 20], "prepareslaterdeterminantjw": [4, 7, 13, 19, 20], "prepareslaterdeterminantspinlessjw": [4, 7, 20], "present": 3, "preserv": [16, 20], "preset_passmanag": [13, 19], "previou": [18, 20], "previous": [8, 13, 14, 18], "primit": [4, 17, 21], "primitivejob": 4, "primitiveresult": 4, "print": [0, 6, 13, 14, 15, 16, 18, 20, 21, 23], "probabl": [0, 4], "problem": 3, "process": 0, "processor": 11, "prod": 15, "prod_": [0, 4, 11], "prod_k": 8, "prod_state_sum": 0, "produc": [0, 13], "product": [0, 2, 8, 14, 15, 16], "productstatesum": [0, 7], "programmat": 16, "properti": [0, 2, 12], "proport": [0, 8], "protocol": 0, "provid": [9, 13, 19, 22], "pseudorandom": [0, 4, 5, 6], "psi": [0, 11], "pub": [4, 20], "pub_result": 20, "put": 15, "py": [9, 15, 18], "pypi": 22, "pyscf": [0, 4, 14, 15, 18, 20, 21, 23], "python3": [15, 18], "q": [0, 8, 9, 13, 19], "qdrift": 0, "qi": 0, "qiskit": [7, 13, 17, 21, 22], "qiskit_vec_to_ffsim_vec": [4, 7], "qk": 2, "quadrat": [8, 10, 21, 23], "qualnam": 0, "quantifi": 2, "quantiti": 0, "quantum": [0, 4, 8, 11, 13, 14, 17, 20, 21], "quantumcircuit": [4, 13, 19, 20], "quantumregist": [13, 19, 20], "qubit": [0, 4, 10, 11, 15, 19, 20, 21], "r": [0, 2, 8, 9], "radic": 20, "radius_1": 15, "radius_2": 15, "rais": [0, 2, 4, 6], "random": [0, 4, 6, 7, 9, 13, 14, 15, 16, 19, 20, 21], "random_antihermitian": [5, 7], "random_diagonal_coulomb_hamiltonian": [5, 7], "random_double_factorized_hamiltonian": [5, 7, 13, 19], "random_fermion_hamiltonian": [5, 7], "random_fermion_oper": [5, 7], "random_hermitian": [5, 7], "random_molecular_hamiltonian": [5, 7], "random_nelec": [6, 7], "random_occupied_orbit": [6, 7], "random_orthogon": [5, 7], "random_real_symmetric_matrix": [5, 7, 9, 13, 19, 20], "random_special_orthogon": [5, 7], "random_state_vector": [5, 7, 16], "random_statevector": [5, 7], "random_t2_amplitud": [5, 7], "random_two_body_tensor": [5, 7, 9], "random_ucj_op_spin_balanc": [5, 7, 13, 19], "random_ucj_op_spin_unbalanc": [5, 7, 19], "random_ucj_op_spinless": [5, 7], "random_ucj_oper": [5, 7], "random_unitari": [5, 7, 13, 14, 19, 20, 21], "rang": [0, 2, 6, 13, 14, 15, 18, 20, 21, 23], "rangl": [0, 4, 11, 14], "rank": [0, 2, 5, 8, 13], "rather": [0, 5, 12, 14], "rccsd": 20, "rdm": [0, 7], "rdm1": 0, "rdm2": 0, "rdm3": 0, "rdm4": 0, "reach": 18, "read": 0, "real": [0, 1, 2, 3, 4, 5, 6, 8, 9, 11, 12, 18, 21], "realucjoper": [0, 7], "reason": [4, 12], "recal": 13, "recommend": [4, 13, 16, 19, 21], "reconstruct": [0, 2, 23], "reconstruct_t2_alpha_beta": 2, "recover": 0, "reduc": [0, 2, 13], "reduced_matrix": [2, 7], "reduced_matrix_product_st": 0, "reduct": 18, "redund": 11, "refer": [0, 2, 3, 4, 5, 6, 11, 12, 14, 18, 21], "reference_occup": [0, 15], "reference_occupations_spati": 15, "reference_st": 18, "regress": 0, "regular": [3, 18], "rel": [0, 2, 4, 6, 18], "rel_reduction_of_f_": 18, "relat": 12, "releas": 21, "reorder": [0, 8], "rep": 13, "repeat": 15, "repeatedli": 12, "repetit": [0, 5, 11, 13, 18], "repositori": 22, "repr": 16, "repres": [0, 2, 3, 4, 6, 9, 11, 14, 16, 18, 19], "represent": [0, 1, 2, 4, 5, 10, 14, 16, 21, 23], "reproduc": 23, "requir": [0, 9, 11, 13, 14, 22], "reshap": 14, "respect": [0, 2, 3, 23], "rest": [0, 13], "restrict": [0, 13, 18], "result": [0, 1, 2, 3, 4, 5, 8, 9, 11, 13, 15, 18, 19, 20, 23], "retain": [0, 13], "retriev": 20, "return": [0, 1, 2, 3, 4, 5, 6, 12, 15, 16, 18, 23], "return_lower_rank": 0, "revers": 20, "rewrit": 0, "rewritten": 12, "rhf": [0, 15, 18, 20, 21, 23], "right": [0, 4, 12, 14, 16], "ring": 0, "rise": [2, 8], "rng": [9, 13, 15, 19, 20], "rohf": 20, "root": 0, "rotat": [0, 1, 2, 4, 5, 8, 10, 11, 14, 21, 23], "rotated_vec": 14, "routin": [2, 9, 16], "row": [0, 2, 14], "rtol": [0, 2, 4, 6], "rtype": [0, 2, 4], "run": [0, 4, 13, 15, 18, 19, 20, 21, 22, 23], "run_ccsd": 0, "run_cisd": 0, "run_fci": [0, 15, 18], "run_mp2": 0, "run_sci": 0, "rung": 11, "runner": [15, 18], "rust": 22, "rvert": 0, "s_": [0, 14], "s_a": 0, "s_b": 0, "sa": 9, "same": [0, 9, 11, 12, 13, 14, 15, 18, 20], "sampl": [0, 4, 5, 6, 9], "sample_slater_determin": [0, 7], "sample_state_vector": [0, 7], "sampler": [0, 4, 17, 21], "samplerpubresult": 4, "sandwich": 13, "satisfi": [0, 12, 16, 20, 22], "save": [0, 18, 22], "scalar": [0, 16], "scale": [8, 13, 15, 19], "scf": [0, 15, 18, 20, 21, 23], "scf_func": 0, "scheme": 8, "sci": 0, "sci_energi": 0, "sci_vec": 0, "scipi": [0, 2, 3, 15, 16, 18, 21, 23], "search": 14, "second": [0, 2, 4, 8], "section": [8, 19], "sector": [0, 1, 2, 4, 15], "see": [0, 2, 4, 11, 13, 14, 19, 22, 23], "seed": [0, 4, 5, 6, 9, 13, 14, 19, 20, 21], "seen": 20, "select": 3, "sens": [13, 23], "separ": [0, 11, 14], "sequenc": [0, 2, 4, 13], "seri": 2, "serial": 0, "serializ": [15, 18], "set": [0, 1, 2, 4, 5, 8, 11, 12, 13, 19, 23], "setup": 11, "sever": [9, 13], "shape": [0, 2, 5, 11, 23], "share": 11, "shell": [11, 18], "shot": [0, 4, 20], "should": [0, 1, 2, 4, 5, 6, 9, 12, 22], "show": [13, 15, 16, 18, 19, 20], "shown": 16, "side": 0, "sigma": [0, 1, 4, 8, 9, 11, 12], "sign": 0, "signatur": 3, "signific": 23, "significantli": 13, "similar": 18, "simpl": [20, 22], "simpler": 0, "simpli": [4, 13, 14], "simplist": 23, "simul": [0, 4, 8, 11, 12, 14, 17, 21, 24], "simulate_qdrift_double_factor": [0, 7], "simulate_trotter_diag_coulomb_split_op": [0, 7], "simulate_trotter_double_factor": [0, 7, 8, 23], "simulate_trotter_step_double_factor": 23, "simulatetrotterdiagcoulombsplitopjw": [4, 7], "simulatetrotterdoublefactorizedjw": [4, 7, 13, 19], "sin": [0, 15], "sinc": [0, 2, 11, 12, 15, 18], "singl": [0, 1, 4, 6, 8, 13, 23], "singlefactorizedhamiltonian": [0, 7], "singular": [0, 2], "site": [0, 15, 18], "size": [0, 3, 15], "slater": [0, 4], "slater_determin": [0, 7], "slater_determinant_rdm": [0, 7], "slice": 2, "small": 2, "smaller": [0, 2, 8, 16, 23], "so": [0, 2, 6, 8, 11, 12, 13, 15, 16, 22, 23], "softwar": [0, 21], "solv": 3, "some": [0, 2, 6, 9, 13, 14, 16, 18, 20], "sometim": [0, 14], "sort": 20, "sourc": [0, 1, 2, 3, 4, 5, 6, 21], "space": [0, 9, 14, 15, 18, 20, 23], "span": [0, 2], "spars": [9, 16, 23], "sparsepauliop": 4, "sparsiti": 11, "spatial": [0, 1, 4, 5, 6, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 23], "speci": [4, 6], "special": [2, 5, 11, 13, 21], "specif": 14, "specifi": [0, 1, 2, 3, 4, 5, 6, 9, 11, 13, 15, 23], "spectral": 0, "spin": [0, 1, 2, 4, 5, 6, 7, 12, 13, 14, 15, 16, 18, 20, 21], "spin_squar": [0, 7], "spin_sum": 0, "spinless": [0, 4, 5, 6], "split": [0, 4, 23], "squar": [0, 2, 11, 13, 18, 20], "stack": 0, "stage": [4, 13, 19], "standard": 18, "standard_norm": [9, 13, 19], "star": 2, "start": 0, "state": [0, 1, 3, 4, 5, 9, 10, 11, 12, 13, 18, 20, 21, 23], "statevector": [0, 4, 7], "static": [0, 4], "statist": 20, "statu": [15, 18], "step": [0, 4, 8, 12, 15, 19, 23], "step_tim": 23, "still": [0, 8], "sto": [0, 15, 18, 23], "stop": [3, 15, 18], "store": [0, 2, 4, 6, 9, 11, 13, 18, 19, 23], "store_cisd_vec": 0, "store_fci_vec": 0, "store_sci_vec": 0, "store_t1": 0, "store_t2": 0, "str": [0, 2, 4, 6], "straightforward": 2, "strategi": 0, "strength": 0, "strictli": 3, "string": [0, 14, 16], "strings_a": 0, "strings_b": 0, "strings_to_address": [0, 7], "strings_to_indic": [0, 7], "structur": [0, 8], "sub": 0, "subclass": 4, "subdirectori": 22, "submit": 20, "subroutin": 12, "subspac": [0, 2, 16], "substitut": 0, "subsystem": [14, 22], "subtract": [0, 16], "success": [15, 18], "sudo": 22, "suffix": 15, "suggest": 19, "sum": [0, 4, 8, 23], "sum_": [0, 1, 2, 4, 8, 9, 11, 12, 23], "sum_j": 12, "sum_k": [8, 12], "sum_p": 0, "sum_t": 0, "summat": 0, "support": [0, 2, 9, 14, 16, 20, 22], "supportsapplyunitari": [0, 7], "supportsapproximateequ": [0, 7], "supportsdiagon": [0, 7], "supportsfermionoper": [0, 7], "supportslinearoper": [0, 7], "supportstrac": [0, 7], "suzuki": [0, 23], "swap": [0, 11, 13], "symmetr": [0, 2, 4, 5, 8, 11], "symmetri": [0, 12, 15, 18, 20, 21, 23], "system": [0, 4, 6, 12, 14, 22], "t": [0, 2, 4, 8, 11, 12, 20, 21], "t1": 0, "t1a": 0, "t1b": 0, "t2": [0, 2, 5, 18, 20], "t2_amplitud": 2, "t2aa": 0, "t2ab": 0, "t2bb": 0, "t_": 2, "tabl": [0, 16], "take": [0, 3, 18, 19], "taken": 11, "target": [2, 13], "target_orb": 0, "tau": [0, 1, 4, 8, 9, 11], "taylor": 2, "tensor": [0, 1, 2, 5, 8, 9, 18, 23], "term": [0, 2, 5, 8, 11, 16, 23], "test": [7, 21, 23], "text": [0, 8, 9], "th": [2, 12], "than": [0, 4, 5, 12, 13, 14, 18, 21], "thei": [0, 9, 11, 12, 16], "them": [11, 13, 14], "therefor": [0, 2, 11], "theta": [0, 15], "thi": [0, 2, 4, 5, 8, 9, 11, 12, 13, 14, 15, 18, 19, 20, 21, 22, 23], "think": 2, "third": [0, 2], "those": [3, 18], "though": 13, "three": [0, 1, 4, 9, 16], "threshold": [0, 2, 3], "thu": 8, "time": [0, 2, 3, 4, 9, 13, 14, 19, 20, 23], "titl": 21, "tmp": [9, 15, 18], "tmpfo16w5i1": 15, "tmpk6ithy5m": 18, "to_diag_coulomb_mat": 0, "to_fcidump": 0, "to_json": 0, "to_molecular_hamiltonian": 0, "to_number_represent": 0, "to_orbital_rot": 0, "to_paramet": [0, 18], "to_t_amplitud": 0, "to_z_represent": 0, "tol": [0, 2, 23], "toler": [0, 2, 4, 6, 11, 23], "too": 2, "top": 20, "topologi": [11, 13, 18], "toru": 0, "total": [0, 4, 8, 15, 18, 23], "tox": [15, 18], "trace": [0, 7, 9, 23], "tracea": [9, 23], "trajectori": 0, "transform": [0, 1, 4], "transformationpass": 4, "transpil": [4, 13, 17, 21], "transpiled_opt": 13, "treat": 0, "triangl": 11, "trianglular": [0, 2], "triangular": [0, 2, 4], "triplet": 6, "trotter": [0, 4, 21, 24], "true": [0, 2, 3, 4, 6, 16, 18, 20], "truncat": 8, "try": 23, "tunnel": 0, "tupl": [0, 1, 2, 4, 6, 12, 15, 16, 23], "tutori": [21, 23], "twice": [0, 15, 19], "two": [0, 2, 5, 8, 9, 11, 13, 14, 15, 18, 22, 23], "two_body_integr": 0, "two_body_tensor": [0, 2, 9, 23], "type": [0, 1, 2, 3, 4, 5, 6, 20, 22], "typeerror": 0, "typic": 0, "u": [0, 1, 2, 4, 8, 11, 12], "u_": 4, "u_k": 0, "ubuntu": 22, "uccsd": 20, "ucj": [0, 4, 5], "ucj_balanced_jw": 13, "ucj_op": [4, 13, 19, 20], "ucj_oper": 4, "ucjoper": [0, 4, 5, 7], "ucjoperatorjw": [4, 7], "ucjopspinbalanc": [0, 4, 5, 7, 11, 13, 18, 20], "ucjopspinbalancedjw": [4, 7, 13, 19, 20], "ucjopspinless": [0, 4, 5, 7], "ucjopspinlessjw": [4, 7], "ucjopspinunbalanc": [0, 4, 5, 7, 11, 20], "ucjopspinunbalancedjw": [4, 7, 13, 19, 20], "uhf": 20, "unbalanc": [0, 4, 5, 20], "uncorrel": 0, "under": [0, 4], "underli": 4, "unifi": 20, "uniform": [0, 4, 5], "unimpl": 4, "union": [2, 4], "unit": 2, "unitari": [0, 1, 2, 4, 5, 8, 10, 12, 14, 17, 21], "univers": 2, "unlik": 0, "unord": 0, "untouch": 0, "up": [0, 2, 6, 8, 14, 22], "updat": [0, 8], "upon": 16, "upper": [0, 2, 4, 11], "url": 21, "us": [0, 1, 2, 3, 4, 5, 8, 9, 11, 12, 13, 14, 15, 17, 18, 19, 21, 23], "usag": [0, 2, 16, 19], "user": 22, "userwarn": [9, 15, 18], "usual": 0, "util": [2, 5, 6, 8], "v": [0, 20], "v_": 0, "v_i": 2, "v_j": 2, "vacuum": 4, "valid": [0, 4, 5, 6], "valu": [0, 1, 2, 3, 4, 5, 6, 9, 11, 18, 19, 23], "valueerror": [0, 2, 4], "vari": [0, 4], "variabl": [14, 23], "variant": [11, 13, 18], "variat": [0, 3, 11, 18], "variation": 18, "varphi": 0, "vdot": [18, 21, 23], "ve": 23, "vec": [0, 1, 2, 4, 9, 12, 14, 16, 21, 23], "vec_a": 0, "vec_b": 0, "vector": [0, 1, 2, 3, 4, 5, 9, 10, 11, 12, 15, 16, 18, 21], "verbos": 6, "verifi": 2, "version": 4, "vertic": 0, "via": [0, 23], "view": [0, 16], "volum": 22, "w": 0, "w_k": 0, "wa": [0, 3, 4, 11], "wai": 11, "want": 13, "warn": [9, 15, 18, 20], "water": 15, "wavefunct": [3, 18], "we": [0, 2, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23], "web": 22, "weight": 14, "well": [3, 14, 21, 22, 23], "when": [0, 3, 4, 9, 11, 13, 14, 16, 19, 21], "whenev": 0, "where": [0, 1, 2, 3, 4, 8, 11, 12, 14, 22, 23], "whether": [0, 1, 2, 3, 4, 5, 16], "which": [0, 2, 4, 5, 8, 9, 11, 12, 13, 14, 15, 16, 22, 23], "while": [8, 11], "whose": [0, 2, 14], "width": 5, "wigner": [0, 4], "william": 2, "window": [21, 22], "wise": 2, "with_final_orbital_rot": [0, 5], "with_phase_angl": 0, "with_phi": 0, "within": [0, 2, 13, 16, 18, 21], "without": [11, 13, 18], "won": 21, "word": [0, 11, 20], "work": [9, 13, 15, 18, 19, 21, 22], "workflow": 20, "would": [13, 14], "wrapper": 23, "write": 23, "written": 8, "wrote": 23, "wsl": 22, "x": [0, 3, 4, 13, 15, 18, 19, 20], "x0": [3, 15, 18], "xx_plus_yi": [13, 19], "xxplusyyg": [13, 19], "y": 0, "yaml": 22, "yet": [9, 18], "yield": [0, 2, 4, 8, 11, 15, 23], "you": [0, 1, 2, 4, 9, 14, 18, 21, 22, 23], "your": [19, 22], "z": [0, 1, 2, 4, 5, 12, 16, 21], "z_represent": [0, 1, 4, 5], "zero": [0, 2, 4, 9, 19], "zip": [0, 15, 18, 23], "\u03c8": 18}, "titles": ["ffsim", "ffsim.contract", "ffsim.linalg", "ffsim.optimize", "ffsim.qiskit", "ffsim.random", "ffsim.testing", "API reference", "Double-factorized representation of the molecular Hamiltonian", "Hamiltonians", "Explanations", "The local unitary cluster Jastrow (LUCJ) ansatz", "Orbital rotations and quadratic Hamiltonians", "Qubit gate decompositions of fermionic gates", "State vectors and gates", "How to simulate entanglement forging", "How to use the FermionOperator class", "How-to guides", "How to simulate the local unitary cluster Jastrow (LUCJ) ansatz", "How to build and transpile Qiskit quantum circuits", "How to use ffsim\u2019s Qiskit Sampler primitive", "ffsim", "Installation", "Implementing Trotter simulation of the double-factorized Hamiltonian", "Tutorials"], "titleterms": {"": 20, "The": 11, "action": 9, "an": 20, "ansatz": [11, 15, 18], "api": 7, "applic": 8, "background": 8, "balanc": [11, 19], "brief": 8, "build": [15, 19, 23], "can": 20, "choos": 15, "circuit": [19, 20], "cite": 21, "class": 16, "close": 20, "cluster": [11, 13, 18, 19], "code": 21, "comput": 15, "content": 21, "contract": 1, "coulomb": [13, 19], "criteria": 20, "data": 9, "decomposit": 13, "determin": [13, 19], "diagon": [13, 19], "docker": 22, "doubl": [8, 13, 19, 23], "energi": 15, "entangl": 15, "evolut": [8, 12, 13, 19], "exampl": [20, 21], "explan": 10, "factor": [8, 13, 19, 23], "fermion": [13, 14], "fermionoper": 16, "ffsim": [0, 1, 2, 3, 4, 5, 6, 20, 21], "ffsimsampl": 20, "fock": [13, 19], "forg": 15, "formula": 8, "from": [20, 22], "gate": [13, 14, 19], "gener": [11, 18], "guid": 17, "hamiltonian": [8, 9, 12, 13, 19, 23], "hartre": [13, 19], "how": [15, 16, 17, 18, 19, 20], "implement": 23, "initi": 15, "instal": [21, 22], "jastrow": [11, 13, 18, 19], "linalg": 2, "linear": 18, "linearoper": 9, "local": [11, 13, 18], "lucj": [11, 18, 20], "merg": 13, "method": 18, "molecul": [15, 20], "molecular": 8, "more": 20, "number": [13, 19], "occup": 15, "open": 20, "oper": [9, 13, 15, 19], "optim": [3, 15, 18], "orbit": [12, 13, 19], "overview": 19, "pip": 22, "prepar": [13, 19], "primit": 20, "qiskit": [4, 19, 20], "quadrat": 12, "quantum": 19, "qubit": 13, "random": 5, "refer": [7, 15], "represent": [8, 9], "rotat": [12, 13, 19], "sampl": 20, "sampler": 20, "scipi": 9, "shell": 20, "simul": [13, 15, 18, 19, 23], "slater": [13, 19], "sourc": 22, "spin": [11, 19], "spinless": 14, "state": [14, 19], "sum": [13, 19], "suzuki": 8, "test": 6, "time": [8, 12], "transform": 19, "transpil": 19, "treat": 14, "trotter": [8, 13, 19, 23], "tutori": 24, "ucj": [11, 13, 18, 19], "unbalanc": [11, 19], "unitari": [11, 13, 18, 19], "us": [16, 20, 22], "vector": 14, "via": [8, 9], "within": 22}})
\ No newline at end of file
+Search.setIndex({"alltitles": {"API reference": [[7, null]], "Application to the double-factorized Hamiltonian": [[8, "Application-to-the-double-factorized-Hamiltonian"]], "Application to time evolution via Trotter-Suzuki formulas": [[8, "Application-to-time-evolution-via-Trotter-Suzuki-formulas"]], "Brief background on Trotter-Suzuki formulas": [[8, "Brief-background-on-Trotter-Suzuki-formulas"]], "Build a molecule": [[15, "Build-a-molecule"]], "Build the Hamiltonian": [[23, "Build-the-Hamiltonian"]], "Choose reference occupations": [[15, "Choose-reference-occupations"]], "Circuit transpilation": [[19, "Circuit-transpilation"]], "Citing ffsim": [[21, "citing-ffsim"]], "Code example": [[21, "code-example"]], "Compute energy": [[15, "Compute-energy"]], "Contents": [[21, "contents"]], "Criteria for circuits that FfsimSampler can sample": [[20, "Criteria-for-circuits-that-FfsimSampler-can-sample"]], "Data representation": [[9, "Data-representation"]], "Diagonal Coulomb evolution": [[13, "Diagonal-Coulomb-evolution"], [19, "Diagonal-Coulomb-evolution"]], "Double-factorized representation": [[8, "Double-factorized-representation"]], "Double-factorized representation of the molecular Hamiltonian": [[8, null]], "Example of using FfsimSampler": [[20, "Example-of-using-FfsimSampler"]], "Explanations": [[10, null]], "Gates": [[14, "Gates"]], "General UCJ ansatz": [[18, "General-UCJ-ansatz"]], "Hamiltonians": [[9, null]], "Hartree-Fock and Slater determinant preparation": [[13, "Hartree-Fock-and-Slater-determinant-preparation"]], "How to build and transpile Qiskit quantum circuits": [[19, null]], "How to simulate entanglement forging": [[15, null]], "How to simulate the local unitary cluster Jastrow (LUCJ) ansatz": [[18, null]], "How to use ffsim\u2019s Qiskit Sampler primitive": [[20, null]], "How to use the FermionOperator class": [[16, null]], "How-to guides": [[17, null]], "Implement Trotter simulation": [[23, "Implement-Trotter-simulation"]], "Implementing Trotter simulation of the double-factorized Hamiltonian": [[23, null]], "Initialize ansatz operator": [[15, "Initialize-ansatz-operator"]], "Install from source": [[22, "install-from-source"]], "Installation": [[21, "installation"], [22, null]], "LUCJ ansatz": [[18, "LUCJ-ansatz"]], "Locality in the UCJ operator": [[13, "Locality-in-the-UCJ-operator"]], "Merging orbital rotations": [[13, "Merging-orbital-rotations"]], "More examples": [[20, "More-examples"]], "Number operator sum evolution": [[13, "Number-operator-sum-evolution"], [19, "Number-operator-sum-evolution"]], "Operator action via SciPy LinearOperators": [[9, "Operator-action-via-SciPy-LinearOperators"]], "Optimize energy": [[15, "Optimize-energy"]], "Optimize with the linear method": [[18, "Optimize-with-the-linear-method"]], "Orbital rotation": [[13, "Orbital-rotation"], [19, "Orbital-rotation"]], "Orbital rotations": [[12, "Orbital-rotations"]], "Orbital rotations and quadratic Hamiltonians": [[12, null]], "Overview of gates": [[19, "Overview-of-gates"]], "Pip install": [[22, "pip-install"]], "Prepare Hartree-Fock state": [[19, "Prepare-Hartree-Fock-state"]], "Prepare Slater determinant": [[19, "Prepare-Slater-determinant"]], "Qubit gate decompositions of fermionic gates": [[13, null]], "Sampling from an LUCJ circuit for a closed-shell molecule": [[20, "Sampling-from-an-LUCJ-circuit-for-a-closed-shell-molecule"]], "Sampling from an LUCJ circuit for an open-shell molecule": [[20, "Sampling-from-an-LUCJ-circuit-for-an-open-shell-molecule"]], "Spin-balanced and spin-unbalanced ansatzes": [[11, "Spin-balanced-and-spin-unbalanced-ansatzes"]], "Spin-balanced unitary cluster Jastrow (UCJ) operator": [[19, "Spin-balanced-unitary-cluster-Jastrow-(UCJ)-operator"]], "Spin-unbalanced unitary cluster Jastrow (UCJ) operator": [[19, "Spin-unbalanced-unitary-cluster-Jastrow-(UCJ)-operator"]], "State preparation gates": [[19, "State-preparation-gates"]], "State vectors": [[14, "State-vectors"]], "State vectors and gates": [[14, null]], "The general unitary cluster Jastrow (UCJ) ansatz": [[11, "The-general-unitary-cluster-Jastrow-(UCJ)-ansatz"]], "The local UCJ (LUCJ) ansatz": [[11, "The-local-UCJ-(LUCJ)-ansatz"]], "The local unitary cluster Jastrow (LUCJ) ansatz": [[11, null]], "Time evolution by a quadratic Hamiltonian": [[12, "Time-evolution-by-a-quadratic-Hamiltonian"]], "Treating spinless fermions": [[14, "Treating-spinless-fermions"]], "Trotter simulation of double-factorized Hamiltonian": [[13, "Trotter-simulation-of-double-factorized-Hamiltonian"], [19, "Trotter-simulation-of-double-factorized-Hamiltonian"]], "Tutorials": [[24, null]], "Unitary cluster Jastrow (UCJ) operator": [[13, "Unitary-cluster-Jastrow-(UCJ)-operator"]], "Unitary transformation gates": [[19, "Unitary-transformation-gates"]], "Use within Docker": [[22, "use-within-docker"]], "ffsim": [[0, null], [21, null]], "ffsim.contract": [[1, null]], "ffsim.linalg": [[2, null]], "ffsim.optimize": [[3, null]], "ffsim.qiskit": [[4, null]], "ffsim.random": [[5, null]], "ffsim.testing": [[6, null]]}, "docnames": ["api/ffsim", "api/ffsim.contract", "api/ffsim.linalg", "api/ffsim.optimize", "api/ffsim.qiskit", "api/ffsim.random", "api/ffsim.testing", "api/index", "explanations/double-factorized", "explanations/hamiltonians", "explanations/index", "explanations/lucj", "explanations/orbital-rotation", "explanations/qiskit-gate-decompositions", "explanations/state-vectors-and-gates", "how-to-guides/entanglement-forging", "how-to-guides/fermion-operator", "how-to-guides/index", "how-to-guides/lucj", "how-to-guides/qiskit-circuits", "how-to-guides/qiskit-sampler", "index", "install", "tutorials/double-factorized-trotter", "tutorials/index"], "envversion": {"nbsphinx": 4, "sphinx": 64, "sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.viewcode": 1}, "filenames": ["api/ffsim.rst", "api/ffsim.contract.rst", "api/ffsim.linalg.rst", "api/ffsim.optimize.rst", "api/ffsim.qiskit.rst", "api/ffsim.random.rst", "api/ffsim.testing.rst", "api/index.md", "explanations/double-factorized.ipynb", "explanations/hamiltonians.ipynb", "explanations/index.md", "explanations/lucj.ipynb", "explanations/orbital-rotation.ipynb", "explanations/qiskit-gate-decompositions.ipynb", "explanations/state-vectors-and-gates.ipynb", "how-to-guides/entanglement-forging.ipynb", "how-to-guides/fermion-operator.ipynb", "how-to-guides/index.md", "how-to-guides/lucj.ipynb", "how-to-guides/qiskit-circuits.ipynb", "how-to-guides/qiskit-sampler.ipynb", "index.md", "install.md", "tutorials/double-factorized-trotter.ipynb", "tutorials/index.md"], "indexentries": {"__init__() (ffsim.qiskit.diagcoulombevolutionjw method)": [[4, "ffsim.qiskit.DiagCoulombEvolutionJW.__init__", false]], "__init__() (ffsim.qiskit.diagcoulombevolutionspinlessjw method)": [[4, "ffsim.qiskit.DiagCoulombEvolutionSpinlessJW.__init__", false]], "__init__() (ffsim.qiskit.dropnegligible method)": [[4, "ffsim.qiskit.DropNegligible.__init__", false]], "__init__() (ffsim.qiskit.ffsimsampler method)": [[4, "ffsim.qiskit.FfsimSampler.__init__", false]], "__init__() (ffsim.qiskit.givensansatzopjw method)": [[4, "ffsim.qiskit.GivensAnsatzOpJW.__init__", false]], "__init__() (ffsim.qiskit.givensansatzopspinlessjw method)": [[4, "ffsim.qiskit.GivensAnsatzOpSpinlessJW.__init__", false]], "__init__() (ffsim.qiskit.numnumansatzopspinbalancedjw method)": [[4, "ffsim.qiskit.NumNumAnsatzOpSpinBalancedJW.__init__", false]], "__init__() (ffsim.qiskit.numopsumevolutionjw method)": [[4, "ffsim.qiskit.NumOpSumEvolutionJW.__init__", false]], "__init__() (ffsim.qiskit.numopsumevolutionspinlessjw method)": [[4, "ffsim.qiskit.NumOpSumEvolutionSpinlessJW.__init__", false]], "__init__() (ffsim.qiskit.orbitalrotationjw method)": [[4, "ffsim.qiskit.OrbitalRotationJW.__init__", false]], "__init__() (ffsim.qiskit.orbitalrotationspinlessjw method)": [[4, "ffsim.qiskit.OrbitalRotationSpinlessJW.__init__", false]], "__init__() (ffsim.qiskit.preparehartreefockjw method)": [[4, "ffsim.qiskit.PrepareHartreeFockJW.__init__", false]], "__init__() (ffsim.qiskit.preparehartreefockspinlessjw method)": [[4, "ffsim.qiskit.PrepareHartreeFockSpinlessJW.__init__", false]], "__init__() (ffsim.qiskit.prepareslaterdeterminantjw method)": [[4, "ffsim.qiskit.PrepareSlaterDeterminantJW.__init__", false]], "__init__() (ffsim.qiskit.prepareslaterdeterminantspinlessjw method)": [[4, "ffsim.qiskit.PrepareSlaterDeterminantSpinlessJW.__init__", false]], "__init__() (ffsim.qiskit.simulatetrotterdiagcoulombsplitopjw method)": [[4, "ffsim.qiskit.SimulateTrotterDiagCoulombSplitOpJW.__init__", false]], "__init__() (ffsim.qiskit.simulatetrotterdoublefactorizedjw method)": [[4, "ffsim.qiskit.SimulateTrotterDoubleFactorizedJW.__init__", false]], "__init__() (ffsim.qiskit.ucjopspinbalancedjw method)": [[4, "ffsim.qiskit.UCJOpSpinBalancedJW.__init__", false]], "__init__() (ffsim.qiskit.ucjopspinlessjw method)": [[4, "ffsim.qiskit.UCJOpSpinlessJW.__init__", false]], "__init__() (ffsim.qiskit.ucjopspinunbalancedjw method)": [[4, "ffsim.qiskit.UCJOpSpinUnbalancedJW.__init__", false]], "action (ffsim.fermionaction attribute)": [[0, "ffsim.FermionAction.action", false]], "active_space (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.active_space", false]], "addresses_to_strings() (in module ffsim)": [[0, "ffsim.addresses_to_strings", false]], "alpha (ffsim.spin attribute)": [[0, "ffsim.Spin.ALPHA", false]], "alpha_and_beta (ffsim.spin attribute)": [[0, "ffsim.Spin.ALPHA_AND_BETA", false]], "apply_diag_coulomb_evolution() (in module ffsim)": [[0, "ffsim.apply_diag_coulomb_evolution", false]], "apply_fsim_gate() (in module ffsim)": [[0, "ffsim.apply_fsim_gate", false]], "apply_fswap_gate() (in module ffsim)": [[0, "ffsim.apply_fswap_gate", false]], "apply_givens_rotation() (in module ffsim)": [[0, "ffsim.apply_givens_rotation", false]], "apply_hop_gate() (in module ffsim)": [[0, "ffsim.apply_hop_gate", false]], "apply_matrix_to_slices() (in module ffsim.linalg)": [[2, "ffsim.linalg.apply_matrix_to_slices", false]], "apply_num_interaction() (in module ffsim)": [[0, "ffsim.apply_num_interaction", false]], "apply_num_num_interaction() (in module ffsim)": [[0, "ffsim.apply_num_num_interaction", false]], "apply_num_op_prod_interaction() (in module ffsim)": [[0, "ffsim.apply_num_op_prod_interaction", false]], "apply_num_op_sum_evolution() (in module ffsim)": [[0, "ffsim.apply_num_op_sum_evolution", false]], "apply_on_site_interaction() (in module ffsim)": [[0, "ffsim.apply_on_site_interaction", false]], "apply_orbital_rotation() (in module ffsim)": [[0, "ffsim.apply_orbital_rotation", false]], "apply_tunneling_interaction() (in module ffsim)": [[0, "ffsim.apply_tunneling_interaction", false]], "apply_unitary() (in module ffsim)": [[0, "ffsim.apply_unitary", false]], "approx_eq() (in module ffsim)": [[0, "ffsim.approx_eq", false]], "assert_allclose_up_to_global_phase() (in module ffsim.testing)": [[6, "ffsim.testing.assert_allclose_up_to_global_phase", false]], "atom (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.atom", false]], "basis (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.basis", false]], "beta (ffsim.spin attribute)": [[0, "ffsim.Spin.BETA", false]], "bit_array (ffsim.bitstringtype attribute)": [[0, "ffsim.BitstringType.BIT_ARRAY", false]], "bitstringtype (class in ffsim)": [[0, "ffsim.BitstringType", false]], "c (ffsim.linalg.givensrotation attribute)": [[2, "ffsim.linalg.GivensRotation.c", false]], "ccsd_energy (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.ccsd_energy", false]], "ccsd_t1 (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.ccsd_t1", false]], "ccsd_t2 (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.ccsd_t2", false]], "cisd_energy (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.cisd_energy", false]], "cisd_vec (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.cisd_vec", false]], "coeffs (ffsim.productstatesum attribute)": [[0, "ffsim.ProductStateSum.coeffs", false]], "conserves_particle_number() (ffsim.fermionoperator method)": [[0, "ffsim.FermionOperator.conserves_particle_number", false]], "conserves_spin_z() (ffsim.fermionoperator method)": [[0, "ffsim.FermionOperator.conserves_spin_z", false]], "constant (ffsim.diagonalcoulombhamiltonian attribute)": [[0, "ffsim.DiagonalCoulombHamiltonian.constant", false]], "constant (ffsim.doublefactorizedhamiltonian attribute)": [[0, "ffsim.DoubleFactorizedHamiltonian.constant", false]], "constant (ffsim.molecularhamiltonian attribute)": [[0, "ffsim.MolecularHamiltonian.constant", false]], "constant (ffsim.singlefactorizedhamiltonian attribute)": [[0, "ffsim.SingleFactorizedHamiltonian.constant", false]], "contract_diag_coulomb() (in module ffsim.contract)": [[1, "ffsim.contract.contract_diag_coulomb", false]], "contract_num_op_sum() (in module ffsim.contract)": [[1, "ffsim.contract.contract_num_op_sum", false]], "contract_one_body() (in module ffsim.contract)": [[1, "ffsim.contract.contract_one_body", false]], "core_energy (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.core_energy", false]], "cre() (in module ffsim)": [[0, "ffsim.cre", false]], "cre_a() (in module ffsim)": [[0, "ffsim.cre_a", false]], "cre_b() (in module ffsim)": [[0, "ffsim.cre_b", false]], "des() (in module ffsim)": [[0, "ffsim.des", false]], "des_a() (in module ffsim)": [[0, "ffsim.des_a", false]], "des_b() (in module ffsim)": [[0, "ffsim.des_b", false]], "diag() (in module ffsim)": [[0, "ffsim.diag", false]], "diag_coulomb_linop() (in module ffsim.contract)": [[1, "ffsim.contract.diag_coulomb_linop", false]], "diag_coulomb_mats (ffsim.diagonalcoulombhamiltonian attribute)": [[0, "ffsim.DiagonalCoulombHamiltonian.diag_coulomb_mats", false]], "diag_coulomb_mats (ffsim.doublefactorizedhamiltonian attribute)": [[0, "ffsim.DoubleFactorizedHamiltonian.diag_coulomb_mats", false]], "diag_coulomb_mats (ffsim.ucjopspinbalanced attribute)": [[0, "ffsim.UCJOpSpinBalanced.diag_coulomb_mats", false]], "diag_coulomb_mats (ffsim.ucjopspinless attribute)": [[0, "ffsim.UCJOpSpinless.diag_coulomb_mats", false]], "diag_coulomb_mats (ffsim.ucjopspinunbalanced attribute)": [[0, "ffsim.UCJOpSpinUnbalanced.diag_coulomb_mats", false]], "diagcoulombevolutionjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.DiagCoulombEvolutionJW", false]], "diagcoulombevolutionspinlessjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.DiagCoulombEvolutionSpinlessJW", false]], "diagonalcoulombhamiltonian (class in ffsim)": [[0, "ffsim.DiagonalCoulombHamiltonian", false]], "dim() (in module ffsim)": [[0, "ffsim.dim", false]], "dims() (in module ffsim)": [[0, "ffsim.dims", false]], "dipole_integrals (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.dipole_integrals", false]], "double_factorized() (in module ffsim.linalg)": [[2, "ffsim.linalg.double_factorized", false]], "double_factorized_t2() (in module ffsim.linalg)": [[2, "ffsim.linalg.double_factorized_t2", false]], "double_factorized_t2_alpha_beta() (in module ffsim.linalg)": [[2, "ffsim.linalg.double_factorized_t2_alpha_beta", false]], "doublefactorizedhamiltonian (class in ffsim)": [[0, "ffsim.DoubleFactorizedHamiltonian", false]], "dropnegligible (class in ffsim.qiskit)": [[4, "ffsim.qiskit.DropNegligible", false]], "expectation_one_body_power() (in module ffsim)": [[0, "ffsim.expectation_one_body_power", false]], "expectation_one_body_product() (in module ffsim)": [[0, "ffsim.expectation_one_body_product", false]], "expectation_product_state() (ffsim.singlefactorizedhamiltonian method)": [[0, "ffsim.SingleFactorizedHamiltonian.expectation_product_state", false]], "expm_multiply_taylor() (in module ffsim.linalg)": [[2, "ffsim.linalg.expm_multiply_taylor", false]], "fci_energy (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.fci_energy", false]], "fci_vec (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.fci_vec", false]], "fermi_hubbard_1d() (in module ffsim)": [[0, "ffsim.fermi_hubbard_1d", false]], "fermi_hubbard_2d() (in module ffsim)": [[0, "ffsim.fermi_hubbard_2d", false]], "fermion_operator() (in module ffsim)": [[0, "ffsim.fermion_operator", false]], "fermionaction (class in ffsim)": [[0, "ffsim.FermionAction", false]], "fermionoperator (class in ffsim)": [[0, "ffsim.FermionOperator", false]], "ffsim": [[0, "module-ffsim", false]], "ffsim.contract": [[1, "module-ffsim.contract", false]], "ffsim.linalg": [[2, "module-ffsim.linalg", false]], "ffsim.optimize": [[3, "module-ffsim.optimize", false]], "ffsim.qiskit": [[4, "module-ffsim.qiskit", false]], "ffsim.random": [[5, "module-ffsim.random", false]], "ffsim.testing": [[6, "module-ffsim.testing", false]], "ffsim_vec_to_qiskit_vec() (in module ffsim.qiskit)": [[4, "ffsim.qiskit.ffsim_vec_to_qiskit_vec", false]], "ffsimsampler (class in ffsim.qiskit)": [[4, "ffsim.qiskit.FfsimSampler", false]], "final_orbital_rotation (ffsim.hopgateansatzoperator attribute)": [[0, "ffsim.HopGateAnsatzOperator.final_orbital_rotation", false]], "final_orbital_rotation (ffsim.ucjopspinbalanced attribute)": [[0, "ffsim.UCJOpSpinBalanced.final_orbital_rotation", false]], "final_orbital_rotation (ffsim.ucjopspinless attribute)": [[0, "ffsim.UCJOpSpinless.final_orbital_rotation", false]], "final_orbital_rotation (ffsim.ucjopspinunbalanced attribute)": [[0, "ffsim.UCJOpSpinUnbalanced.final_orbital_rotation", false]], "final_state_vector() (in module ffsim.qiskit)": [[4, "ffsim.qiskit.final_state_vector", false]], "from_diag_coulomb_mats() (ffsim.numnumansatzopspinbalanced static method)": [[0, "ffsim.NumNumAnsatzOpSpinBalanced.from_diag_coulomb_mats", false]], "from_fcidump() (ffsim.moleculardata static method)": [[0, "ffsim.MolecularData.from_fcidump", false]], "from_fcidump() (ffsim.molecularhamiltonian static method)": [[0, "ffsim.MolecularHamiltonian.from_fcidump", false]], "from_fermion_operator() (ffsim.diagonalcoulombhamiltonian static method)": [[0, "ffsim.DiagonalCoulombHamiltonian.from_fermion_operator", false]], "from_json() (ffsim.moleculardata static method)": [[0, "ffsim.MolecularData.from_json", false]], "from_mole() (ffsim.moleculardata static method)": [[0, "ffsim.MolecularData.from_mole", false]], "from_molecular_hamiltonian() (ffsim.doublefactorizedhamiltonian static method)": [[0, "ffsim.DoubleFactorizedHamiltonian.from_molecular_hamiltonian", false]], "from_molecular_hamiltonian() (ffsim.singlefactorizedhamiltonian static method)": [[0, "ffsim.SingleFactorizedHamiltonian.from_molecular_hamiltonian", false]], "from_orbital_rotation() (ffsim.givensansatzop static method)": [[0, "ffsim.GivensAnsatzOp.from_orbital_rotation", false]], "from_parameters() (ffsim.givensansatzop static method)": [[0, "ffsim.GivensAnsatzOp.from_parameters", false]], "from_parameters() (ffsim.hopgateansatzoperator static method)": [[0, "ffsim.HopGateAnsatzOperator.from_parameters", false]], "from_parameters() (ffsim.numnumansatzopspinbalanced static method)": [[0, "ffsim.NumNumAnsatzOpSpinBalanced.from_parameters", false]], "from_parameters() (ffsim.uccsdoprestrictedreal static method)": [[0, "ffsim.UCCSDOpRestrictedReal.from_parameters", false]], "from_parameters() (ffsim.ucjopspinbalanced static method)": [[0, "ffsim.UCJOpSpinBalanced.from_parameters", false]], "from_parameters() (ffsim.ucjopspinless static method)": [[0, "ffsim.UCJOpSpinless.from_parameters", false]], "from_parameters() (ffsim.ucjopspinunbalanced static method)": [[0, "ffsim.UCJOpSpinUnbalanced.from_parameters", false]], "from_scf() (ffsim.moleculardata static method)": [[0, "ffsim.MolecularData.from_scf", false]], "from_t_amplitudes() (ffsim.ucjopspinbalanced static method)": [[0, "ffsim.UCJOpSpinBalanced.from_t_amplitudes", false]], "from_t_amplitudes() (ffsim.ucjopspinless static method)": [[0, "ffsim.UCJOpSpinless.from_t_amplitudes", false]], "from_t_amplitudes() (ffsim.ucjopspinunbalanced static method)": [[0, "ffsim.UCJOpSpinUnbalanced.from_t_amplitudes", false]], "generate_norb_nelec() (in module ffsim.testing)": [[6, "ffsim.testing.generate_norb_nelec", false]], "generate_norb_nelec_spin() (in module ffsim.testing)": [[6, "ffsim.testing.generate_norb_nelec_spin", false]], "generate_norb_nocc() (in module ffsim.testing)": [[6, "ffsim.testing.generate_norb_nocc", false]], "generate_norb_spin() (in module ffsim.testing)": [[6, "ffsim.testing.generate_norb_spin", false]], "givens_decomposition() (in module ffsim.linalg)": [[2, "ffsim.linalg.givens_decomposition", false]], "givensansatzop (class in ffsim)": [[0, "ffsim.GivensAnsatzOp", false]], "givensansatzopjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.GivensAnsatzOpJW", false]], "givensansatzopspinlessjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.GivensAnsatzOpSpinlessJW", false]], "givensrotation (class in ffsim.linalg)": [[2, "ffsim.linalg.GivensRotation", false]], "hamiltonian (ffsim.moleculardata property)": [[0, "ffsim.MolecularData.hamiltonian", false]], "hartree_fock_state() (in module ffsim)": [[0, "ffsim.hartree_fock_state", false]], "hf_energy (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.hf_energy", false]], "hf_mo_coeff (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.hf_mo_coeff", false]], "hf_mo_occ (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.hf_mo_occ", false]], "hopgateansatzoperator (class in ffsim)": [[0, "ffsim.HopGateAnsatzOperator", false]], "i (ffsim.linalg.givensrotation attribute)": [[2, "ffsim.linalg.GivensRotation.i", false]], "indices_to_strings() (in module ffsim)": [[0, "ffsim.indices_to_strings", false]], "init_cache() (in module ffsim)": [[0, "ffsim.init_cache", false]], "int (ffsim.bitstringtype attribute)": [[0, "ffsim.BitstringType.INT", false]], "interaction_pairs (ffsim.givensansatzop attribute)": [[0, "ffsim.GivensAnsatzOp.interaction_pairs", false]], "interaction_pairs (ffsim.hopgateansatzoperator attribute)": [[0, "ffsim.HopGateAnsatzOperator.interaction_pairs", false]], "interaction_pairs (ffsim.numnumansatzopspinbalanced attribute)": [[0, "ffsim.NumNumAnsatzOpSpinBalanced.interaction_pairs", false]], "inverse() (ffsim.qiskit.diagcoulombevolutionjw method)": [[4, "ffsim.qiskit.DiagCoulombEvolutionJW.inverse", false]], "inverse() (ffsim.qiskit.diagcoulombevolutionspinlessjw method)": [[4, "ffsim.qiskit.DiagCoulombEvolutionSpinlessJW.inverse", false]], "inverse() (ffsim.qiskit.numopsumevolutionjw method)": [[4, "ffsim.qiskit.NumOpSumEvolutionJW.inverse", false]], "inverse() (ffsim.qiskit.numopsumevolutionspinlessjw method)": [[4, "ffsim.qiskit.NumOpSumEvolutionSpinlessJW.inverse", false]], "inverse() (ffsim.qiskit.orbitalrotationjw method)": [[4, "ffsim.qiskit.OrbitalRotationJW.inverse", false]], "inverse() (ffsim.qiskit.orbitalrotationspinlessjw method)": [[4, "ffsim.qiskit.OrbitalRotationSpinlessJW.inverse", false]], "is_antihermitian() (in module ffsim.linalg)": [[2, "ffsim.linalg.is_antihermitian", false]], "is_hermitian() (in module ffsim.linalg)": [[2, "ffsim.linalg.is_hermitian", false]], "is_orthogonal() (in module ffsim.linalg)": [[2, "ffsim.linalg.is_orthogonal", false]], "is_real_symmetric() (in module ffsim.linalg)": [[2, "ffsim.linalg.is_real_symmetric", false]], "is_special_orthogonal() (in module ffsim.linalg)": [[2, "ffsim.linalg.is_special_orthogonal", false]], "is_unitary() (in module ffsim.linalg)": [[2, "ffsim.linalg.is_unitary", false]], "j (ffsim.linalg.givensrotation attribute)": [[2, "ffsim.linalg.GivensRotation.j", false]], "jordan_wigner() (in module ffsim.qiskit)": [[4, "ffsim.qiskit.jordan_wigner", false]], "linear_operator() (in module ffsim)": [[0, "ffsim.linear_operator", false]], "lup() (in module ffsim.linalg)": [[2, "ffsim.linalg.lup", false]], "many_body_order() (ffsim.fermionoperator method)": [[0, "ffsim.FermionOperator.many_body_order", false]], "match_global_phase() (in module ffsim.linalg)": [[2, "ffsim.linalg.match_global_phase", false]], "mergeorbitalrotations (class in ffsim.qiskit)": [[4, "ffsim.qiskit.MergeOrbitalRotations", false]], "minimize_linear_method() (in module ffsim.optimize)": [[3, "ffsim.optimize.minimize_linear_method", false]], "mo_coeff (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.mo_coeff", false]], "mo_occ (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.mo_occ", false]], "modified_cholesky() (in module ffsim.linalg)": [[2, "ffsim.linalg.modified_cholesky", false]], "module": [[0, "module-ffsim", false], [1, "module-ffsim.contract", false], [2, "module-ffsim.linalg", false], [3, "module-ffsim.optimize", false], [4, "module-ffsim.qiskit", false], [5, "module-ffsim.random", false], [6, "module-ffsim.testing", false]], "mole (ffsim.moleculardata property)": [[0, "ffsim.MolecularData.mole", false]], "moleculardata (class in ffsim)": [[0, "ffsim.MolecularData", false]], "molecularhamiltonian (class in ffsim)": [[0, "ffsim.MolecularHamiltonian", false]], "mp2_energy (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.mp2_energy", false]], "mp2_t2 (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.mp2_t2", false]], "multireference_state() (in module ffsim)": [[0, "ffsim.multireference_state", false]], "multireference_state_prod() (in module ffsim)": [[0, "ffsim.multireference_state_prod", false]], "n_params() (ffsim.givensansatzop static method)": [[0, "ffsim.GivensAnsatzOp.n_params", false]], "n_params() (ffsim.numnumansatzopspinbalanced static method)": [[0, "ffsim.NumNumAnsatzOpSpinBalanced.n_params", false]], "n_params() (ffsim.uccsdoprestrictedreal static method)": [[0, "ffsim.UCCSDOpRestrictedReal.n_params", false]], "n_params() (ffsim.ucjopspinbalanced static method)": [[0, "ffsim.UCJOpSpinBalanced.n_params", false]], "n_params() (ffsim.ucjopspinless static method)": [[0, "ffsim.UCJOpSpinless.n_params", false]], "n_params() (ffsim.ucjopspinunbalanced static method)": [[0, "ffsim.UCJOpSpinUnbalanced.n_params", false]], "n_reps (ffsim.ucjopspinbalanced property)": [[0, "ffsim.UCJOpSpinBalanced.n_reps", false]], "n_reps (ffsim.ucjopspinless property)": [[0, "ffsim.UCJOpSpinless.n_reps", false]], "n_reps (ffsim.ucjopspinunbalanced property)": [[0, "ffsim.UCJOpSpinUnbalanced.n_reps", false]], "nelec (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.nelec", false]], "nelec (ffsim.statevector attribute)": [[0, "ffsim.StateVector.nelec", false]], "norb (ffsim.diagonalcoulombhamiltonian property)": [[0, "ffsim.DiagonalCoulombHamiltonian.norb", false]], "norb (ffsim.doublefactorizedhamiltonian property)": [[0, "ffsim.DoubleFactorizedHamiltonian.norb", false]], "norb (ffsim.givensansatzop attribute)": [[0, "ffsim.GivensAnsatzOp.norb", false]], "norb (ffsim.hopgateansatzoperator attribute)": [[0, "ffsim.HopGateAnsatzOperator.norb", false]], "norb (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.norb", false]], "norb (ffsim.molecularhamiltonian property)": [[0, "ffsim.MolecularHamiltonian.norb", false]], "norb (ffsim.numnumansatzopspinbalanced attribute)": [[0, "ffsim.NumNumAnsatzOpSpinBalanced.norb", false]], "norb (ffsim.singlefactorizedhamiltonian property)": [[0, "ffsim.SingleFactorizedHamiltonian.norb", false]], "norb (ffsim.statevector attribute)": [[0, "ffsim.StateVector.norb", false]], "norb (ffsim.uccsdoprestrictedreal property)": [[0, "ffsim.UCCSDOpRestrictedReal.norb", false]], "norb (ffsim.ucjopspinbalanced property)": [[0, "ffsim.UCJOpSpinBalanced.norb", false]], "norb (ffsim.ucjopspinless property)": [[0, "ffsim.UCJOpSpinless.norb", false]], "norb (ffsim.ucjopspinunbalanced property)": [[0, "ffsim.UCJOpSpinUnbalanced.norb", false]], "normal_ordered() (ffsim.fermionoperator method)": [[0, "ffsim.FermionOperator.normal_ordered", false]], "num_op_sum_linop() (in module ffsim.contract)": [[1, "ffsim.contract.num_op_sum_linop", false]], "number_operator() (in module ffsim)": [[0, "ffsim.number_operator", false]], "numnumansatzopspinbalanced (class in ffsim)": [[0, "ffsim.NumNumAnsatzOpSpinBalanced", false]], "numnumansatzopspinbalancedjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.NumNumAnsatzOpSpinBalancedJW", false]], "numopsumevolutionjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.NumOpSumEvolutionJW", false]], "numopsumevolutionspinlessjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.NumOpSumEvolutionSpinlessJW", false]], "one_body_integrals (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.one_body_integrals", false]], "one_body_linop() (in module ffsim.contract)": [[1, "ffsim.contract.one_body_linop", false]], "one_body_squares (ffsim.singlefactorizedhamiltonian attribute)": [[0, "ffsim.SingleFactorizedHamiltonian.one_body_squares", false]], "one_body_tensor (ffsim.diagonalcoulombhamiltonian attribute)": [[0, "ffsim.DiagonalCoulombHamiltonian.one_body_tensor", false]], "one_body_tensor (ffsim.doublefactorizedhamiltonian attribute)": [[0, "ffsim.DoubleFactorizedHamiltonian.one_body_tensor", false]], "one_body_tensor (ffsim.molecularhamiltonian attribute)": [[0, "ffsim.MolecularHamiltonian.one_body_tensor", false]], "one_body_tensor (ffsim.singlefactorizedhamiltonian attribute)": [[0, "ffsim.SingleFactorizedHamiltonian.one_body_tensor", false]], "one_hot() (in module ffsim)": [[0, "ffsim.one_hot", false]], "one_hot() (in module ffsim.linalg)": [[2, "ffsim.linalg.one_hot", false]], "orb (ffsim.fermionaction attribute)": [[0, "ffsim.FermionAction.orb", false]], "orbital_rotations (ffsim.doublefactorizedhamiltonian attribute)": [[0, "ffsim.DoubleFactorizedHamiltonian.orbital_rotations", false]], "orbital_rotations (ffsim.ucjopspinbalanced attribute)": [[0, "ffsim.UCJOpSpinBalanced.orbital_rotations", false]], "orbital_rotations (ffsim.ucjopspinless attribute)": [[0, "ffsim.UCJOpSpinless.orbital_rotations", false]], "orbital_rotations (ffsim.ucjopspinunbalanced attribute)": [[0, "ffsim.UCJOpSpinUnbalanced.orbital_rotations", false]], "orbital_symmetries (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.orbital_symmetries", false]], "orbitalrotationjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.OrbitalRotationJW", false]], "orbitalrotationspinlessjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.OrbitalRotationSpinlessJW", false]], "phase_angles (ffsim.givensansatzop attribute)": [[0, "ffsim.GivensAnsatzOp.phase_angles", false]], "phis (ffsim.givensansatzop attribute)": [[0, "ffsim.GivensAnsatzOp.phis", false]], "pre_init (in module ffsim.qiskit)": [[4, "ffsim.qiskit.PRE_INIT", false]], "pre_init_passes() (in module ffsim.qiskit)": [[4, "ffsim.qiskit.pre_init_passes", false]], "preparehartreefockjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.PrepareHartreeFockJW", false]], "preparehartreefockspinlessjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.PrepareHartreeFockSpinlessJW", false]], "prepareslaterdeterminantjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.PrepareSlaterDeterminantJW", false]], "prepareslaterdeterminantspinlessjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.PrepareSlaterDeterminantSpinlessJW", false]], "productstatesum (class in ffsim)": [[0, "ffsim.ProductStateSum", false]], "qiskit_vec_to_ffsim_vec() (in module ffsim.qiskit)": [[4, "ffsim.qiskit.qiskit_vec_to_ffsim_vec", false]], "random_antihermitian() (in module ffsim.random)": [[5, "ffsim.random.random_antihermitian", false]], "random_diagonal_coulomb_hamiltonian() (in module ffsim.random)": [[5, "ffsim.random.random_diagonal_coulomb_hamiltonian", false]], "random_double_factorized_hamiltonian() (in module ffsim.random)": [[5, "ffsim.random.random_double_factorized_hamiltonian", false]], "random_fermion_hamiltonian() (in module ffsim.random)": [[5, "ffsim.random.random_fermion_hamiltonian", false]], "random_fermion_operator() (in module ffsim.random)": [[5, "ffsim.random.random_fermion_operator", false]], "random_hermitian() (in module ffsim.random)": [[5, "ffsim.random.random_hermitian", false]], "random_molecular_hamiltonian() (in module ffsim.random)": [[5, "ffsim.random.random_molecular_hamiltonian", false]], "random_nelec() (in module ffsim.testing)": [[6, "ffsim.testing.random_nelec", false]], "random_occupied_orbitals() (in module ffsim.testing)": [[6, "ffsim.testing.random_occupied_orbitals", false]], "random_orthogonal() (in module ffsim.random)": [[5, "ffsim.random.random_orthogonal", false]], "random_real_symmetric_matrix() (in module ffsim.random)": [[5, "ffsim.random.random_real_symmetric_matrix", false]], "random_special_orthogonal() (in module ffsim.random)": [[5, "ffsim.random.random_special_orthogonal", false]], "random_state_vector() (in module ffsim.random)": [[5, "ffsim.random.random_state_vector", false]], "random_statevector() (in module ffsim.random)": [[5, "ffsim.random.random_statevector", false]], "random_t2_amplitudes() (in module ffsim.random)": [[5, "ffsim.random.random_t2_amplitudes", false]], "random_two_body_tensor() (in module ffsim.random)": [[5, "ffsim.random.random_two_body_tensor", false]], "random_uccsd_restricted() (in module ffsim.random)": [[5, "ffsim.random.random_uccsd_restricted", false]], "random_ucj_op_spin_balanced() (in module ffsim.random)": [[5, "ffsim.random.random_ucj_op_spin_balanced", false]], "random_ucj_op_spin_unbalanced() (in module ffsim.random)": [[5, "ffsim.random.random_ucj_op_spin_unbalanced", false]], "random_ucj_op_spinless() (in module ffsim.random)": [[5, "ffsim.random.random_ucj_op_spinless", false]], "random_unitary() (in module ffsim.random)": [[5, "ffsim.random.random_unitary", false]], "rdm() (in module ffsim)": [[0, "ffsim.rdm", false]], "rdms() (in module ffsim)": [[0, "ffsim.rdms", false]], "reduced_matrix() (in module ffsim.linalg)": [[2, "ffsim.linalg.reduced_matrix", false]], "reduced_matrix_product_states() (ffsim.singlefactorizedhamiltonian method)": [[0, "ffsim.SingleFactorizedHamiltonian.reduced_matrix_product_states", false]], "rotated() (ffsim.molecularhamiltonian method)": [[0, "ffsim.MolecularHamiltonian.rotated", false]], "run() (ffsim.qiskit.dropnegligible method)": [[4, "ffsim.qiskit.DropNegligible.run", false]], "run() (ffsim.qiskit.ffsimsampler method)": [[4, "ffsim.qiskit.FfsimSampler.run", false]], "run() (ffsim.qiskit.mergeorbitalrotations method)": [[4, "ffsim.qiskit.MergeOrbitalRotations.run", false]], "run_ccsd() (ffsim.moleculardata method)": [[0, "ffsim.MolecularData.run_ccsd", false]], "run_cisd() (ffsim.moleculardata method)": [[0, "ffsim.MolecularData.run_cisd", false]], "run_fci() (ffsim.moleculardata method)": [[0, "ffsim.MolecularData.run_fci", false]], "run_mp2() (ffsim.moleculardata method)": [[0, "ffsim.MolecularData.run_mp2", false]], "run_sci() (ffsim.moleculardata method)": [[0, "ffsim.MolecularData.run_sci", false]], "s (ffsim.linalg.givensrotation attribute)": [[2, "ffsim.linalg.GivensRotation.s", false]], "sample_slater_determinant() (in module ffsim)": [[0, "ffsim.sample_slater_determinant", false]], "sample_state_vector() (in module ffsim)": [[0, "ffsim.sample_state_vector", false]], "scf (ffsim.moleculardata property)": [[0, "ffsim.MolecularData.scf", false]], "sci_energy (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.sci_energy", false]], "sci_vec (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.sci_vec", false]], "simulate_qdrift_double_factorized() (in module ffsim)": [[0, "ffsim.simulate_qdrift_double_factorized", false]], "simulate_trotter_diag_coulomb_split_op() (in module ffsim)": [[0, "ffsim.simulate_trotter_diag_coulomb_split_op", false]], "simulate_trotter_double_factorized() (in module ffsim)": [[0, "ffsim.simulate_trotter_double_factorized", false]], "simulatetrotterdiagcoulombsplitopjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.SimulateTrotterDiagCoulombSplitOpJW", false]], "simulatetrotterdoublefactorizedjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.SimulateTrotterDoubleFactorizedJW", false]], "singlefactorizedhamiltonian (class in ffsim)": [[0, "ffsim.SingleFactorizedHamiltonian", false]], "slater_determinant() (in module ffsim)": [[0, "ffsim.slater_determinant", false]], "slater_determinant_amplitudes() (in module ffsim)": [[0, "ffsim.slater_determinant_amplitudes", false]], "slater_determinant_rdm() (in module ffsim)": [[0, "ffsim.slater_determinant_rdm", false]], "slater_determinant_rdms() (in module ffsim)": [[0, "ffsim.slater_determinant_rdms", false]], "spin (class in ffsim)": [[0, "ffsim.Spin", false]], "spin (ffsim.fermionaction attribute)": [[0, "ffsim.FermionAction.spin", false]], "spin (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.spin", false]], "spin_square() (in module ffsim)": [[0, "ffsim.spin_square", false]], "states (ffsim.productstatesum attribute)": [[0, "ffsim.ProductStateSum.states", false]], "statevector (class in ffsim)": [[0, "ffsim.StateVector", false]], "string (ffsim.bitstringtype attribute)": [[0, "ffsim.BitstringType.STRING", false]], "strings_to_addresses() (in module ffsim)": [[0, "ffsim.strings_to_addresses", false]], "strings_to_indices() (in module ffsim)": [[0, "ffsim.strings_to_indices", false]], "supportsapplyunitary (class in ffsim)": [[0, "ffsim.SupportsApplyUnitary", false]], "supportsapproximateequality (class in ffsim)": [[0, "ffsim.SupportsApproximateEquality", false]], "supportsdiagonal (class in ffsim)": [[0, "ffsim.SupportsDiagonal", false]], "supportsfermionoperator (class in ffsim)": [[0, "ffsim.SupportsFermionOperator", false]], "supportslinearoperator (class in ffsim)": [[0, "ffsim.SupportsLinearOperator", false]], "supportstrace (class in ffsim)": [[0, "ffsim.SupportsTrace", false]], "symmetry (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.symmetry", false]], "thetas (ffsim.givensansatzop attribute)": [[0, "ffsim.GivensAnsatzOp.thetas", false]], "thetas (ffsim.hopgateansatzoperator attribute)": [[0, "ffsim.HopGateAnsatzOperator.thetas", false]], "thetas (ffsim.numnumansatzopspinbalanced attribute)": [[0, "ffsim.NumNumAnsatzOpSpinBalanced.thetas", false]], "to_diag_coulomb_mats() (ffsim.numnumansatzopspinbalanced method)": [[0, "ffsim.NumNumAnsatzOpSpinBalanced.to_diag_coulomb_mats", false]], "to_fcidump() (ffsim.moleculardata method)": [[0, "ffsim.MolecularData.to_fcidump", false]], "to_json() (ffsim.moleculardata method)": [[0, "ffsim.MolecularData.to_json", false]], "to_molecular_hamiltonian() (ffsim.doublefactorizedhamiltonian method)": [[0, "ffsim.DoubleFactorizedHamiltonian.to_molecular_hamiltonian", false]], "to_number_representation() (ffsim.doublefactorizedhamiltonian method)": [[0, "ffsim.DoubleFactorizedHamiltonian.to_number_representation", false]], "to_orbital_rotation() (ffsim.givensansatzop method)": [[0, "ffsim.GivensAnsatzOp.to_orbital_rotation", false]], "to_parameters() (ffsim.givensansatzop method)": [[0, "ffsim.GivensAnsatzOp.to_parameters", false]], "to_parameters() (ffsim.hopgateansatzoperator method)": [[0, "ffsim.HopGateAnsatzOperator.to_parameters", false]], "to_parameters() (ffsim.numnumansatzopspinbalanced method)": [[0, "ffsim.NumNumAnsatzOpSpinBalanced.to_parameters", false]], "to_parameters() (ffsim.uccsdoprestrictedreal method)": [[0, "ffsim.UCCSDOpRestrictedReal.to_parameters", false]], "to_parameters() (ffsim.ucjopspinbalanced method)": [[0, "ffsim.UCJOpSpinBalanced.to_parameters", false]], "to_parameters() (ffsim.ucjopspinless method)": [[0, "ffsim.UCJOpSpinless.to_parameters", false]], "to_parameters() (ffsim.ucjopspinunbalanced method)": [[0, "ffsim.UCJOpSpinUnbalanced.to_parameters", false]], "to_z_representation() (ffsim.doublefactorizedhamiltonian method)": [[0, "ffsim.DoubleFactorizedHamiltonian.to_z_representation", false]], "trace() (in module ffsim)": [[0, "ffsim.trace", false]], "two_body_integrals (ffsim.moleculardata attribute)": [[0, "ffsim.MolecularData.two_body_integrals", false]], "two_body_tensor (ffsim.molecularhamiltonian attribute)": [[0, "ffsim.MolecularHamiltonian.two_body_tensor", false]], "uccsdoprestrictedreal (class in ffsim)": [[0, "ffsim.UCCSDOpRestrictedReal", false]], "ucjopspinbalanced (class in ffsim)": [[0, "ffsim.UCJOpSpinBalanced", false]], "ucjopspinbalancedjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.UCJOpSpinBalancedJW", false]], "ucjopspinless (class in ffsim)": [[0, "ffsim.UCJOpSpinless", false]], "ucjopspinlessjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.UCJOpSpinlessJW", false]], "ucjopspinunbalanced (class in ffsim)": [[0, "ffsim.UCJOpSpinUnbalanced", false]], "ucjopspinunbalancedjw (class in ffsim.qiskit)": [[4, "ffsim.qiskit.UCJOpSpinUnbalancedJW", false]], "vec (ffsim.statevector attribute)": [[0, "ffsim.StateVector.vec", false]], "z_representation (ffsim.doublefactorizedhamiltonian attribute)": [[0, "ffsim.DoubleFactorizedHamiltonian.z_representation", false]]}, "objects": {"": [[0, 0, 0, "-", "ffsim"]], "ffsim": [[0, 1, 1, "", "BitstringType"], [0, 1, 1, "", "DiagonalCoulombHamiltonian"], [0, 1, 1, "", "DoubleFactorizedHamiltonian"], [0, 1, 1, "", "FermionAction"], [0, 1, 1, "", "FermionOperator"], [0, 1, 1, "", "GivensAnsatzOp"], [0, 1, 1, "", "HopGateAnsatzOperator"], [0, 1, 1, "", "MolecularData"], [0, 1, 1, "", "MolecularHamiltonian"], [0, 1, 1, "", "NumNumAnsatzOpSpinBalanced"], [0, 1, 1, "", "ProductStateSum"], [0, 1, 1, "", "SingleFactorizedHamiltonian"], [0, 1, 1, "", "Spin"], [0, 1, 1, "", "StateVector"], [0, 1, 1, "", "SupportsApplyUnitary"], [0, 1, 1, "", "SupportsApproximateEquality"], [0, 1, 1, "", "SupportsDiagonal"], [0, 1, 1, "", "SupportsFermionOperator"], [0, 1, 1, "", "SupportsLinearOperator"], [0, 1, 1, "", "SupportsTrace"], [0, 1, 1, "", "UCCSDOpRestrictedReal"], [0, 1, 1, "", "UCJOpSpinBalanced"], [0, 1, 1, "", "UCJOpSpinUnbalanced"], [0, 1, 1, "", "UCJOpSpinless"], [0, 5, 1, "", "addresses_to_strings"], [0, 5, 1, "", "apply_diag_coulomb_evolution"], [0, 5, 1, "", "apply_fsim_gate"], [0, 5, 1, "", "apply_fswap_gate"], [0, 5, 1, "", "apply_givens_rotation"], [0, 5, 1, "", "apply_hop_gate"], [0, 5, 1, "", "apply_num_interaction"], [0, 5, 1, "", "apply_num_num_interaction"], [0, 5, 1, "", "apply_num_op_prod_interaction"], [0, 5, 1, "", "apply_num_op_sum_evolution"], [0, 5, 1, "", "apply_on_site_interaction"], [0, 5, 1, "", "apply_orbital_rotation"], [0, 5, 1, "", "apply_tunneling_interaction"], [0, 5, 1, "", "apply_unitary"], [0, 5, 1, "", "approx_eq"], [1, 0, 0, "-", "contract"], [0, 5, 1, "", "cre"], [0, 5, 1, "", "cre_a"], [0, 5, 1, "", "cre_b"], [0, 5, 1, "", "des"], [0, 5, 1, "", "des_a"], [0, 5, 1, "", "des_b"], [0, 5, 1, "", "diag"], [0, 5, 1, "", "dim"], [0, 5, 1, "", "dims"], [0, 5, 1, "", "expectation_one_body_power"], [0, 5, 1, "", "expectation_one_body_product"], [0, 5, 1, "", "fermi_hubbard_1d"], [0, 5, 1, "", "fermi_hubbard_2d"], [0, 5, 1, "", "fermion_operator"], [0, 5, 1, "", "hartree_fock_state"], [0, 5, 1, "", "indices_to_strings"], [0, 5, 1, "", "init_cache"], [2, 0, 0, "-", "linalg"], [0, 5, 1, "", "linear_operator"], [0, 5, 1, "", "multireference_state"], [0, 5, 1, "", "multireference_state_prod"], [0, 5, 1, "", "number_operator"], [0, 5, 1, "", "one_hot"], [3, 0, 0, "-", "optimize"], [4, 0, 0, "-", "qiskit"], [5, 0, 0, "-", "random"], [0, 5, 1, "", "rdm"], [0, 5, 1, "", "rdms"], [0, 5, 1, "", "sample_slater_determinant"], [0, 5, 1, "", "sample_state_vector"], [0, 5, 1, "", "simulate_qdrift_double_factorized"], [0, 5, 1, "", "simulate_trotter_diag_coulomb_split_op"], [0, 5, 1, "", "simulate_trotter_double_factorized"], [0, 5, 1, "", "slater_determinant"], [0, 5, 1, "", "slater_determinant_amplitudes"], [0, 5, 1, "", "slater_determinant_rdm"], [0, 5, 1, "", "slater_determinant_rdms"], [0, 5, 1, "", "spin_square"], [0, 5, 1, "", "strings_to_addresses"], [0, 5, 1, "", "strings_to_indices"], [6, 0, 0, "-", "testing"], [0, 5, 1, "", "trace"]], "ffsim.BitstringType": [[0, 2, 1, "", "BIT_ARRAY"], [0, 2, 1, "", "INT"], [0, 2, 1, "", "STRING"]], "ffsim.DiagonalCoulombHamiltonian": [[0, 2, 1, "", "constant"], [0, 2, 1, "", "diag_coulomb_mats"], [0, 3, 1, "", "from_fermion_operator"], [0, 4, 1, "", "norb"], [0, 2, 1, "", "one_body_tensor"]], "ffsim.DoubleFactorizedHamiltonian": [[0, 2, 1, "", "constant"], [0, 2, 1, "", "diag_coulomb_mats"], [0, 3, 1, "", "from_molecular_hamiltonian"], [0, 4, 1, "", "norb"], [0, 2, 1, "", "one_body_tensor"], [0, 2, 1, "", "orbital_rotations"], [0, 3, 1, "", "to_molecular_hamiltonian"], [0, 3, 1, "", "to_number_representation"], [0, 3, 1, "", "to_z_representation"], [0, 2, 1, "", "z_representation"]], "ffsim.FermionAction": [[0, 2, 1, "", "action"], [0, 2, 1, "", "orb"], [0, 2, 1, "", "spin"]], "ffsim.FermionOperator": [[0, 3, 1, "", "conserves_particle_number"], [0, 3, 1, "", "conserves_spin_z"], [0, 3, 1, "", "many_body_order"], [0, 3, 1, "", "normal_ordered"]], "ffsim.GivensAnsatzOp": [[0, 3, 1, "", "from_orbital_rotation"], [0, 3, 1, "", "from_parameters"], [0, 2, 1, "", "interaction_pairs"], [0, 3, 1, "", "n_params"], [0, 2, 1, "", "norb"], [0, 2, 1, "", "phase_angles"], [0, 2, 1, "", "phis"], [0, 2, 1, "", "thetas"], [0, 3, 1, "", "to_orbital_rotation"], [0, 3, 1, "", "to_parameters"]], "ffsim.HopGateAnsatzOperator": [[0, 2, 1, "", "final_orbital_rotation"], [0, 3, 1, "", "from_parameters"], [0, 2, 1, "", "interaction_pairs"], [0, 2, 1, "", "norb"], [0, 2, 1, "", "thetas"], [0, 3, 1, "", "to_parameters"]], "ffsim.MolecularData": [[0, 2, 1, "", "active_space"], [0, 2, 1, "", "atom"], [0, 2, 1, "", "basis"], [0, 2, 1, "", "ccsd_energy"], [0, 2, 1, "", "ccsd_t1"], [0, 2, 1, "", "ccsd_t2"], [0, 2, 1, "", "cisd_energy"], [0, 2, 1, "", "cisd_vec"], [0, 2, 1, "", "core_energy"], [0, 2, 1, "", "dipole_integrals"], [0, 2, 1, "", "fci_energy"], [0, 2, 1, "", "fci_vec"], [0, 3, 1, "", "from_fcidump"], [0, 3, 1, "", "from_json"], [0, 3, 1, "", "from_mole"], [0, 3, 1, "", "from_scf"], [0, 4, 1, "", "hamiltonian"], [0, 2, 1, "", "hf_energy"], [0, 2, 1, "", "hf_mo_coeff"], [0, 2, 1, "", "hf_mo_occ"], [0, 2, 1, "", "mo_coeff"], [0, 2, 1, "", "mo_occ"], [0, 4, 1, "", "mole"], [0, 2, 1, "", "mp2_energy"], [0, 2, 1, "", "mp2_t2"], [0, 2, 1, "", "nelec"], [0, 2, 1, "", "norb"], [0, 2, 1, "", "one_body_integrals"], [0, 2, 1, "", "orbital_symmetries"], [0, 3, 1, "", "run_ccsd"], [0, 3, 1, "", "run_cisd"], [0, 3, 1, "", "run_fci"], [0, 3, 1, "", "run_mp2"], [0, 3, 1, "", "run_sci"], [0, 4, 1, "", "scf"], [0, 2, 1, "", "sci_energy"], [0, 2, 1, "", "sci_vec"], [0, 2, 1, "", "spin"], [0, 2, 1, "", "symmetry"], [0, 3, 1, "", "to_fcidump"], [0, 3, 1, "", "to_json"], [0, 2, 1, "", "two_body_integrals"]], "ffsim.MolecularHamiltonian": [[0, 2, 1, "", "constant"], [0, 3, 1, "", "from_fcidump"], [0, 4, 1, "", "norb"], [0, 2, 1, "", "one_body_tensor"], [0, 3, 1, "", "rotated"], [0, 2, 1, "", "two_body_tensor"]], "ffsim.NumNumAnsatzOpSpinBalanced": [[0, 3, 1, "", "from_diag_coulomb_mats"], [0, 3, 1, "", "from_parameters"], [0, 2, 1, "", "interaction_pairs"], [0, 3, 1, "", "n_params"], [0, 2, 1, "", "norb"], [0, 2, 1, "", "thetas"], [0, 3, 1, "", "to_diag_coulomb_mats"], [0, 3, 1, "", "to_parameters"]], "ffsim.ProductStateSum": [[0, 2, 1, "", "coeffs"], [0, 2, 1, "", "states"]], "ffsim.SingleFactorizedHamiltonian": [[0, 2, 1, "", "constant"], [0, 3, 1, "", "expectation_product_state"], [0, 3, 1, "", "from_molecular_hamiltonian"], [0, 4, 1, "", "norb"], [0, 2, 1, "", "one_body_squares"], [0, 2, 1, "", "one_body_tensor"], [0, 3, 1, "", "reduced_matrix_product_states"]], "ffsim.Spin": [[0, 2, 1, "", "ALPHA"], [0, 2, 1, "", "ALPHA_AND_BETA"], [0, 2, 1, "", "BETA"]], "ffsim.StateVector": [[0, 2, 1, "", "nelec"], [0, 2, 1, "", "norb"], [0, 2, 1, "", "vec"]], "ffsim.UCCSDOpRestrictedReal": [[0, 3, 1, "", "from_parameters"], [0, 3, 1, "", "n_params"], [0, 4, 1, "", "norb"], [0, 3, 1, "", "to_parameters"]], "ffsim.UCJOpSpinBalanced": [[0, 2, 1, "", "diag_coulomb_mats"], [0, 2, 1, "", "final_orbital_rotation"], [0, 3, 1, "", "from_parameters"], [0, 3, 1, "", "from_t_amplitudes"], [0, 3, 1, "", "n_params"], [0, 4, 1, "", "n_reps"], [0, 4, 1, "", "norb"], [0, 2, 1, "", "orbital_rotations"], [0, 3, 1, "", "to_parameters"]], "ffsim.UCJOpSpinUnbalanced": [[0, 2, 1, "", "diag_coulomb_mats"], [0, 2, 1, "", "final_orbital_rotation"], [0, 3, 1, "", "from_parameters"], [0, 3, 1, "", "from_t_amplitudes"], [0, 3, 1, "", "n_params"], [0, 4, 1, "", "n_reps"], [0, 4, 1, "", "norb"], [0, 2, 1, "", "orbital_rotations"], [0, 3, 1, "", "to_parameters"]], "ffsim.UCJOpSpinless": [[0, 2, 1, "", "diag_coulomb_mats"], [0, 2, 1, "", "final_orbital_rotation"], [0, 3, 1, "", "from_parameters"], [0, 3, 1, "", "from_t_amplitudes"], [0, 3, 1, "", "n_params"], [0, 4, 1, "", "n_reps"], [0, 4, 1, "", "norb"], [0, 2, 1, "", "orbital_rotations"], [0, 3, 1, "", "to_parameters"]], "ffsim.contract": [[1, 5, 1, "", "contract_diag_coulomb"], [1, 5, 1, "", "contract_num_op_sum"], [1, 5, 1, "", "contract_one_body"], [1, 5, 1, "", "diag_coulomb_linop"], [1, 5, 1, "", "num_op_sum_linop"], [1, 5, 1, "", "one_body_linop"]], "ffsim.linalg": [[2, 1, 1, "", "GivensRotation"], [2, 5, 1, "", "apply_matrix_to_slices"], [2, 5, 1, "", "double_factorized"], [2, 5, 1, "", "double_factorized_t2"], [2, 5, 1, "", "double_factorized_t2_alpha_beta"], [2, 5, 1, "", "expm_multiply_taylor"], [2, 5, 1, "", "givens_decomposition"], [2, 5, 1, "", "is_antihermitian"], [2, 5, 1, "", "is_hermitian"], [2, 5, 1, "", "is_orthogonal"], [2, 5, 1, "", "is_real_symmetric"], [2, 5, 1, "", "is_special_orthogonal"], [2, 5, 1, "", "is_unitary"], [2, 5, 1, "", "lup"], [2, 5, 1, "", "match_global_phase"], [2, 5, 1, "", "modified_cholesky"], [2, 5, 1, "", "one_hot"], [2, 5, 1, "", "reduced_matrix"]], "ffsim.linalg.GivensRotation": [[2, 2, 1, "", "c"], [2, 2, 1, "", "i"], [2, 2, 1, "", "j"], [2, 2, 1, "", "s"]], "ffsim.optimize": [[3, 5, 1, "", "minimize_linear_method"]], "ffsim.qiskit": [[4, 1, 1, "", "DiagCoulombEvolutionJW"], [4, 1, 1, "", "DiagCoulombEvolutionSpinlessJW"], [4, 1, 1, "", "DropNegligible"], [4, 1, 1, "", "FfsimSampler"], [4, 1, 1, "", "GivensAnsatzOpJW"], [4, 1, 1, "", "GivensAnsatzOpSpinlessJW"], [4, 1, 1, "", "MergeOrbitalRotations"], [4, 1, 1, "", "NumNumAnsatzOpSpinBalancedJW"], [4, 1, 1, "", "NumOpSumEvolutionJW"], [4, 1, 1, "", "NumOpSumEvolutionSpinlessJW"], [4, 1, 1, "", "OrbitalRotationJW"], [4, 1, 1, "", "OrbitalRotationSpinlessJW"], [4, 6, 1, "", "PRE_INIT"], [4, 1, 1, "", "PrepareHartreeFockJW"], [4, 1, 1, "", "PrepareHartreeFockSpinlessJW"], [4, 1, 1, "", "PrepareSlaterDeterminantJW"], [4, 1, 1, "", "PrepareSlaterDeterminantSpinlessJW"], [4, 1, 1, "", "SimulateTrotterDiagCoulombSplitOpJW"], [4, 1, 1, "", "SimulateTrotterDoubleFactorizedJW"], [4, 1, 1, "", "UCJOpSpinBalancedJW"], [4, 1, 1, "", "UCJOpSpinUnbalancedJW"], [4, 1, 1, "", "UCJOpSpinlessJW"], [4, 5, 1, "", "ffsim_vec_to_qiskit_vec"], [4, 5, 1, "", "final_state_vector"], [4, 5, 1, "", "jordan_wigner"], [4, 5, 1, "", "pre_init_passes"], [4, 5, 1, "", "qiskit_vec_to_ffsim_vec"]], "ffsim.qiskit.DiagCoulombEvolutionJW": [[4, 3, 1, "", "__init__"], [4, 3, 1, "", "inverse"]], "ffsim.qiskit.DiagCoulombEvolutionSpinlessJW": [[4, 3, 1, "", "__init__"], [4, 3, 1, "", "inverse"]], "ffsim.qiskit.DropNegligible": [[4, 3, 1, "", "__init__"], [4, 3, 1, "", "run"]], "ffsim.qiskit.FfsimSampler": [[4, 3, 1, "", "__init__"], [4, 3, 1, "", "run"]], "ffsim.qiskit.GivensAnsatzOpJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.GivensAnsatzOpSpinlessJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.MergeOrbitalRotations": [[4, 3, 1, "", "run"]], "ffsim.qiskit.NumNumAnsatzOpSpinBalancedJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.NumOpSumEvolutionJW": [[4, 3, 1, "", "__init__"], [4, 3, 1, "", "inverse"]], "ffsim.qiskit.NumOpSumEvolutionSpinlessJW": [[4, 3, 1, "", "__init__"], [4, 3, 1, "", "inverse"]], "ffsim.qiskit.OrbitalRotationJW": [[4, 3, 1, "", "__init__"], [4, 3, 1, "", "inverse"]], "ffsim.qiskit.OrbitalRotationSpinlessJW": [[4, 3, 1, "", "__init__"], [4, 3, 1, "", "inverse"]], "ffsim.qiskit.PrepareHartreeFockJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.PrepareHartreeFockSpinlessJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.PrepareSlaterDeterminantJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.PrepareSlaterDeterminantSpinlessJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.SimulateTrotterDiagCoulombSplitOpJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.SimulateTrotterDoubleFactorizedJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.UCJOpSpinBalancedJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.UCJOpSpinUnbalancedJW": [[4, 3, 1, "", "__init__"]], "ffsim.qiskit.UCJOpSpinlessJW": [[4, 3, 1, "", "__init__"]], "ffsim.random": [[5, 5, 1, "", "random_antihermitian"], [5, 5, 1, "", "random_diagonal_coulomb_hamiltonian"], [5, 5, 1, "", "random_double_factorized_hamiltonian"], [5, 5, 1, "", "random_fermion_hamiltonian"], [5, 5, 1, "", "random_fermion_operator"], [5, 5, 1, "", "random_hermitian"], [5, 5, 1, "", "random_molecular_hamiltonian"], [5, 5, 1, "", "random_orthogonal"], [5, 5, 1, "", "random_real_symmetric_matrix"], [5, 5, 1, "", "random_special_orthogonal"], [5, 5, 1, "", "random_state_vector"], [5, 5, 1, "", "random_statevector"], [5, 5, 1, "", "random_t2_amplitudes"], [5, 5, 1, "", "random_two_body_tensor"], [5, 5, 1, "", "random_uccsd_restricted"], [5, 5, 1, "", "random_ucj_op_spin_balanced"], [5, 5, 1, "", "random_ucj_op_spin_unbalanced"], [5, 5, 1, "", "random_ucj_op_spinless"], [5, 5, 1, "", "random_unitary"]], "ffsim.testing": [[6, 5, 1, "", "assert_allclose_up_to_global_phase"], [6, 5, 1, "", "generate_norb_nelec"], [6, 5, 1, "", "generate_norb_nelec_spin"], [6, 5, 1, "", "generate_norb_nocc"], [6, 5, 1, "", "generate_norb_spin"], [6, 5, 1, "", "random_nelec"], [6, 5, 1, "", "random_occupied_orbitals"]]}, "objnames": {"0": ["py", "module", "Python module"], "1": ["py", "class", "Python class"], "2": ["py", "attribute", "Python attribute"], "3": ["py", "method", "Python method"], "4": ["py", "property", "Python property"], "5": ["py", "function", "Python function"], "6": ["py", "data", "Python data"]}, "objtypes": {"0": "py:module", "1": "py:class", "2": "py:attribute", "3": "py:method", "4": "py:property", "5": "py:function", "6": "py:data"}, "terms": {"": [0, 2, 4, 8, 9, 13, 14, 15, 16, 17, 18, 19, 21, 22, 23], "0": [0, 2, 3, 4, 6, 8, 9, 11, 13, 14, 15, 16, 18, 19, 20, 21, 23], "00": 18, "000": 20, "0000000": [15, 18], "0000000000011100000000000111": 20, "0000000000011100000000011100": 20, "0000000000011100100000001100": 20, "0000000000110100000000001101": 20, "0000000001011000000000010110": 20, "0000000001011000100000000110": 20, "0000000001110000000000000111": 20, "0000000111100000011111": 20, "0000000111100110000111": 20, "0000010101100001011011": 20, "0000010110100001011011": 20, "0000100101100000111011": 20, "0000100110100000111011": 20, "0000111100001111": 20, "0000111100011011": 20, "0000111100011101": 20, "0000111100101011": 20, "0001": 3, "0001000001010000000000000111": 20, "0001110100001111": 20, "000e": 18, "0010000000011000000000010110": 20, "0010011100101101": 20, "0010101100001111": 20, "0010101100101101": 20, "001011": [0, 14], "0010110100100111": 20, "0010110100101011": 20, "0010963985209662588": 18, "001101": [0, 14], "001110": [0, 14], "0012186049723606237": 18, "003169753739017794": 18, "0043114907894774524": 18, "005e": 15, "01": [15, 18], "0100000001001000000000000111": 20, "0100000110100100001111": 20, "010011": [0, 14], "0101": 0, "0101000001100000011111": 20, "010101": [0, 14], "010110": [0, 14], "0110": 0, "02": [15, 18], "02122442107773": 18, "02242": 2, "02459434j": 14, "02625": 2, "02998708j": 14, "03": 15, "03101213j": 14, "03525116j": 14, "03668541730983599": 23, "04": [15, 18], "04758323886584753": 18, "05": [0, 2, 3, 4, 18], "05395": 4, "06": 18, "0609050": 5, "0625": [0, 16], "06273307": 14, "06551571": 14, "06677383j": 14, "06844774j": 14, "07": [6, 18], "07716715j": 16, "08": [0, 2, 3, 4, 18], "087e": 18, "08957": 2, "090e": 18, "094e": 15, "09723851": 14, "0b001011": 0, "0b010101": 0, "0b010110": 0, "0b100101": 0, "0b100110": 0, "0j": 16, "0x7f6ca51ad390": 19, "0x7f6ca5862aa0": 19, "0x7f6ca5940880": 19, "0x7f6ca59419f0": 19, "0x7f6ca5941e40": 19, "0x7f6ca5941ea0": 19, "0x7f6ca5943490": 19, "0x7f6ca5943cd0": 19, "1": [0, 2, 3, 4, 5, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23], "10": [13, 18, 19, 20, 23], "100": 15, "1000": 3, "1000000101100000111011": 20, "100011": [0, 14], "100101": [0, 14], "100110": [0, 14], "101": 20, "1024": 4, "104": [15, 21], "105e": 18, "1077416820310391": 20, "108": [20, 23], "10_000": 20, "11": [0, 13, 19, 20, 23], "1102529j": 14, "11157654": 14, "112": 15, "12": [2, 13, 15, 16, 18, 23], "1207": 0, "12204343": 14, "1234": [9, 13, 14, 15, 19, 21], "12345": 20, "125": [0, 16], "1278053627110058": 20, "1294": [15, 18], "12j": 16, "13": [0, 13, 18, 23], "13113848": 14, "133": 20, "13327423j": 14, "13957088j": 14, "14": [13, 20], "146e": 15, "15": [13, 15], "151e": 18, "15212504": 16, "152e": 18, "1561685j": 14, "15624569": 14, "15828306": 14, "15x15": 15, "16": [13, 20], "17": 13, "1711": [2, 4], "17181289596": 21, "17276745j": 14, "17558331": 14, "18": 13, "180": 15, "18007105": 14, "1808": 2, "1816193567350311e": 18, "18j": 16, "19": 0, "1e": [0, 2, 3, 4, 6, 15, 23], "1j": [0, 9, 16, 23], "2": [0, 1, 2, 4, 5, 8, 9, 11, 13, 14, 15, 16, 18, 19, 20, 23], "20835741": 14, "20881506": 14, "21": 0, "210": 20, "2104": 2, "2190712273": 9, "21928194": 14, "21984743e": 16, "22392824": 14, "23": 15, "230e": 18, "23550198": 14, "23611476": 14, "24": [13, 19], "242e": 18, "25": [0, 16], "25j": [0, 16], "26": 23, "26121865": 14, "263e": 18, "286e": 18, "29821173j": 14, "2d": 0, "2j": [0, 2, 16], "2n": 14, "3": [0, 2, 5, 9, 11, 13, 14, 15, 16, 18, 19, 20, 23], "30052742j": 14, "31980058j": 14, "31g": [20, 21], "32": [13, 19], "329": 18, "33731417j": 14, "339": 18, "3484557089003": 20, "35": [0, 23], "36730125j": 14, "3714141": 14, "384": 18, "38435478j": 14, "39": [13, 14, 15, 16, 18, 19, 20], "39075171": 14, "3j": 16, "4": [0, 2, 8, 9, 13, 14, 15, 16, 18, 19, 20, 21, 23], "420e": 15, "421e": 18, "424e": 15, "4390672": 14, "455e": 18, "45619739093132": 20, "46": 18, "460e": 18, "464957764796": 23, "46x46": 18, "47": 20, "478": 15, "48": [13, 20], "49094286j": 14, "4j": 16, "5": [0, 3, 9, 13, 14, 15, 16, 18, 19, 20, 23], "51253171j": 14, "519e": 18, "55717072551556": 9, "56": [13, 19, 20], "561e": 18, "5626": 18, "562e": 18, "568": 18, "57": 20, "58888": 22, "5j": [0, 16], "6": [0, 9, 13, 14, 15, 16, 19, 20, 21, 23], "603e": 15, "6083": 0, "6332495815006": 15, "64": 14, "65": 20, "66": 20, "67794403659722": 15, "6787887956297": 15, "6787887956314": 15, "68381560472928": 15, "690e": 18, "6g": [0, 15, 18, 23], "6j": 16, "7": [0, 9, 13, 14, 15, 16, 18, 19, 23], "70": 20, "700e": 18, "705e": 18, "72": 18, "7288249991515": 15, "72x72": 18, "73105542j": 14, "743704662632361e": 18, "748e": 15, "75": [15, 20], "751e": 15, "77": 18, "8": [0, 13, 15, 16, 19, 20, 23], "8266321248744": 18, "835236570775": 20, "87160024816274": 18, "87363069599299": 18, "87363426535352": 18, "8736342817356": 18, "87363433826606": 18, "87387391422578": 18, "87421536374029": 18, "8742165643862": 18, "9": [13, 14, 16, 19, 23], "913e": 18, "9289": 18, "937e": 18, "9402435115724028": 23, "949": 18, "958": 15, "9630419334855": 20, "99": 9, "9923307413892999": 18, "9923426063078371": 18, "9924": 20, "9936417698594683": 18, "9985212854218731": 23, "9985212854220817": 23, "9991": 20, "9996731164188345": 23, "A": [0, 1, 2, 3, 4, 5, 6, 8, 12, 13, 14, 16, 22, 23], "AND": 15, "As": [11, 13, 14, 18, 19, 23], "By": 21, "For": [0, 3, 4, 5, 8, 9, 11, 14, 15, 16, 22, 23], "If": [0, 1, 2, 3, 4, 5, 6, 13, 16], "In": [0, 8, 9, 11, 13, 14, 15, 16, 18, 19, 20, 23], "It": [0, 2, 3, 4, 13, 14, 16, 18, 20, 22], "Its": [3, 4], "NO": [15, 18], "No": 2, "Of": 11, "On": [14, 22], "One": [0, 23], "Such": 16, "That": [0, 3, 12, 16], "The": [0, 1, 2, 3, 4, 5, 6, 8, 9, 10, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23], "Their": 19, "Then": [0, 13], "There": 13, "These": [0, 5, 11, 16, 19], "To": [0, 8, 9, 11, 14, 18, 23], "With": [11, 14, 23], "_": [0, 1, 2, 4, 8, 11, 12, 15, 23], "_1": 12, "_2": 12, "__init__": 4, "_factr": 18, "_i": [0, 4], "_k": [0, 8, 11], "_nestedsequ": 4, "_supportsarrai": 4, "a_": [0, 4, 8, 9, 12, 16], "a_j": 1, "a_p": 0, "a_q": 0, "ab": [0, 23], "abil": 8, "abl": 22, "about": 21, "abov": [13, 16], "absenc": [0, 1, 4], "absolut": [0, 2, 4, 6], "acceler": 22, "accept": [12, 18], "access": [0, 9, 22], "accommod": 4, "accomod": 8, "accur": 8, "achiev": [2, 23], "across": 22, "act": [0, 2, 4, 9, 13, 15, 16], "action": [0, 1, 12, 16, 22, 23], "activ": [0, 15, 18, 20, 23], "active_spac": [0, 15, 18, 20, 21, 23], "actual": [6, 11], "ad": [0, 13, 18], "add": [13, 18], "addit": [0, 8, 16, 23], "addition": 2, "address": [0, 13], "addresses_to_str": [0, 7, 14], "adjac": 13, "advantag": 18, "after": [3, 18], "al": 2, "algebra": [2, 9, 16], "algorithm": [0, 2, 3, 18, 21], "alia": [0, 2], "align": [0, 11, 12], "all": [0, 1, 2, 3, 4, 6, 11, 13, 16, 20, 22], "alloc": 0, "allow": [0, 2, 5, 11, 13, 18, 22, 23], "along": 0, "alpha": [0, 1, 2, 4, 5, 6, 9, 11, 13, 14, 15, 16, 19, 20], "alpha_and_beta": 0, "alpha_i": 0, "alpha_j": 0, "alreadi": [0, 4, 12], "also": [0, 2, 3, 5, 9, 12, 14, 16, 18, 23], "altern": [0, 8], "alwai": [0, 2, 5, 12, 14, 23], "amen": 13, "amplitud": [0, 2, 5, 18, 20], "an": [0, 1, 2, 4, 5, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 21, 23], "angl": 0, "ani": [0, 3, 4, 5, 11, 12, 19, 20], "annihil": [0, 16], "anoth": [2, 6], "ansatz": [0, 3, 4, 5, 10, 13, 17, 19, 20, 21], "ansatz_oper": 0, "ansatz_st": 18, "anti": [2, 5], "anticommut": 12, "ao": 0, "ap": 2, "api": [14, 21], "appear": [0, 2, 13, 16, 20], "append": [0, 6, 13, 18, 19, 20], "appli": [0, 1, 2, 3, 4, 9, 11, 12, 13, 14, 18, 19, 20, 21, 23], "applic": 12, "apply_": 14, "apply_diag_coulomb_evolut": [0, 7, 8, 23], "apply_fsim_g": [0, 7], "apply_fswap_g": [0, 7], "apply_givens_rot": [0, 7], "apply_hop_g": [0, 7], "apply_matrix_to_slic": [2, 7], "apply_num_interact": [0, 7], "apply_num_num_interact": [0, 7], "apply_num_op_prod_interact": [0, 7], "apply_num_op_sum_evolut": [0, 7, 12, 23], "apply_on_site_interact": [0, 7, 14], "apply_orbital_rot": [0, 7, 12, 14, 21], "apply_quad_ham_evolut": 12, "apply_tunneling_interact": [0, 7, 14], "apply_unitari": [0, 7, 18], "appropri": [0, 11], "approx": 8, "approx_eq": [0, 7], "approxim": [0, 2, 3, 8, 18, 23], "apt": 22, "ar": [0, 1, 2, 4, 5, 6, 8, 9, 11, 12, 13, 14, 16, 19, 20, 22], "arbitrari": [4, 20], "arch": 22, "arg": [0, 4], "argument": [0, 2, 3, 8, 9, 12, 14, 23], "aris": 8, "arithmet": 16, "around": 23, "arrai": [0, 1, 2, 4, 6, 9, 11, 14, 16], "arxiv": [0, 2, 4, 5], "ascend": 20, "assembl": 2, "assert": 14, "assert_allclose_up_to_global_phas": [6, 7], "assertionerror": 6, "associ": [0, 3, 14, 16, 18], "assum": [0, 4, 14], "asterisk": 0, "asymmetr": 8, "atol": [0, 2, 4, 6], "atom": [0, 15, 18, 20, 21, 23], "attempt": 2, "attribut": [0, 3, 9, 15, 18, 20], "author": 21, "auto": 0, "avail": [9, 19, 22], "avoid": [0, 9, 16], "awar": 16, "ax": [0, 2], "axi": [0, 2], "b": [0, 2, 3, 6, 12, 15, 18], "back": 4, "backend": [13, 19], "backflow": 3, "background": 23, "balanc": [0, 4, 5, 18, 20], "barrier": 20, "base": [0, 2, 4], "basepass": 4, "basesamplerv2": 4, "basi": [0, 2, 4, 12, 15, 18, 20, 21, 23], "basic": [9, 13], "basis_g": [13, 19], "bear": 23, "becaus": [0, 2, 8, 9, 13, 15, 16, 18], "been": [0, 8], "befor": [0, 13, 16, 22, 23], "begin": [0, 2, 11, 12, 14, 20, 23], "behavior": [2, 4, 5, 19], "being": [2, 16, 18], "below": [0, 18, 23], "benchmark": 0, "beta": [0, 1, 2, 4, 5, 6, 9, 11, 13, 14, 15, 16, 19, 20], "beta_i": 0, "beta_j": 0, "better": 8, "between": [0, 1, 2, 3, 11, 13], "bfg": [0, 2, 3, 15, 18], "bibtex": 21, "bit": [0, 13, 14], "bit_arrai": 0, "bitstr": [0, 14, 20], "bitstring_typ": [0, 14], "bitstringtyp": [0, 7, 14], "bla": 22, "bloc": 20, "block": 2, "block_diag": [0, 2], "bmod": 0, "bodi": [0, 1, 2, 5, 8, 9, 18, 23], "bond": 15, "bond_angle_deg": 15, "bond_dist": 18, "bool": [0, 1, 2, 3, 4, 5, 6], "both": [0, 1, 2, 4, 11, 15], "bound": [0, 2], "boundari": 0, "box": 13, "bq": 2, "bracket": 0, "braket": 0, "branch": 21, "brickwork": 15, "browser": 22, "buffer": 4, "build": [13, 17, 18, 20, 21, 22], "built": [19, 20, 23], "byte": [0, 4], "bz2": 0, "c": [2, 18], "c2v": 15, "cach": 0, "calcul": [0, 14, 18], "call": [0, 3, 8, 9, 12, 14, 16, 18, 20, 23], "callabl": [3, 18], "callback": [0, 2, 3, 18], "can": [0, 1, 2, 4, 5, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 21, 22, 23], "cannot": 20, "canon": 0, "casci": [15, 18], "case": [0, 6, 13, 15], "categori": 21, "caus": 0, "cc": [18, 20], "ccsd": [0, 18, 20], "ccsd_energi": 0, "ccsd_t1": 0, "ccsd_t2": 0, "cd": 22, "cdot": 2, "cell": [9, 13, 14, 18, 19, 20, 23], "certain": [2, 13], "challeng": 11, "character": 0, "check": [2, 4, 6], "chemcor": 23, "chemic": 0, "chemical_potenti": 0, "chemistri": 21, "choic": [0, 6, 13, 14], "choleski": [0, 2], "choos": [2, 14], "chosen": 0, "ci": [15, 18], "circuit": [0, 4, 8, 13, 14, 17, 21], "circul": 0, "cisd": 0, "cisd_energi": 0, "cisd_vec": 0, "class": [0, 2, 4, 5, 9, 11, 15, 17, 18, 20, 21, 23], "clement": 2, "clone": 22, "close": [11, 18], "cluster": [0, 4, 5, 10, 17, 21], "co": [0, 15], "code": [4, 9, 13, 14, 16, 18, 19, 20, 23], "coeff": [0, 1, 4, 13, 19], "coeffici": [0, 1, 2, 4, 12, 16], "collect": [0, 2, 4, 18], "column": [0, 2, 12, 14], "com": [21, 22], "comb": 4, "combin": [0, 1, 4, 12, 13, 16], "command": 22, "commonli": [8, 20], "commun": [21, 22], "commut": 8, "compact": [8, 23], "compar": [0, 6, 23], "compil": 22, "complet": 0, "complex": [0, 1, 2, 4, 5, 9], "compon": [0, 16, 21], "compos": [4, 22], "compress": [0, 2], "compris": [0, 16], "comput": [0, 2, 4, 9, 12, 18, 21, 23], "concaten": [0, 14], "concret": 9, "condit": 0, "configur": [0, 4, 13, 14, 22], "conflict": 6, "conj": [2, 12, 20], "conjug": 2, "connect": [0, 11, 13], "consecut": [4, 20], "conserv": [0, 5, 16, 21], "conserves_particle_numb": [0, 16], "conserves_spin_z": [0, 16], "consid": [11, 12, 13], "consist": [0, 9, 13], "constant": [0, 5, 8, 9, 11, 13, 19], "constrain": 2, "constraint": [11, 18], "construct": [0, 1, 3, 4, 13, 14, 15, 16, 18, 19, 20, 23], "contain": [0, 2, 3, 5, 13, 16, 20, 21, 22], "contract": [2, 7, 21], "contract_diag_coulomb": [1, 7], "contract_num_op_sum": [1, 7], "contract_one_bodi": [1, 7], "contrast": 14, "control": [3, 13], "conveni": 14, "convent": 0, "converg": [3, 15, 18, 20, 23], "convers": [11, 18], "convert": [0, 1, 4, 14, 16, 18, 20, 21, 23], "coordin": 0, "coov": 20, "copi": [0, 16], "core": 0, "core_energi": 0, "correl": 3, "correspond": [0, 2, 3, 4, 8, 12, 13, 14, 18], "cost": 0, "coulomb": [0, 1, 2, 4, 5, 8, 11, 23], "count": [0, 13, 20], "count_op": [13, 19], "coupl": 0, "cours": 11, "cp": [13, 19], "cphaseg": 13, "cre": [0, 7], "cre_a": [0, 7, 16], "cre_b": [0, 7, 16], "creat": [0, 4, 13, 14, 16, 19, 20, 21, 23], "creation": [0, 4, 12, 16], "criteria": 16, "current": [0, 2, 18], "d": [2, 22], "d2h": 18, "dag": 4, "dagcircuit": 4, "dagger": [0, 1, 2, 8, 11, 12, 16], "dagger_": [0, 4, 8, 9, 12], "dagger_i": 1, "dagger_p": 0, "dagger_q": 0, "data": [0, 5, 13, 15, 16, 18, 20, 21, 23], "daunt": 8, "de": [0, 7], "decompos": [2, 4, 8, 13, 19], "decomposit": [0, 2, 4, 8, 10, 19, 21, 23], "decreas": [0, 18], "def": [2, 12, 15, 18, 23], "default": [0, 2, 3, 4, 5, 8, 9, 23], "default_rng": [0, 4, 5, 6, 9, 13, 15, 19, 20], "default_shot": [4, 20], "defaultdict": 18, "defin": [0, 2, 13, 15, 18, 20, 23], "definit": [0, 2, 3, 14], "demonstr": [14, 18, 20], "denot": [0, 1, 2, 4, 12], "dens": 15, "densiti": 0, "depend": [0, 2, 3, 22, 23], "depolar": 4, "deprec": [0, 5], "depth": 11, "deriv": 8, "des_a": [0, 7, 16], "des_b": [0, 7, 16], "descend": [0, 16], "describ": [0, 1, 2, 8, 11, 12, 13, 16, 23], "descript": [0, 4], "design": [0, 2, 12], "desir": [0, 2, 5, 6], "destroi": [0, 16], "detail": [13, 19], "determin": [0, 2, 4, 14], "determinant": 0, "dev": 22, "devel": 22, "develop": [4, 21], "devic": [13, 19], "df_hamiltonian": [13, 19, 23], "df_hamiltonian_alt": 23, "diag": [0, 7], "diag_coulomb_indic": [0, 2], "diag_coulomb_jw": 13, "diag_coulomb_linop": [1, 7], "diag_coulomb_mat": [0, 2, 13, 19, 20, 23], "diagcoulombevolutionjw": [4, 7, 13, 19, 20], "diagcoulombevolutionspinlessjw": [4, 7], "diagon": [0, 1, 2, 4, 5, 8, 11, 23], "diagonal_coulomb_mat": 2, "diagonalcoulombhamiltonian": [0, 4, 5, 7], "dict": [0, 2, 3, 15, 18], "dictionari": [0, 16], "did": 0, "differ": [0, 1, 2, 3, 9, 11, 13, 18, 22, 23], "dim": [0, 5, 7, 14, 16], "dim_a": [0, 14], "dim_b": [0, 14], "dimens": [0, 2, 5, 14], "dimension": [0, 2, 4, 14], "dipol": 0, "dipole_integr": 0, "direct": [0, 23], "directli": [0, 13, 18, 22, 23], "directori": 22, "discuss": [8, 12, 13], "disjoint": 2, "disk": 0, "displai": [13, 16, 20], "distinguish": 14, "distribut": [4, 5], "divid": 8, "divis": [0, 16], "dnf": 22, "do": [8, 13, 16], "doc": [15, 18, 21], "docker": 21, "dockerfil": 22, "document": [0, 2], "doe": [0, 4, 16, 18, 20], "don": 11, "dooh": [20, 21, 23], "dot": 0, "doubl": [0, 2, 4, 5, 10, 21, 24], "double_factor": [0, 2, 7], "double_factorized_t2": [2, 7], "double_factorized_t2_alpha_beta": [2, 7], "doublefactorizedhamiltonian": [0, 4, 5, 7, 23], "down": 14, "draw": [13, 19], "drop": [4, 15, 18], "dropneglig": [4, 7], "dtype": [0, 2, 4, 5, 9, 15, 18], "due": 20, "dump": [15, 18], "duplic": 0, "dure": 4, "e": [0, 2, 4, 8, 9, 11, 15, 16, 18, 20], "e_corr": [18, 20], "each": [0, 2, 3, 4, 5, 8, 11, 14, 16, 18, 22, 23], "edg": 0, "effect": [0, 4, 13], "effici": [8, 13, 16], "eig": [9, 16], "eigendecomposit": 12, "eigenvalu": [0, 2, 3, 9], "eigenvector": [0, 2], "eigh": [12, 23], "eigsh": 9, "einsum": 23, "either": [0, 1, 2, 4, 5, 6, 11], "electon": 4, "electron": [0, 1, 4, 5, 9, 13, 14, 15, 19, 20, 23], "element": [0, 1, 2, 4, 20, 23], "ell": 2, "els": [0, 5, 14], "elsewher": 0, "enabl": 2, "encount": 20, "end": [0, 2, 11, 12, 20, 23], "energi": [0, 3, 9, 12, 18, 20, 21, 23], "energy_nuc": [15, 18], "enough": 4, "ensur": 9, "entangl": [0, 17, 21], "entir": [2, 8], "entri": [0, 2, 4, 5, 11, 14, 23], "enum": 0, "enumer": [0, 18], "environ": 22, "epsilon": 3, "epsmch": 18, "equal": [0, 2, 6, 13], "equal_nan": 6, "equilibrium": 15, "equival": [0, 4], "err_msg": 6, "error": [0, 2, 4, 6, 23], "especi": 16, "estim": 9, "et": 2, "etc": 0, "ethen": 18, "evalu": [3, 15], "even": 13, "everi": 12, "everywher": 14, "evolut": [0, 4, 9, 23], "evolv": [0, 23], "evolved_vec": 9, "evolved_vec_2": 9, "exact": [2, 8, 9, 23], "exact_st": 23, "exampl": [0, 4, 9, 11, 13, 14, 15, 16, 18, 19, 22], "exce": [2, 15, 23], "except": [0, 2, 3], "excit": 13, "exist": [2, 4], "exp": [0, 2, 4, 6], "expand": 0, "expanded_diag_coulomb_mat": 2, "expanded_orbital_rot": 2, "expans": [2, 3], "expect": [0, 3], "expectation_one_body_pow": [0, 7], "expectation_one_body_product": [0, 7], "expectation_product_st": 0, "expens": [0, 2], "explain": [9, 11, 13, 14, 18, 23], "explan": [0, 19, 21], "explicit": 0, "explicitli": 0, "exploit": 21, "expm": 2, "expm_multipli": [9, 23], "expm_multiply_taylor": [2, 7], "exponenti": [8, 9, 23], "expos": [4, 13], "express": [11, 14, 23], "extra": 8, "extract": 20, "f": [3, 14, 15, 18, 20, 23], "facilit": 11, "fact": 15, "factor": [0, 2, 4, 5, 10, 21, 24], "failur": 6, "fake_provid": [13, 19], "fals": [0, 1, 2, 4, 5, 15, 16, 18], "far": 16, "fast": 0, "faster": [18, 21], "fault": 11, "fci": [0, 14, 15, 18], "fci_energi": 0, "fci_vec": 0, "fcidump": 0, "fcivec": 0, "fedora": 22, "feenberg": 3, "fermi": 0, "fermi_hubbard_1d": [0, 7], "fermi_hubbard_2d": [0, 7], "fermion": [0, 4, 5, 6, 8, 10, 11, 12, 16, 19, 20, 21], "fermion_oper": [0, 7], "fermionact": [0, 7], "fermionoper": [0, 4, 5, 7, 17, 21], "few": [14, 22], "fewer": [13, 19, 23], "ffsim": [7, 8, 9, 11, 12, 13, 14, 15, 16, 17, 18, 19, 22, 23], "ffsim_vec_to_qiskit_vec": [4, 7], "ffsimsampl": [4, 7], "fidel": 23, "field": [0, 2], "fifth": 13, "file": [0, 22], "filter": 0, "final": [0, 3, 4, 5, 13, 19, 23], "final_orbital_rot": 0, "final_st": [18, 23], "final_state_vector": [4, 7], "finish": 23, "finit": 3, "first": [0, 2, 4, 8, 13, 14, 18, 20, 23], "fix": 14, "flag": 0, "float": [0, 2, 3, 4, 5, 6, 9, 12, 23], "float64": [9, 15, 18], "fock": [0, 4, 11, 14, 18, 21, 23], "focu": 9, "follow": [0, 2, 3, 4, 9, 11, 12, 13, 14, 16, 18, 19, 20, 21, 22, 23], "foot": 0, "forg": [0, 17, 21], "form": [0, 1, 2, 4, 5, 8, 9, 11, 12, 16, 20, 23], "format": [0, 4], "formula": [0, 23], "fourth": [8, 13], "frac": [0, 2], "frac12": [0, 8, 9, 11], "frac18": 0, "framework": 22, "from": [0, 2, 4, 5, 6, 8, 11, 12, 13, 14, 15, 16, 18, 19, 21, 23], "from_diag_coulomb_mat": 0, "from_fcidump": 0, "from_fermion_oper": 0, "from_json": 0, "from_mol": 0, "from_molecular_hamiltonian": [0, 23], "from_orbital_rot": 0, "from_paramet": [0, 13, 18], "from_scf": [0, 15, 18, 20, 21, 23], "from_t_amplitud": [0, 18, 20], "frozen": [18, 20], "fsim": 0, "fswap": 0, "ftol": [3, 18], "full": [0, 2, 13, 14, 15], "fulli": 9, "fun": [3, 15, 18], "function": [0, 1, 2, 3, 5, 8, 9, 12, 14, 15, 16, 18, 19, 23], "fundament": 12, "further": [13, 14], "furthermor": [0, 2], "g": [0, 4, 15], "g_": 2, "g_1": 2, "g_i": 3, "g_k": 2, "g_l": 2, "gate": [0, 4, 10, 11, 15, 20, 21], "gener": [0, 3, 4, 5, 6, 8, 13, 14, 15, 19, 20, 21], "generate_norb_nelec": [6, 7], "generate_norb_nelec_spin": [6, 7], "generate_norb_nocc": [6, 7], "generate_norb_spin": [6, 7], "generate_preset_pass_manag": [13, 19], "genericbackendv2": [13, 19], "get": [0, 14, 15, 18, 20, 21, 23], "get_count": 20, "get_hcor": [15, 18], "get_ovlp": [15, 18], "git": 22, "github": [21, 22], "give": [0, 2, 8, 14, 19], "given": [0, 2, 4, 6, 8, 12], "givens_ansatz_op": 4, "givens_decomposit": [2, 7], "givensansatzop": [0, 4, 7], "givensansatzopjw": [4, 7], "givensansatzopspinlessjw": [4, 7], "givensrot": [2, 7], "global": [4, 6], "global_depolar": 4, "go": [0, 13, 16], "good": 16, "gradient": [2, 3, 18], "greater": 3, "ground": [9, 18], "gt": [15, 18, 19, 20], "gto": [15, 18, 20, 21, 23], "gtol": 3, "guarante": [4, 19], "guess": [3, 18], "guid": [11, 15, 18, 19, 20, 21], "gzip": 0, "h": [0, 8, 9, 15, 18, 20, 23], "h1_x": 15, "h2_x": 15, "h2_y": 15, "h_": [0, 2, 8, 9], "h_0": [8, 23], "h_k": [8, 23], "ha": [0, 1, 2, 4, 8, 11, 12, 13, 14, 18], "haar": 5, "ham": 14, "hamiltonian": [0, 3, 4, 5, 10, 15, 18, 20, 21, 24], "hand": 14, "handl": [20, 23], "happen": 13, "hardwar": 13, "hartre": [0, 4, 11, 14, 18, 21, 23], "hartree_fock": 0, "hartree_fock_jw": 13, "hartree_fock_st": [0, 7, 9, 14, 18, 21, 23], "hasattr": 18, "hash": 16, "have": [0, 2, 8, 9, 11, 12, 13, 14, 16, 18, 20, 22], "height": 5, "helper": 16, "here": [0, 2, 8, 12, 13, 15, 23], "hermitian": [0, 2, 5, 12], "hess_inv": [15, 18], "hf": [15, 18], "hf_energi": 0, "hf_mo_coeff": 0, "hf_mo_occ": 0, "high": 13, "higher": [0, 8, 23], "ho": 20, "hold": [0, 3], "home": [15, 18, 22], "hop": [0, 15], "hopgateansatzoper": [0, 7, 15], "hot": [0, 2], "how": [0, 8, 9, 11, 12, 13, 14, 21, 23], "howev": [8, 13, 21], "http": [0, 21, 22], "hubbard": 0, "hydroxyl": 20, "hyperparamet": [3, 18], "i": [0, 1, 2, 3, 4, 5, 6, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23], "idea": 11, "ident": 0, "ignor": [0, 2, 8], "ij": [0, 1, 2, 4, 8, 11, 12], "ijab": 2, "ik": 12, "imag": 22, "implement": [0, 1, 3, 4, 8, 9, 11, 12, 13, 15, 18, 20, 21, 22, 24], "import": [0, 9, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23], "impos": [11, 18], "improv": [3, 23], "includ": [0, 2, 4, 5, 8, 9, 12, 13, 14, 15, 18, 19, 21, 22], "incorpor": 0, "increas": [0, 14, 23], "increment": 3, "incur": 3, "independ": [0, 1, 4, 15], "index": [0, 2, 11, 14, 16], "indic": [0, 1, 2, 4, 5, 11, 14, 16], "indices_to_str": [0, 7], "individu": [8, 14, 16], "info": 18, "inform": [0, 9, 16, 18, 21, 23], "init_cach": [0, 7], "initi": [0, 3, 4, 5, 6, 9, 11, 13, 18, 19, 20, 23], "initial_st": 23, "initiali": 15, "input": [0, 1, 3, 4, 5, 6, 18, 20], "insert": 13, "instanc": [5, 9, 23], "instead": [0, 2, 4, 5, 18, 23], "instruct": [21, 22], "instructionset": 19, "int": [0, 1, 2, 3, 4, 5, 6, 12, 15, 23], "int32": 0, "integ": [0, 2, 4, 5, 6, 14], "integr": [0, 4], "interact": [0, 1, 2, 4, 5, 11, 13, 18, 20], "interaction_pair": [0, 5, 13, 15, 18, 20], "interfac": [18, 22], "interferomet": 2, "intermedi": 18, "intermediate_result": [3, 18], "intern": 16, "interpret": [0, 5, 11], "intor_symmetr": [15, 18], "introduc": [11, 12, 23], "invers": 4, "involv": [12, 13], "ip": 2, "ipykernel_4175": 9, "is_antihermitian": [2, 7], "is_hermitian": [2, 7], "is_orthogon": [2, 7], "is_real_symmetr": [2, 7], "is_special_orthogon": [2, 7], "is_unitari": [2, 7], "isclos": 0, "isn": 4, "issu": [9, 13], "item": 20, "iter": [0, 3, 4, 6, 18], "itertool": 2, "its": [0, 2, 4, 9, 13, 14, 15, 16, 23], "itself": [0, 14, 16], "j": [0, 1, 2, 4, 5, 8, 11, 12, 14, 15, 16], "jac": [3, 15, 18], "jastrow": [0, 3, 4, 5, 10, 17, 21], "ji": [0, 4, 11, 12], "jk": 12, "job": [4, 20], "jordan": [0, 4], "jordan_wign": [4, 7], "jq": 2, "json": [0, 15, 18], "jupyt": 22, "just": [0, 14, 18, 22, 23], "jwt": 4, "k": [0, 2, 3, 8, 9, 11, 16, 20, 23], "kappa": 0, "kappa_": 0, "keep": [0, 2], "kei": 20, "kij": 23, "know": 15, "known": [0, 8], "kpi": 23, "kqi": 23, "krj": 23, "kron": 0, "ksj": 23, "kwarg": [0, 4], "l": [0, 2, 3, 8, 11, 15, 18, 23], "label": [4, 14], "ladder": [8, 11], "lambda": [0, 4, 20], "lambda_i": [0, 1, 4, 12], "lambda_k": 12, "langl": 0, "larger": [0, 2, 3, 16], "last": [0, 2, 3, 4], "later": [19, 23], "lattic": [0, 11, 13, 18, 20], "layer": [0, 2, 13, 20], "lbfgsinvhessproduct": [15, 18], "ldot": [0, 2, 8, 11, 23], "lead": 0, "least": 2, "left": [0, 4, 12, 14, 16], "len": [15, 18, 23], "length": [0, 4, 5, 14, 15], "leq": [0, 2, 5], "less": [2, 11], "let": [0, 13, 14, 16, 18, 19, 20, 23], "level": 23, "lexicograph": [0, 16], "lib": [15, 18], "libopenbla": 22, "librari": [0, 21], "like": [4, 11, 18, 22], "limit": [0, 2, 11, 13, 15, 18], "linalg": [0, 7, 9, 12, 16, 18, 21, 23], "lindep": 3, "line": [0, 11, 13, 18], "linear": [0, 1, 2, 3, 4, 9, 12, 13, 16], "linear_oper": [0, 7, 9, 16, 18, 21, 23], "linearli": 8, "linearoper": [0, 1, 3, 16, 18, 21, 23], "linop": [9, 16, 21, 23], "linux": 22, "list": [0, 2, 4, 5, 6, 11, 14, 15, 18, 20, 23], "ll": [9, 12, 13, 15, 18, 20, 23], "lm": 16, "load": 0, "local": [10, 17, 21], "localhost": 22, "log": [0, 4], "logarithm": 11, "logic": [12, 15], "longer": 11, "longest": 0, "lookup": 0, "losslessli": 0, "low": [0, 8, 23], "lower": [0, 2], "lowest": [0, 13, 14], "lt": [15, 18, 19, 20], "lu": 2, "lucj": [10, 13, 17, 21], "lup": [2, 7], "lvert": [0, 4, 11, 14], "lzma": 0, "m": [0, 1, 2, 12], "m_": [0, 1, 2], "maco": 22, "made": 23, "magnitud": 0, "mai": [0, 2, 3, 4, 11, 22, 23], "main": [18, 22], "maintain": 8, "make": [11, 13], "manag": [4, 13, 19, 22], "mani": [0, 9, 12, 14, 21], "manual": 23, "many_body_ord": 0, "map": [0, 4, 12, 13, 16], "mapsto": [0, 4, 12], "mat": [0, 1, 2, 4, 12, 14], "mat_aa": 2, "mat_ab": 2, "mat_alpha_beta": 1, "mat_bb": 2, "match": [0, 2], "match_global_phas": [2, 7], "math": [5, 15], "mathbf": [0, 8, 11, 12], "mathcal": [0, 1, 4, 8, 11, 12], "matric": [0, 1, 2, 4, 11, 12, 23], "matrix": [0, 1, 2, 3, 4, 5, 8, 9, 11, 12, 14, 16], "max": [3, 23], "max_error": 23, "max_term_length": 5, "max_vec": [0, 2, 23], "maxfun": 15, "maximum": [0, 2, 3, 5, 23], "maxit": [3, 18], "mcscf": [15, 18], "mea": 20, "meant": [4, 19], "measur": [5, 8, 20], "measure_al": 20, "mention": 8, "merg": [4, 19], "mergeorbitalrot": [4, 7, 13], "messag": [6, 15, 18], "method": [0, 2, 3, 11, 15, 16, 20, 21], "mid": 20, "might": 2, "mind": 23, "minim": [0, 2, 3, 13, 15, 18], "minimize_linear_method": [3, 7, 18], "minimizz": 15, "minimum": 4, "mk": 2, "mkap": 2, "mkbq": 2, "mkip": 2, "mkjq": 2, "mkpq": 2, "mo_coeff": 0, "mo_occ": 0, "mode": 12, "model": 0, "modifi": [0, 2], "modified_choleski": [2, 7], "modul": [0, 14, 15, 19, 20], "mol": [15, 18, 20, 21, 23], "mol_data": [15, 18, 20, 21, 23], "mol_hamiltonian": [9, 15, 18, 20, 23], "mole": [0, 15, 18, 20, 21, 23], "molecul": [0, 18, 21, 23], "molecular": [0, 5, 9, 10, 14, 15, 18, 20, 21, 23], "moleculardata": [0, 7, 15, 18, 20, 21, 23], "molecularhamiltonian": [0, 5, 7, 9, 23], "more": [0, 2, 3, 4, 8, 9, 11, 13, 14, 19, 23], "most": [0, 2, 16, 20], "motiv": 13, "mp2": 0, "mp2_energi": 0, "mp2_t2": 0, "mpl": [13, 19], "msg": [15, 18], "mu": 0, "much": [0, 2, 8, 13, 21], "multipl": [0, 9, 16, 23], "multipli": [0, 16], "multiport": 2, "multirefer": 0, "multireference_st": [0, 7], "multireference_state_prod": [0, 7, 15], "must": [0, 2, 3, 4, 5, 16, 20], "n": [0, 2, 3, 8, 9, 11, 12, 14, 20, 21, 23], "n2": [20, 21, 23], "n_": [0, 1, 4, 8, 11, 12, 14], "n_alpha": [4, 6, 20], "n_beta": [4, 6, 20], "n_frozen": [20, 23], "n_i": 4, "n_j": 4, "n_layer": 15, "n_p": 0, "n_param": [0, 13], "n_qubit": 4, "n_rep": [0, 5, 13, 18, 19, 20], "n_sampl": 0, "n_step": [0, 4, 13, 19, 23], "n_term": 5, "n_vec": 2, "n_x": 0, "n_y": 0, "name": [0, 9, 13, 14, 19, 22], "namedtupl": [0, 2], "nan": 6, "nao_nr": [15, 18, 20, 21, 23], "nativ": 21, "navig": 22, "ndarrai": [0, 1, 2, 3, 4, 5, 6, 12, 18, 23], "nearest": 0, "nearest_neighbor_interact": 0, "need": [0, 4, 9, 11, 13, 20, 22, 23], "neg": [0, 4], "neglig": 4, "neighbor": [0, 13], "nelec": [0, 1, 4, 6, 9, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23], "nelectron": 18, "neq": 0, "nest": 2, "network": 11, "new": [0, 4, 12, 16], "newli": 0, "next": [13, 15, 23], "nfev": [3, 15, 18], "nit": [15, 18], "nitrogen": [20, 23], "njev": [15, 18], "nlinop": [3, 18], "nn": 0, "nocc": [0, 5, 6], "nocc_a": 2, "nocc_b": 2, "noisi": [4, 11], "non": [4, 11], "none": [0, 1, 2, 3, 4, 5, 6], "nonzero": [0, 2, 5, 11], "norb": [0, 1, 2, 4, 5, 6, 9, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23], "norb_i": 0, "norb_rang": 6, "norb_x": 0, "norm": [0, 18], "normal": [0, 15, 16], "normal_ord": [0, 16], "note": [0, 2, 3, 13, 14, 16, 19, 21], "notebook": 22, "notic": 18, "notimplementederror": 4, "now": [9, 13, 15, 18, 20, 23], "np": [0, 2, 4, 5, 6, 9, 12, 13, 15, 18, 19, 20, 21, 23], "num_num_ansatz_op": 4, "num_op_sum_linop": [1, 7], "number": [0, 1, 2, 3, 4, 5, 6, 8, 9, 12, 14, 15, 16, 18, 21, 23], "number_oper": [0, 7], "numer": [0, 2, 4, 16], "numnumansatzopspinbalanc": [0, 4, 7], "numnumansatzopspinbalancedjw": [4, 7], "numopsumevolutionjw": [4, 7, 13, 19], "numopsumevolutionspinlessjw": [4, 7], "numpi": [0, 1, 2, 4, 6, 9, 11, 12, 13, 14, 15, 18, 19, 20, 21, 23], "o": [0, 15, 20], "o_1": 0, "o_2": 0, "o_k": 0, "obj": 0, "object": [0, 2, 3, 4, 5, 9, 16, 18, 20], "obtain": [0, 8, 9, 12, 13, 18, 23], "occ_a": 6, "occ_b": 6, "occup": [0, 6, 8, 12, 14], "occupi": [0, 4, 5, 6, 13, 14], "occupied_orbit": [0, 4, 13, 19, 20], "often": [8, 11, 18], "onc": [12, 13, 22], "one": [0, 1, 2, 4, 5, 8, 9, 13, 14, 18, 20, 22, 23], "one_body_basis_chang": 23, "one_body_energi": 23, "one_body_integr": 0, "one_body_linop": [1, 7], "one_body_squar": 0, "one_body_tensor": [0, 9, 23], "one_hot": [0, 2, 7], "one_rdm": 0, "ones": 9, "onli": [0, 2, 4, 8, 11, 12, 13, 20, 22], "onsit": 0, "onto": [13, 16], "op": [0, 4, 16], "op1": [0, 16], "op2": [0, 16], "op3": 16, "op4": 16, "opaqu": 13, "open": [0, 11], "openbla": 22, "oper": [0, 1, 2, 3, 4, 5, 8, 11, 12, 16, 18, 22, 23], "oppos": 13, "opposit": [18, 20], "optim": [0, 2, 4, 7, 11, 13, 19, 21], "optimization_level": [13, 19], "optimize_kwarg": 3, "optimize_regular": 3, "optimize_vari": 3, "optimizeresult": [3, 18], "option": [0, 1, 2, 3, 4, 5, 9, 15, 18, 22], "orb": [0, 16], "orbit": [0, 1, 2, 4, 5, 6, 8, 9, 10, 11, 14, 15, 16, 18, 20, 21, 23], "orbital_rot": [0, 1, 2, 4, 12, 13, 14, 19, 20, 21, 23], "orbital_rotation_a": 2, "orbital_rotation_b": 2, "orbital_symmetri": 0, "orbitalrotationjw": [4, 7, 13, 19, 20], "orbitalrotationspinlessjw": [4, 7], "order": [0, 1, 2, 4, 5, 8, 9, 13, 14, 16, 19, 20, 23], "ordereddict": [13, 19], "org": 0, "origin": [0, 2, 11, 13, 23], "orthogon": [2, 5], "other": [0, 4, 11, 14, 18, 19, 20], "otherwis": 0, "our": [15, 18, 20, 23], "out": [2, 23], "output": [0, 3, 4, 13, 18, 20], "over": 0, "overrid": [0, 2], "overwritten": [0, 15, 18], "own": 4, "p": [0, 2, 8, 9, 11, 13, 18, 19, 20], "packag": [15, 18, 22], "pacman": 22, "pad": 0, "page": [8, 9, 11, 12, 13, 14], "pair": [0, 1, 2, 4, 5, 6, 11, 13, 14], "pairs_aa": [13, 18, 20], "pairs_ab": [13, 18, 20], "pairs_bb": 20, "paper": 11, "parallel": [2, 11, 13], "param": 0, "paramet": [0, 1, 2, 3, 4, 5, 6, 11, 15, 18], "parameter_valu": 4, "params_to_vec": [3, 18], "pars": [15, 18], "part": [0, 5, 8, 12, 14, 15], "particl": [0, 5, 6, 12, 16, 21], "pass": [0, 1, 2, 4, 9, 12, 13, 14, 15, 16, 18, 19], "pass_manag": [13, 19], "passmanag": [4, 13], "path": 0, "pathlik": 0, "pattern": [13, 15], "pauli": 0, "per": 23, "perform": [0, 2, 3, 8, 9, 12, 13, 20, 23], "period": 0, "periodic_i": 0, "periodic_x": 0, "permut": 2, "persist": 22, "ph": 5, "phase": [0, 2, 4, 6, 13], "phase_angl": 0, "phaseg": 13, "phi": [0, 2, 6], "phi_0": 11, "pi": [0, 15], "piec": [9, 16], "pip": 21, "pipelin": 13, "pivot": 2, "pk": 2, "place": [0, 2, 11, 13, 16, 22], "plain": 14, "pmatrix": [0, 2], "point": 0, "polar": 0, "posit": [2, 3, 14], "possibl": [0, 2, 6, 20, 21], "possibli": [0, 18], "potenti": 0, "power": 0, "pq": [0, 2, 8, 9], "pqr": [0, 2, 8, 9, 23], "practic": 8, "pre": [11, 19], "pre_init": [4, 7, 13, 19], "pre_init_pass": [4, 7, 19], "precis": 6, "prepar": [0, 4, 20], "preparehartreefockjw": [4, 7, 13, 19, 20], "preparehartreefockspinlessjw": [4, 7, 20], "prepareslaterdeterminantjw": [4, 7, 13, 19, 20], "prepareslaterdeterminantspinlessjw": [4, 7, 20], "present": 3, "preserv": [16, 20], "preset_passmanag": [13, 19], "previou": [18, 20], "previous": [8, 13, 14, 18], "primit": [4, 17, 21], "primitivejob": 4, "primitiveresult": 4, "print": [0, 6, 13, 14, 15, 16, 18, 20, 21, 23], "probabl": [0, 4], "problem": 3, "process": 0, "processor": 11, "prod": 15, "prod_": [0, 4, 11], "prod_k": 8, "prod_state_sum": 0, "produc": [0, 13], "product": [0, 2, 8, 14, 15, 16], "productstatesum": [0, 7], "programmat": 16, "properti": [0, 2, 12], "proport": [0, 8], "protocol": 0, "provid": [9, 13, 19, 22], "pseudorandom": [0, 4, 5, 6], "psi": [0, 11], "pub": [4, 20], "pub_result": 20, "put": 15, "py": [9, 15, 18], "pypi": 22, "pyscf": [0, 4, 14, 15, 18, 20, 21, 23], "python3": [15, 18], "q": [0, 8, 9, 13, 19], "qdrift": 0, "qi": 0, "qiskit": [7, 13, 17, 21, 22], "qiskit_vec_to_ffsim_vec": [4, 7], "qk": 2, "quadrat": [8, 10, 21, 23], "qualnam": 0, "quantifi": 2, "quantiti": 0, "quantum": [0, 4, 8, 11, 13, 14, 17, 20, 21], "quantumcircuit": [4, 13, 19, 20], "quantumregist": [13, 19, 20], "qubit": [0, 4, 10, 11, 15, 19, 20, 21], "r": [0, 2, 8, 9], "radic": 20, "radius_1": 15, "radius_2": 15, "rais": [0, 2, 4, 6], "random": [0, 4, 6, 7, 9, 13, 14, 15, 16, 19, 20, 21], "random_antihermitian": [5, 7], "random_diagonal_coulomb_hamiltonian": [5, 7], "random_double_factorized_hamiltonian": [5, 7, 13, 19], "random_fermion_hamiltonian": [5, 7], "random_fermion_oper": [5, 7], "random_hermitian": [5, 7], "random_molecular_hamiltonian": [5, 7], "random_nelec": [6, 7], "random_occupied_orbit": [6, 7], "random_orthogon": [5, 7], "random_real_symmetric_matrix": [5, 7, 9, 13, 19, 20], "random_special_orthogon": [5, 7], "random_state_vector": [5, 7, 16], "random_statevector": [5, 7], "random_t2_amplitud": [5, 7], "random_two_body_tensor": [5, 7, 9], "random_uccsd_restrict": [5, 7], "random_ucj_op_spin_balanc": [5, 7, 13, 19], "random_ucj_op_spin_unbalanc": [5, 7, 19], "random_ucj_op_spinless": [5, 7], "random_unitari": [5, 7, 13, 14, 19, 20, 21], "rang": [0, 2, 6, 13, 14, 15, 18, 20, 21, 23], "rangl": [0, 4, 11, 14], "rank": [0, 2, 5, 8, 13], "rather": [0, 5, 12, 14], "rccsd": 20, "rdm": [0, 7], "rdm1": 0, "rdm2": 0, "rdm3": 0, "rdm4": 0, "reach": 18, "read": 0, "real": [0, 1, 2, 3, 4, 5, 6, 8, 9, 11, 12, 18, 21], "reason": [4, 12], "recal": 13, "recommend": [4, 13, 16, 19, 21], "reconstruct": [0, 2, 23], "reconstruct_t2_alpha_beta": 2, "recover": 0, "reduc": [0, 2, 13], "reduced_matrix": [2, 7], "reduced_matrix_product_st": 0, "reduct": 18, "redund": 11, "refer": [0, 2, 3, 4, 5, 6, 11, 12, 14, 18, 21], "reference_occup": [0, 15], "reference_occupations_spati": 15, "reference_st": 18, "regress": 0, "regular": [3, 18], "rel": [0, 2, 4, 6, 18], "rel_reduction_of_f_": 18, "relat": 12, "releas": 21, "reorder": [0, 8], "rep": 13, "repeat": 15, "repeatedli": 12, "repetit": [0, 5, 11, 13, 18], "repositori": 22, "repr": 16, "repres": [0, 2, 3, 4, 5, 6, 9, 11, 14, 16, 18, 19], "represent": [0, 1, 2, 4, 5, 10, 14, 16, 21, 23], "reproduc": 23, "request": 0, "requir": [0, 9, 11, 13, 14, 22], "reshap": 14, "respect": [0, 2, 3, 23], "rest": [0, 13], "restrict": [0, 5, 13, 18], "result": [0, 1, 2, 3, 4, 5, 8, 9, 11, 13, 15, 18, 19, 20, 23], "retain": [0, 13], "retriev": 20, "return": [0, 1, 2, 3, 4, 5, 6, 12, 15, 16, 18, 23], "return_lower_rank": 0, "revers": 20, "rewrit": 0, "rewritten": 12, "rhf": [0, 15, 18, 20, 21, 23], "right": [0, 4, 12, 14, 16], "ring": 0, "rise": [2, 8], "rng": [9, 13, 15, 19, 20], "rohf": 20, "root": 0, "rotat": [0, 1, 2, 4, 5, 8, 10, 11, 14, 21, 23], "rotated_vec": 14, "routin": [2, 9, 16], "row": [0, 2, 14], "rtol": [0, 2, 4, 6], "rtype": [0, 2, 4], "run": [0, 4, 13, 15, 18, 19, 20, 21, 22, 23], "run_ccsd": 0, "run_cisd": 0, "run_fci": [0, 15, 18], "run_mp2": 0, "run_sci": 0, "rung": 11, "runner": [15, 18], "rust": 22, "rvert": 0, "s_": [0, 14], "s_a": 0, "s_b": 0, "sa": 9, "same": [0, 9, 11, 12, 13, 14, 15, 18, 20], "sampl": [0, 4, 5, 6, 9], "sample_slater_determin": [0, 7], "sample_state_vector": [0, 7], "sampler": [0, 4, 17, 21], "samplerpubresult": 4, "sandwich": 13, "satisfi": [0, 12, 16, 20, 22], "save": [0, 18, 22], "scalar": [0, 16], "scale": [8, 13, 15, 19], "scf": [0, 15, 18, 20, 21, 23], "scf_func": 0, "scheme": 8, "sci": 0, "sci_energi": 0, "sci_vec": 0, "scipi": [0, 2, 3, 15, 16, 18, 21, 23], "search": 14, "second": [0, 2, 4, 8], "section": [8, 19], "sector": [0, 1, 2, 4, 15], "see": [0, 2, 4, 11, 13, 14, 19, 22, 23], "seed": [0, 4, 5, 6, 9, 13, 14, 19, 20, 21], "seen": 20, "select": 3, "sens": [13, 23], "separ": [0, 11, 14], "sequenc": [0, 2, 4, 13], "seri": 2, "serial": 0, "serializ": [15, 18], "set": [0, 1, 2, 4, 5, 8, 11, 12, 13, 19, 23], "setup": 11, "sever": [9, 13], "shape": [0, 2, 5, 11, 23], "share": 11, "shell": [11, 18], "shot": [0, 4, 20], "should": [0, 1, 2, 4, 5, 6, 9, 12, 22], "show": [13, 15, 16, 18, 19, 20], "shown": 16, "side": 0, "sigma": [0, 1, 4, 8, 9, 11, 12], "sign": 0, "signatur": 3, "signific": 23, "significantli": 13, "similar": 18, "simpl": [20, 22], "simpler": 0, "simpli": [4, 13, 14], "simplist": 23, "simul": [0, 4, 8, 11, 12, 14, 17, 21, 24], "simulate_qdrift_double_factor": [0, 7], "simulate_trotter_diag_coulomb_split_op": [0, 7], "simulate_trotter_double_factor": [0, 7, 8, 23], "simulate_trotter_step_double_factor": 23, "simulatetrotterdiagcoulombsplitopjw": [4, 7], "simulatetrotterdoublefactorizedjw": [4, 7, 13, 19], "sin": [0, 15], "sinc": [0, 2, 11, 12, 15, 18], "singl": [0, 1, 4, 6, 8, 13, 23], "singlefactorizedhamiltonian": [0, 7], "singular": [0, 2], "site": [0, 15, 18], "size": [0, 3, 15], "slater": [0, 4], "slater_determin": [0, 7], "slater_determinant_amplitud": [0, 7], "slater_determinant_rdm": [0, 7], "slice": 2, "small": 2, "smaller": [0, 2, 8, 16, 23], "so": [0, 2, 6, 8, 11, 12, 13, 15, 16, 22, 23], "softwar": [0, 21], "solv": 3, "some": [0, 2, 6, 9, 13, 14, 16, 18, 20], "sometim": [0, 14], "sort": 20, "sourc": [0, 1, 2, 3, 4, 5, 6, 21], "space": [0, 9, 14, 15, 18, 20, 23], "span": [0, 2], "spars": [9, 16, 23], "sparsepauliop": 4, "sparsiti": 11, "spatial": [0, 1, 4, 5, 6, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 23], "speci": [4, 6], "special": [2, 5, 11, 13, 21], "specif": 14, "specifi": [0, 1, 2, 3, 4, 5, 6, 9, 11, 13, 15, 23], "spectral": 0, "spin": [0, 1, 2, 4, 5, 6, 7, 12, 13, 14, 15, 16, 18, 20, 21], "spin_squar": [0, 7], "spin_sum": 0, "spinless": [0, 4, 5, 6], "split": [0, 4, 23], "squar": [0, 2, 11, 13, 18, 20], "stack": 0, "stage": [4, 13, 19], "standard": 18, "standard_norm": [9, 13, 19], "star": 2, "start": 0, "state": [0, 1, 3, 4, 5, 9, 10, 11, 12, 13, 18, 20, 21, 23], "statevector": [0, 4, 7], "static": 0, "statist": 20, "statu": [15, 18], "step": [0, 4, 8, 12, 15, 19, 23], "step_tim": 23, "still": [0, 8], "sto": [0, 15, 18, 23], "stop": [3, 15, 18], "store": [0, 2, 4, 6, 9, 11, 13, 18, 19, 23], "store_cisd_vec": 0, "store_fci_vec": 0, "store_sci_vec": 0, "store_t1": 0, "store_t2": 0, "str": [0, 2, 4, 6], "straightforward": 2, "strategi": 0, "strength": 0, "strictli": 3, "string": [0, 14, 16], "strings_a": 0, "strings_b": 0, "strings_to_address": [0, 7], "strings_to_indic": [0, 7], "structur": [0, 8], "sub": 0, "subdirectori": 22, "submit": 20, "subroutin": 12, "subspac": [0, 2, 16], "substitut": [0, 5], "subsystem": [14, 22], "subtract": [0, 16], "success": [15, 18], "sudo": 22, "suffix": 15, "suggest": 19, "sum": [0, 4, 8, 23], "sum_": [0, 1, 2, 4, 8, 9, 11, 12, 23], "sum_j": 12, "sum_k": [8, 12], "sum_p": 0, "sum_t": 0, "summat": 0, "support": [0, 2, 9, 14, 16, 20, 22], "supportsapplyunitari": [0, 7], "supportsapproximateequ": [0, 7], "supportsdiagon": [0, 7], "supportsfermionoper": [0, 7], "supportslinearoper": [0, 7], "supportstrac": [0, 7], "suzuki": [0, 23], "swap": [0, 11, 13], "symmetr": [0, 2, 4, 5, 8, 11], "symmetri": [0, 12, 15, 18, 20, 21, 23], "system": [0, 4, 6, 12, 14, 22], "t": [0, 2, 4, 8, 11, 12, 20, 21], "t1": 0, "t1a": 0, "t1b": 0, "t2": [0, 2, 5, 18, 20], "t2_amplitud": 2, "t2aa": 0, "t2ab": 0, "t2bb": 0, "t_": 2, "tabl": [0, 16], "take": [0, 3, 18, 19], "taken": 11, "target": [2, 13], "target_orb": 0, "tau": [0, 1, 4, 8, 9, 11], "taylor": 2, "tensor": [0, 1, 2, 5, 8, 9, 18, 23], "term": [0, 2, 5, 8, 11, 16, 23], "test": [7, 21, 23], "text": [0, 8, 9], "th": [2, 12], "than": [0, 4, 5, 12, 13, 14, 18, 21], "thei": [0, 9, 11, 12, 16], "them": [11, 13, 14], "therefor": [0, 2, 11], "theta": [0, 15], "thi": [0, 2, 4, 5, 8, 9, 11, 12, 13, 14, 15, 18, 19, 20, 21, 22, 23], "think": 2, "third": [0, 2], "those": [3, 18], "though": 13, "three": [0, 1, 4, 9, 16], "threshold": [0, 2, 3], "thu": 8, "time": [0, 2, 3, 4, 9, 13, 14, 19, 20, 23], "titl": 21, "tmp": [9, 15, 18], "tmpjuqvvg3m": 15, "tmptvm74xlu": 18, "to_diag_coulomb_mat": 0, "to_fcidump": 0, "to_json": 0, "to_molecular_hamiltonian": 0, "to_number_represent": 0, "to_orbital_rot": 0, "to_paramet": [0, 18], "to_z_represent": 0, "tol": [0, 2, 23], "toler": [0, 2, 4, 6, 11, 23], "too": 2, "top": 20, "topologi": [11, 13, 18], "toru": 0, "total": [4, 8, 15, 18, 23], "tox": [15, 18], "trace": [0, 7, 9, 23], "tracea": [9, 23], "trajectori": 0, "transform": [0, 1, 4], "transformationpass": 4, "transpil": [4, 13, 17, 21], "transpiled_opt": 13, "treat": 0, "triangl": 11, "trianglular": [0, 2], "triangular": [0, 2, 4, 5], "triplet": 6, "trotter": [0, 4, 21, 24], "true": [0, 2, 3, 4, 6, 16, 18, 20], "truncat": 8, "try": 23, "tunnel": 0, "tupl": [0, 1, 2, 4, 5, 6, 12, 15, 16, 23], "tutori": [21, 23], "twice": [0, 15, 19], "two": [0, 2, 5, 8, 9, 11, 13, 14, 15, 18, 22, 23], "two_body_integr": 0, "two_body_tensor": [0, 2, 9, 23], "type": [0, 1, 2, 3, 4, 5, 6, 20, 22], "typeerror": 0, "typic": 0, "u": [0, 1, 2, 4, 8, 11, 12], "u_": 4, "u_k": 0, "ubuntu": 22, "uccsd": [0, 5, 20], "uccsdoprestrictedr": [0, 5, 7], "ucj": [0, 4, 5], "ucj_balanced_jw": 13, "ucj_op": [4, 13, 19, 20], "ucjoperatorjw": 4, "ucjopspinbalanc": [0, 4, 5, 7, 11, 13, 18, 20], "ucjopspinbalancedjw": [4, 7, 13, 19, 20], "ucjopspinless": [0, 4, 5, 7], "ucjopspinlessjw": [4, 7], "ucjopspinunbalanc": [0, 4, 5, 7, 11, 20], "ucjopspinunbalancedjw": [4, 7, 13, 19, 20], "uhf": 20, "unbalanc": [0, 4, 5, 20], "uncorrel": 0, "under": [0, 4], "underli": 4, "unifi": 20, "uniform": [0, 4, 5], "unimpl": 4, "union": [2, 4], "unit": 2, "unitari": [0, 1, 2, 4, 5, 8, 10, 12, 14, 17, 21], "univers": 2, "unlik": 0, "unord": 0, "untouch": 0, "up": [0, 2, 6, 8, 14, 22], "updat": [0, 8], "upon": 16, "upper": [0, 2, 4, 5, 11], "url": 21, "us": [0, 1, 2, 3, 4, 5, 8, 9, 11, 12, 13, 14, 15, 17, 18, 19, 21, 23], "usag": [0, 2, 16, 19], "user": 22, "userwarn": [9, 15, 18], "usual": 0, "util": [2, 5, 6, 8], "v": [0, 20], "v_": 0, "v_i": 2, "v_j": 2, "vacuum": 4, "valid": [0, 4, 5, 6], "valu": [0, 1, 2, 3, 4, 5, 6, 9, 11, 18, 19, 23], "valueerror": [0, 2, 4], "vari": [0, 4], "variabl": [14, 23], "variant": [11, 13, 18], "variat": [0, 3, 11, 18], "variation": 18, "varphi": 0, "vdot": [18, 21, 23], "ve": 23, "vec": [0, 1, 2, 4, 9, 12, 14, 16, 21, 23], "vec_a": 0, "vec_b": 0, "vector": [0, 1, 2, 3, 4, 5, 9, 10, 11, 12, 15, 16, 18, 21], "verbos": 6, "verifi": 2, "version": 4, "vertic": 0, "via": [0, 23], "view": [0, 16], "volum": 22, "w": 0, "wa": [0, 3, 4, 11], "wai": 11, "want": 13, "warn": [9, 15, 18, 20], "water": 15, "wavefunct": [3, 18], "we": [0, 2, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23], "web": 22, "weight": 14, "well": [3, 14, 21, 22, 23], "when": [0, 3, 4, 9, 11, 13, 14, 16, 19, 21], "whenev": 0, "where": [0, 1, 2, 3, 4, 5, 8, 11, 12, 14, 22, 23], "whether": [0, 1, 2, 3, 4, 5, 16], "which": [0, 2, 4, 5, 8, 9, 11, 12, 13, 14, 15, 16, 22, 23], "while": [8, 11], "whose": [0, 2, 14], "width": 5, "wigner": [0, 4], "william": 2, "window": [21, 22], "wise": 2, "with_final_orbital_rot": [0, 5], "with_phase_angl": 0, "with_phi": 0, "within": [0, 2, 13, 16, 18, 21], "without": [11, 13, 18], "won": 21, "word": [0, 11, 20], "work": [9, 13, 15, 18, 19, 21, 22], "workflow": 20, "would": [13, 14], "wrapper": 23, "write": 23, "written": 8, "wrote": 23, "wsl": 22, "x": [0, 3, 4, 13, 15, 18, 19, 20], "x0": [3, 15, 18], "xx_plus_yi": [13, 19], "xxplusyyg": [13, 19], "y": 0, "yaml": 22, "yet": [9, 18], "yield": [0, 2, 4, 8, 11, 15, 23], "you": [0, 1, 2, 4, 9, 14, 18, 21, 22, 23], "your": [19, 22], "z": [0, 1, 2, 4, 5, 12, 16, 21], "z_represent": [0, 1, 4, 5], "zero": [0, 2, 4, 9, 19], "zip": [0, 15, 18, 23], "\u03c8": 18}, "titles": ["ffsim", "ffsim.contract", "ffsim.linalg", "ffsim.optimize", "ffsim.qiskit", "ffsim.random", "ffsim.testing", "API reference", "Double-factorized representation of the molecular Hamiltonian", "Hamiltonians", "Explanations", "The local unitary cluster Jastrow (LUCJ) ansatz", "Orbital rotations and quadratic Hamiltonians", "Qubit gate decompositions of fermionic gates", "State vectors and gates", "How to simulate entanglement forging", "How to use the FermionOperator class", "How-to guides", "How to simulate the local unitary cluster Jastrow (LUCJ) ansatz", "How to build and transpile Qiskit quantum circuits", "How to use ffsim\u2019s Qiskit Sampler primitive", "ffsim", "Installation", "Implementing Trotter simulation of the double-factorized Hamiltonian", "Tutorials"], "titleterms": {"": 20, "The": 11, "action": 9, "an": 20, "ansatz": [11, 15, 18], "api": 7, "applic": 8, "background": 8, "balanc": [11, 19], "brief": 8, "build": [15, 19, 23], "can": 20, "choos": 15, "circuit": [19, 20], "cite": 21, "class": 16, "close": 20, "cluster": [11, 13, 18, 19], "code": 21, "comput": 15, "content": 21, "contract": 1, "coulomb": [13, 19], "criteria": 20, "data": 9, "decomposit": 13, "determin": [13, 19], "diagon": [13, 19], "docker": 22, "doubl": [8, 13, 19, 23], "energi": 15, "entangl": 15, "evolut": [8, 12, 13, 19], "exampl": [20, 21], "explan": 10, "factor": [8, 13, 19, 23], "fermion": [13, 14], "fermionoper": 16, "ffsim": [0, 1, 2, 3, 4, 5, 6, 20, 21], "ffsimsampl": 20, "fock": [13, 19], "forg": 15, "formula": 8, "from": [20, 22], "gate": [13, 14, 19], "gener": [11, 18], "guid": 17, "hamiltonian": [8, 9, 12, 13, 19, 23], "hartre": [13, 19], "how": [15, 16, 17, 18, 19, 20], "implement": 23, "initi": 15, "instal": [21, 22], "jastrow": [11, 13, 18, 19], "linalg": 2, "linear": 18, "linearoper": 9, "local": [11, 13, 18], "lucj": [11, 18, 20], "merg": 13, "method": 18, "molecul": [15, 20], "molecular": 8, "more": 20, "number": [13, 19], "occup": 15, "open": 20, "oper": [9, 13, 15, 19], "optim": [3, 15, 18], "orbit": [12, 13, 19], "overview": 19, "pip": 22, "prepar": [13, 19], "primit": 20, "qiskit": [4, 19, 20], "quadrat": 12, "quantum": 19, "qubit": 13, "random": 5, "refer": [7, 15], "represent": [8, 9], "rotat": [12, 13, 19], "sampl": 20, "sampler": 20, "scipi": 9, "shell": 20, "simul": [13, 15, 18, 19, 23], "slater": [13, 19], "sourc": 22, "spin": [11, 19], "spinless": 14, "state": [14, 19], "sum": [13, 19], "suzuki": 8, "test": 6, "time": [8, 12], "transform": 19, "transpil": 19, "treat": 14, "trotter": [8, 13, 19, 23], "tutori": 24, "ucj": [11, 13, 18, 19], "unbalanc": [11, 19], "unitari": [11, 13, 18, 19], "us": [16, 20, 22], "vector": 14, "via": [8, 9], "within": 22}})
\ No newline at end of file
diff --git a/tutorials/double-factorized-trotter.html b/tutorials/double-factorized-trotter.html
index 6418a21ee..2a97e936c 100644
--- a/tutorials/double-factorized-trotter.html
+++ b/tutorials/double-factorized-trotter.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Explanations" href="../explanations/index.html" /><link rel="prev" title="Tutorials" href="index.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>Implementing Trotter simulation of the double-factorized Hamiltonian - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>Implementing Trotter simulation of the double-factorized Hamiltonian - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -160,7 +160,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -184,7 +184,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -596,7 +596,7 @@ <h2>Implement Trotter simulation<a class="headerlink" href="#Implement-Trotter-s
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Fidelity of Trotter-evolved state with exact state: 0.9402435386975859
+Fidelity of Trotter-evolved state with exact state: 0.9402435115724028
 </pre></div></div>
 </div>
 <p>The fidelity of the final result can be improved by increasing the number of Trotter steps.</p>
@@ -623,7 +623,7 @@ <h2>Implement Trotter simulation<a class="headerlink" href="#Implement-Trotter-s
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Fidelity of Trotter-evolved state with exact state: 0.9985212861519277
+Fidelity of Trotter-evolved state with exact state: 0.9985212854220817
 </pre></div></div>
 </div>
 <p>In the code cell below, we reproduce the results of our manually implemented function using ffsim’s built-in implementation.</p>
@@ -651,7 +651,7 @@ <h2>Implement Trotter simulation<a class="headerlink" href="#Implement-Trotter-s
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Fidelity of Trotter-evolved state with exact state: 0.998521286151879
+Fidelity of Trotter-evolved state with exact state: 0.9985212854218731
 </pre></div></div>
 </div>
 <p>A higher order formula achieves a higher fidelity with fewer Trotter steps:</p>
@@ -679,7 +679,7 @@ <h2>Implement Trotter simulation<a class="headerlink" href="#Implement-Trotter-s
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Fidelity of Trotter-evolved state with exact state: 0.9996731164191628
+Fidelity of Trotter-evolved state with exact state: 0.9996731164188345
 </pre></div></div>
 </div>
 <p>You’ve made it to the end of this tutorial!</p>
@@ -755,7 +755,7 @@ <h2>Implement Trotter simulation<a class="headerlink" href="#Implement-Trotter-s
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
diff --git a/tutorials/double-factorized-trotter.ipynb b/tutorials/double-factorized-trotter.ipynb
index 3157e55b6..0431fbd64 100644
--- a/tutorials/double-factorized-trotter.ipynb
+++ b/tutorials/double-factorized-trotter.ipynb
@@ -18,10 +18,10 @@
    "execution_count": 1,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:25.819360Z",
-     "iopub.status.busy": "2024-10-10T17:24:25.819176Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.585120Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.584507Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.018043Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.017857Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.778746Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.778140Z"
     }
    },
    "outputs": [
@@ -80,10 +80,10 @@
    "execution_count": 2,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.588832Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.587914Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.592807Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.592350Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.781995Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.780904Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.786271Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.785682Z"
     }
    },
    "outputs": [],
@@ -106,10 +106,10 @@
    "execution_count": 3,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.594777Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.594345Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.598784Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.598320Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.788118Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.787937Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.793017Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.792498Z"
     }
    },
    "outputs": [
@@ -172,10 +172,10 @@
    "execution_count": 4,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.600615Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.600427Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.604611Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.604034Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.795040Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.794689Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.798781Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.798275Z"
     }
    },
    "outputs": [
@@ -208,10 +208,10 @@
    "execution_count": 5,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.606370Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.606189Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.610295Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.609699Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.800762Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.800418Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.804298Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.803811Z"
     }
    },
    "outputs": [
@@ -242,10 +242,10 @@
    "execution_count": 6,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.612036Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.611849Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.629634Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.629149Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.806478Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.806034Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.824284Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.823769Z"
     }
    },
    "outputs": [
@@ -302,10 +302,10 @@
    "execution_count": 7,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.631638Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.631299Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.635499Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.635027Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.826390Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.826017Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.830305Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.829725Z"
     }
    },
    "outputs": [],
@@ -360,10 +360,10 @@
    "execution_count": 8,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.637366Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.637034Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.640676Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.640060Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.832361Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.831852Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.835452Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.834971Z"
     }
    },
    "outputs": [],
@@ -400,10 +400,10 @@
    "execution_count": 9,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.642683Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.642329Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.740698Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.740126Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.837415Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.837079Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.937835Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.937203Z"
     }
    },
    "outputs": [],
@@ -439,10 +439,10 @@
    "execution_count": 10,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.743990Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.743034Z",
-     "iopub.status.idle": "2024-10-10T17:24:26.792806Z",
-     "shell.execute_reply": "2024-10-10T17:24:26.792352Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.940685Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.940042Z",
+     "iopub.status.idle": "2024-10-30T17:30:23.989610Z",
+     "shell.execute_reply": "2024-10-30T17:30:23.989110Z"
     }
    },
    "outputs": [
@@ -450,7 +450,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Fidelity of Trotter-evolved state with exact state: 0.9402435386975859\n"
+      "Fidelity of Trotter-evolved state with exact state: 0.9402435115724028\n"
      ]
     }
    ],
@@ -480,10 +480,10 @@
    "execution_count": 11,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:26.794865Z",
-     "iopub.status.busy": "2024-10-10T17:24:26.794471Z",
-     "iopub.status.idle": "2024-10-10T17:24:27.007158Z",
-     "shell.execute_reply": "2024-10-10T17:24:27.006639Z"
+     "iopub.execute_input": "2024-10-30T17:30:23.991607Z",
+     "iopub.status.busy": "2024-10-30T17:30:23.991166Z",
+     "iopub.status.idle": "2024-10-30T17:30:24.203147Z",
+     "shell.execute_reply": "2024-10-30T17:30:24.202617Z"
     }
    },
    "outputs": [
@@ -491,7 +491,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Fidelity of Trotter-evolved state with exact state: 0.9985212861519277\n"
+      "Fidelity of Trotter-evolved state with exact state: 0.9985212854220817\n"
      ]
     }
    ],
@@ -521,10 +521,10 @@
    "execution_count": 12,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:27.009271Z",
-     "iopub.status.busy": "2024-10-10T17:24:27.008891Z",
-     "iopub.status.idle": "2024-10-10T17:24:27.134836Z",
-     "shell.execute_reply": "2024-10-10T17:24:27.134380Z"
+     "iopub.execute_input": "2024-10-30T17:30:24.205298Z",
+     "iopub.status.busy": "2024-10-30T17:30:24.204871Z",
+     "iopub.status.idle": "2024-10-30T17:30:24.332984Z",
+     "shell.execute_reply": "2024-10-30T17:30:24.332329Z"
     }
    },
    "outputs": [
@@ -532,7 +532,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Fidelity of Trotter-evolved state with exact state: 0.998521286151879\n"
+      "Fidelity of Trotter-evolved state with exact state: 0.9985212854218731\n"
      ]
     }
    ],
@@ -563,10 +563,10 @@
    "execution_count": 13,
    "metadata": {
     "execution": {
-     "iopub.execute_input": "2024-10-10T17:24:27.136698Z",
-     "iopub.status.busy": "2024-10-10T17:24:27.136505Z",
-     "iopub.status.idle": "2024-10-10T17:24:27.239845Z",
-     "shell.execute_reply": "2024-10-10T17:24:27.239329Z"
+     "iopub.execute_input": "2024-10-30T17:30:24.335293Z",
+     "iopub.status.busy": "2024-10-30T17:30:24.334888Z",
+     "iopub.status.idle": "2024-10-30T17:30:24.438840Z",
+     "shell.execute_reply": "2024-10-30T17:30:24.438282Z"
     }
    },
    "outputs": [
@@ -574,7 +574,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Fidelity of Trotter-evolved state with exact state: 0.9996731164191628"
+      "Fidelity of Trotter-evolved state with exact state: 0.9996731164188345"
      ]
     },
     {
diff --git a/tutorials/index.html b/tutorials/index.html
index 49f236752..2e6530704 100644
--- a/tutorials/index.html
+++ b/tutorials/index.html
@@ -5,8 +5,8 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Implementing Trotter simulation of the double-factorized Hamiltonian" href="double-factorized-trotter.html" /><link rel="prev" title="Installation" href="../install.html" />
 
-    <!-- Generated with Sphinx 8.1.0 and Furo 2024.08.06 -->
-        <title>Tutorials - ffsim 0.0.47</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+        <title>Tutorials - ffsim 0.0.48</title>
       <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/qiskit-sphinx-theme.css?v=8ff9dcb6" />
@@ -159,7 +159,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">ffsim 0.0.47</div></a>
+      <a href="../index.html"><div class="brand">ffsim 0.0.48</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -183,7 +183,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
   
   
-  <span class="sidebar-brand-text">ffsim 0.0.47</span>
+  <span class="sidebar-brand-text">ffsim 0.0.48</span>
   
 </a>
 
@@ -332,7 +332,7 @@ <h1>Tutorials<a class="headerlink" href="#tutorials" title="Link to this heading
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=4f34e5f2"></script>
+</div><script src="../_static/documentation_options.js?v=a72e4630"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=5fa4622c"></script>